Cargando el índice de búsqueda…

Desarrolladores

Errores de la API

Cada rechazo llega como application/problem+json con un type estable. Decidí según el type, no según el texto: acá está qué significa cada uno y qué hacer.

¿No encontrás la respuesta o el error se repite? Escribinos y mencioná el X-Request-Id de la respuesta: con él encontramos la solicitud. Escribinos

Estado 401

  • api_token_expired

    El token de la API venció

    Pasó la fecha de vencimiento del token.

  • api_token_invalid

    El token de la API no es válido

    El token tiene un formato incorrecto, su suma de verificación no coincide o no existe.

  • api_token_missing

    Falta el token de la API

    La solicitud no tiene el encabezado Authorization: Bearer. No se acepta el token en la query string.

  • api_token_revoked

    El token de la API fue revocado

    El token se revocó, la aplicación se eliminó, su miembro de servicio se desactivó o la tienda cerró.

Estado 403

  • capability_disabled

    Recurso no disponible para esta tienda

    El recurso depende de una función de la tienda que esta tienda no tiene; capability indica cuál. Los períodos fiscales, por ejemplo, existen solo en tiendas de Argentina.

  • forbidden

    Prohibido

    Una regla de acceso de la tienda rechazó la acción más allá de los scopes, por ejemplo en un local con el que la aplicación no trabaja.

  • insufficient_scope

    Falta un permiso

    A la aplicación le falta el scope que necesita el endpoint; lo nombran required_scope y el encabezado WWW-Authenticate. Un endpoint que acepta cualquiera de varios scopes los lista en accepted_scopes: alcanza con uno.

  • integration_api_not_in_plan

    La API para integraciones no está en el plan

    El plan de la tienda no incluye la API de integraciones.

  • ip_not_allowed

    Dirección no permitida

    La aplicación acepta solicitudes solo desde las direcciones IP listadas, y esta llegó desde otra.

Estado 404

  • not_found

    No encontrado

    El registro no existe o pertenece a otra tienda; una ruta desconocida recibe la misma respuesta.

Estado 405

