agency_not_available
detalleHTTPHTTP 400
La agencia elegida no está disponible para esta orden o cotización (no cotizable, inactiva o de otra entidad).
Órdenes
Códigos de error · 40 códigos · catálogo del 2026-10-21
Crear y editar órdenes de Zauru desde el catálogo. Mismo cuerpo de operación que cotizaciones (errors[] por línea, side_effects).
Para toda la familia
Lo que un código no dice lo hereda de aquí.
- Cómo se detecta
- La respuesta (
code,errors[],side_effects). - Qué hacer
- Corregir la línea o el campo que dice
errors[]. Conside_effects.lead_promoted_to_clientuorder_created, revisa Zauru antes de reintentar.
Códigos
attachments_limit_exceeded
detalleHTTPHTTP 400
Se pasó el máximo de adjuntos (una orden acepta hasta dos).
bundle_tracking_resolution_failed
detalleHTTPHTTP 400
No se pudo resolver el seguimiento (serie o lote) de un combo: hace falta un cliente (payee) válido en Zauru.
catalog_bundle_not_found
detalle
El combo elegido no se encontró en el catálogo.
catalog_detail_incomplete
detalleHTTPHTTP 400
El detalle del producto en el catálogo está incompleto (falta precio, unidad o datos de Zauru).
catalog_invoice_attachments_not_supported
detalleHTTPHTTP 400
El catálogo pidió una factura (document: "invoice", configuración catalog_order_as_invoice) con un PDF o una imagen. La guía de Zauru no documenta adjuntos al crear la factura, así que se rechaza antes de tocar Zauru.
- Qué hacer
- Quitar los archivos (el drawer en modo factura no los muestra) o crear una orden.
catalog_item_not_found
detalle
El producto elegido no se encontró en el catálogo.
catalog_order_as_invoice_disabled
detalleHTTPHTTP 400
Se rechaza antes de leer o tocar Zauru.
- Causa típica
- La configuración se apagó con el catálogo abierto, o alguien llamó la API con la marca sin tener la configuración.
- Qué hacer
- Recargar el catálogo (el switch vuelve a decir +Orden) o encender la configuración en Configuraciones > Catálogo.
currency_resolution_failed
detalleHTTPHTTP 400
No se pudo resolver la moneda del documento (el producto o la entidad no dicen en qué moneda está).
delivery_address_required
detalleHTTPHTTP 400
Con entrega, la dirección es obligatoria.
delivery_date_required
detalleHTTPHTTP 400
Con entrega, la fecha es obligatoria.
discount_not_allowed
detalle
El descuento elegido no está disponible para esa línea.
flexible_price_not_allowed
detalleHTTPHTTP 400
El producto no permite editar su precio.
global_discount_invalid
detalle
El descuento global no puede pasar de 100 %.
image_invalid_type
detalleHTTPHTTP 400
La imagen adjunta tiene que ser png, jpg, jpeg o webp.
mixed_currency_not_supported
detalle
Un documento no puede mezclar productos de monedas distintas.
order_compose_invalid
detalleHTTPHTTP 400
La orden tiene errores de armado que bloquean (ver errors[]).
order_create_failed
detalleHTTPHTTP 503
Zauru no creó la orden, o no devolvió su id (503). Es el mismo código cuando el catálogo crea una factura (catalog_order_as_invoice); el message dice invoice.
- Qué hacer
- Revisar en Zauru si la orden quedó creada ANTES de reintentar, para no duplicarla.
order_create_failed_after_payee_creation
detalle
El lead ya se promovió a cliente en Zauru pero la orden no se creó; side_effects lo dice. Reintentar no vuelve a crear el cliente.
order_locked_not_editable
detalleHTTPHTTP 400
Una orden emitida o pagada no se edita desde el catálogo.
order_payee_mismatch
detalleHTTPHTTP 400
El cliente (payee) de la orden no es el del lead pedido.
order_source_agency_mismatch
detalleHTTPHTTP 400
Una orden de origen es de otra agencia.
order_source_quantity_exceeded
detalleHTTPHTTP 400
Una línea toma más cantidad de la que le queda disponible a su línea de origen.
order_source_unavailable
detalleHTTPHTTP 400
Una línea de la orden de origen ya no está disponible.
order_update_failed
detalle
Zauru no aceptó la actualización de la orden.
order_voided_not_editable
detalleHTTPHTTP 400
Una orden anulada no se edita.
payee_create_failed
detalleHTTPHTTP 503
Zauru no devolvió el id del cliente (payee) al promover el lead (503).
- Qué hacer
- Revisar en Zauru si el cliente quedó creado antes de reintentar.
payment_term_not_allowed
detalleHTTPHTTP 400
El término de pago elegido no está permitido para esta orden.
pdf_invalid_type
detalleHTTPHTTP 400
El adjunto PDF tiene que ser un PDF.
quantity_requires_integer
detalle
El producto solo acepta cantidades enteras.
seller_not_available
detalleHTTPHTTP 400
El vendedor elegido no está disponible para este documento.
seller_not_linked_to_zauru
detalleHTTPHTTP 400
El vendedor elegido no está vinculado a un empleado de Zauru: sin eso no se puede crear el documento.
- Qué hacer
- Vincular el usuario con su empleado de Zauru.
shipper_not_available
detalleHTTPHTTP 400
El transportista elegido no está disponible.
shipper_required
detalleHTTPHTTP 400
Con entrega, el transportista es obligatorio.
stock_exceeded
detalle
La cantidad pedida pasa la existencia disponible.
tracking_not_available
detalle
La línea con seguimiento (serie o lote) no tiene unidades disponibles o su cantidad no es mayor a 0.
tracking_quantity_requires_integer
detalle
Las líneas con serie o lote solo aceptan cantidades enteras.
tracking_stock_exceeded
detalle
No hay suficientes series o lotes disponibles para la cantidad pedida.
zauru_credit_limit_reached
detalle
Zauru rechazó el término de pago porque el cliente llegó a su límite de crédito.
zauru_validation_error
detalle
Zauru rechazó un campo de la orden con un error de validación; field y message dicen cuál.
Texto generado desde el catálogo de errores de BoostAPI. Para corregirlo, se cambia allá y se sincroniza: verMantener esta documentación. También enMarkdown.