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
- method_not_allowed
Método no permitido
La ruta existe pero no acepta este método HTTP.
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.