Estado 409

  • address_book_full

    La libreta de direcciones del cliente está llena

    La libreta de direcciones del cliente llegó al límite de la tienda; limit es el tope.

  • bulk_operation_finished

    La operación ya terminó

    La operación ya terminó y no se puede cancelar; operation_status es su estado.

  • bulk_operation_queue_full

    La cola de operaciones de la app está llena

    La aplicación ya tiene tantas operaciones masivas sin terminar como se permite; limit es el tope.

  • bulk_operation_result_unavailable

    No hay archivo de resultado

    El resultado de una operación de archivo aparece completo solo cuando está completed, y esta operación sigue en curso, falló o se canceló; operation_status es su estado.

  • consent_required

    Hace falta consentir las consecuencias

    La escritura cambiaría otros datos de la tienda: consent_kind nombra el tipo de consecuencia, consequences cuenta lo que cambiará y consent_token es la huella de lo mostrado.

  • customer_contact_in_use

    El contacto ya pertenece a un cliente de la tienda

    El teléfono o el email del cliente nuevo ya pertenece a un cliente de la tienda; los nombran field y existing_customer_id.

  • draft_order_closed

    El borrador de pedido está cerrado

    El borrador se confirmó o se canceló y ya no se puede cambiar ni confirmar; current da su estado y el pedido.

  • external_id_archived

    El registro con este ID externo está archivado

    El ID externo pertenece a un registro archivado de la tienda; lo nombra external_id.

  • external_id_in_use

    El ID externo está en uso

    El ID externo ya lo usa otro registro vigente de esta aplicación; lo nombra external_id.

  • fiscal_document_annul_refused

    No se puede anular la factura

    No se puede anular la factura. code es el motivo: not_an_invoice — el comprobante no es una factura; not_issued — la factura no está emitida: la rechazada se reemite, la pendiente se cancela con el pedido; provider_disabled — el módulo fiscal de la tienda está apagado; already_voided — la factura ya está anulada o su nota espera emisión; nothing_to_void — la venta se devolvió completa y las notas de crédito dejaron la factura en cero. current.status es el estado del comprobante, current.annulling_document_id es la nota de anulación vigente en already_voided.

  • fiscal_document_dismiss_refused

    No se puede sacar el comprobante de control

    No se puede sacar el comprobante de control. code es el motivo: not_awaiting_decision — el comprobante no espera una decisión humana: se sacan los rechazados por el fisco y los emitidos con CAEA cuyo informe ARCA no acepta; already_resolved — el comprobante ya está fuera de control. current.status es el estado actual del comprobante.

  • fiscal_document_pdf_unavailable

    El comprobante no tiene archivo

    El comprobante no tiene archivo: no está emitido, o el proveedor no guardó ni el archivo ni los datos para generarlo; current.status es su estado.

  • fiscal_document_reissue_refused

    No se puede reemitir el comprobante

    No se puede reemitir el comprobante. code es el motivo: not_reissuable — el comprobante no falló ni fue rechazado: espera emisión o ya está emitido; advance_applied — la seña de la reserva se aplicó al ticket y la factura del ticket ya la documenta; nothing_to_issue — el pedido se devolvió completo. current.status es el estado actual del comprobante.

  • idempotency_key_in_use

    Hay una solicitud en curso con esta clave

    Una solicitud con el mismo Idempotency-Key todavía se está ejecutando.

  • in_use_conflict

    Registro en uso

    El registro no se puede eliminar: otros datos de la tienda todavía lo nombran.

  • invoice_issue_refused

    No se puede emitir la factura del pedido ahora

    No se puede emitir la factura del pedido ahora. code es el motivo: channel_not_first_party — el comprobante lo emite el canal de venta; entity_exempt — la razón social del pedido no emite comprobantes; issued_externally — el comprobante lo emite un POS externo; provider_disabled — el módulo fiscal de la tienda está apagado; not_covered — la venta todavía no está pagada; advance_applied — la seña de la reserva se aplicó al ticket y la factura del ticket la documenta; invoice_exists — la factura ya existe o espera emisión; invoice_rejected — el fisco rechazó la factura; nothing_to_issue — el pedido se devolvió completo; bill_required — la mesa tiene varias cuentas, la factura de una cuenta la emite el POS o el panel. current.invoice_id es la factura vigente del pedido en invoice_exists e invoice_rejected.

  • money_transaction_locked

    El movimiento no se cambia a mano

    La línea del libro no se edita ni se borra a mano: tiene documento de origen (entonces cambian solo la categoría, la contraparte y la descripción), es una línea interna del libro (saldo inicial, diferencia de cambio, reflejo de una tienda del grupo) o es parte de una transferencia. detail nombra el motivo, current.origin es el origen de la línea y current.transfer_id la transferencia.

  • order_cancel_refused

    El pedido no se puede cancelar

    El pedido no se puede cancelar ahora: su estado no lo permite, no se puede emitir una nota de crédito, el efectivo lo devuelve solo una caja con turno abierto o hay una suscripción pagada en curso.

  • order_transition_refused

    El pedido no puede pasar a este estado

    La tienda no permite este cambio de estado del pedido: las reglas de transición, un retiro sin cadete, un envío sin cadete o un saldo impago antes de completarlo. detail nombra el motivo, current muestra el estado actual.

  • payment_not_confirmable

    El pago no se puede confirmar

    El pago ya no espera dinero o lo cierra su proveedor, no una persona; current muestra su estado.

  • plan_limit_reached

    Se alcanzó el límite del plan

    El plan de la tienda no permite más registros de este tipo; limit es el tope.

  • purchase_order_refused

    La orden de compra no acepta este comando

    La orden de compra no acepta el comando en su estado actual: solo cambian el borrador y la orden colocada, solo se borra el borrador, se cancela la colocada, se cierra la recibida y se coloca solo con proveedor y local activos. detail dice el motivo y current.status tiene el estado actual de la orden.

  • record_limit_reached

    Se alcanzó el tope de registros

    La tienda alcanzó el tope de registros de este tipo; limit es el tope. No depende del plan.

  • refund_not_confirmable

    La devolución no espera confirmar un reintegro

    El reembolso no tiene un pago manual que espere confirmación: el dinero lo devolvió un proveedor, una caja o el saldo.

  • refund_refused

    El pedido no se puede devolver

    El estado del pedido no permite el reembolso: cancelado, sin dinero recibido, efectivo ya rendido a la caja, la tarjeta de la venta ya usada o una seña que retiene una reserva. detail nombra el motivo.

  • shipment_in_progress

    Ya hay una emisión de envío en curso

    La emisión del envío del pedido ya está en cola o en curso, o el envío se está cancelando.

  • shipment_label_unavailable

    El envío no tiene etiqueta

    El pedido no tiene envío, el transportista todavía no entregó la etiqueta o su archivo no está disponible.

  • shipment_outcome_unknown

    El resultado de la emisión anterior es desconocido

    La conexión con el transportista se cortó después de la solicitud de emisión anterior y no se sabe si el envío se creó.

  • shipment_refused

    No se puede emitir el envío ahora

    No se puede emitir el envío ahora: el método de entrega del pedido no tiene transportista integrado, el pedido ya no se despacha o espera el pago de su factura. code es el motivo (no_carrier, not_shippable, awaits_bill_payment), current es el estado actual del pedido.

  • shipment_tracking_refused

    No se puede cargar el número de seguimiento a mano

    El número de seguimiento del pedido no se puede cargar ni quitar a mano. code es el motivo: carrier_integrated — el número lo emite un transportista integrado, el envío se emite con POST /v1/orders/{order}/shipment; manual_tracking_unsupported — el método de envío del pedido no despacha con un servicio de envíos; order_closed — el pedido está cancelado o devuelto. current es el estado actual del pedido.

  • stock_held_by_write_offs

    El stock está retenido por bajas pendientes de aprobación

    Fijar el stock más bajo tomaría la cantidad retenida por bajas que esperan aprobación en la tienda.

  • stock_on_hand_changed

    Cambió el stock físico

    El stock físico no coincide con expected_on_hand: cambió después de leerlo. current.on_hand muestra el stock actual.

  • supplier_bill_payment_locked

    El pago del comprobante no se anula directamente

    El pago del comprobante no se anula directamente: una compensación, una nota de crédito, un anticipo de la orden de compra y un egreso del libro los quita su propio documento, y una retención practicada con el pago en un período fiscal cerrado retiene también el pago. detail nombra el motivo, current.kind tiene el tipo de pago.

  • supplier_bill_refused

    El comprobante de proveedor no acepta este comando

    El comprobante de proveedor no acepta el comando en su estado actual: solo un borrador se cambia o se elimina, un comprobante registrado no se cambia, uno anulado no se registra, y las notas ya registradas contra un borrador impiden eliminarlo. Solo se aprueba un comprobante registrado, la aprobación no se revoca después del primer pago, y solo se paga uno registrado y aprobado. detail nombra el motivo, current.status tiene el estado actual del comprobante.

  • tax_withholding_certificate_unavailable

    El registro no tiene certificado

    La tienda emite certificado solo de lo que retuvo ella misma (direction practiced), desde su razón social: lo que le retuvieron a la tienda lo respalda el certificado del agente. current.direction es la dirección del registro y current.legal_entity_id, su razón social.

  • unique_conflict

    Valor repetido

    Una solicitud simultánea tomó un valor único, como una dirección o un SKU, entre la verificación y la escritura.

  • upload_offset_mismatch

    La parte no empieza donde corresponde

    El desplazamiento de la parte no es igual a lo que la carga ya recibió; received es el desplazamiento correcto.

  • webhook_endpoint_limit_reached

    La app tiene el máximo de endpoints de webhook

    La aplicación ya tiene tantos endpoints de webhooks como se permite; limit es el tope.

Estado 410

  • cursor_expired

    El cursor de sincronización venció

    El cursor de sincronización es más antiguo que el plazo de conservación de las eliminaciones o se emitió antes de restaurar la base de la tienda.

Estado 412

  • precondition_failed

    El registro cambió

    La versión en If-Match no es la actual: el registro cambió después de leerlo. Con If-None-Match: * — el registro ya existe.

Estado 416

  • range_not_satisfiable

    El rango empieza después del resultado

    El rango empieza más allá del resultado escrito; Content-Range da su largo.

Estado 422

  • idempotency_key_required

    Falta la clave de idempotencia

    El método se ejecuta solo con el encabezado Idempotency-Key: un duplicado ante el fisco no se deshace.

  • idempotency_key_reused

    La clave de idempotencia ya se usó

    La clave ya se usó con otra solicitud: otro método, ruta o cuerpo.

  • invalid_idempotency_key

    La clave de idempotencia no es válida

    El encabezado Idempotency-Key no se pudo leer: una clave tiene de 1 a 255 caracteres ASCII visibles, como token o cadena entre comillas.

  • last_variant_of_product

    Última variante del producto

    Un producto no puede quedar sin variantes, así que su última variante no se puede archivar.

  • money_out_of_range

    Importe fuera de rango

    Un precio, una cantidad o una unidad dan un importe demasiado grande para calcularlo con exactitud.

  • validation_error

    Solicitud inválida

    Un campo o parámetro es inválido o desconocido; errors lista los mensajes por campo.

Estado 428

  • precondition_required

    Falta If-Match

    Cambiar un registro versionado necesita If-Match con su ETag; * no es una versión.

Estado 429

  • too_many_requests

    Demasiadas solicitudes

    Se agotó el límite; policy nombra el balde — app, store o rejected — y Retry-After indica cuánto esperar. rejected significa que se rechazaron demasiadas solicitudes de tu dirección en la entrada: falta el token, es inválido, fue revocado o venció, la dirección no está permitida, el plan no incluye la API.

Estado 500

  • server_error

    Error del servidor

    Una falla inesperada de nuestro lado. La solicitud no terminó.

Estado 503

  • carrier_unavailable

    El transportista no responde

    El transportista no respondió a una solicitud que la tienda le hace en tu nombre (la etiqueta del envío en Mercado Envíos).

  • store_frozen

    Tienda congelada

    La tienda está congelada por falta de pago de la suscripción.

  • transient_conflict

    Conflicto temporal

    Un cambio simultáneo revirtió la solicitud completa; no se escribió nada.

Estado según la solicitud

  • http_error

    Error HTTP

    Un error HTTP sin tipo propio, como 503 durante un mantenimiento.