Convenciones

Formatos, identificadores, fechas, decimales y códigos de la API de Trevol.

Ver como Markdown

Dirección: https://api.trevol.si/v1. JSON en UTF-8; los campos van en inglés y los mensajes en español.
Montos: en los pedidos, número o texto decimal con punto ("150000.50"); en las respuestas, siempre texto con 2 decimales. Las cantidades admiten hasta 6 decimales. Los SDK mandan los montos como texto, sin errores de coma flotante.
Precios sin impuestos: unit_price va antes de IVA; Trevol calcula impuestos, retenciones y totales.
Códigos de la DIAN como texto: "01", "31", "47".
Identificadores con prefijo: inv_ factura, cn_ nota crédito, dn_ nota débito, sd_ documento soporte, sda_ su nota de ajuste, pos_ documento equivalente (de cualquier tipo), posa_ su nota de ajuste, pr_ nómina, pra_ su nota de ajuste y rev_ evento RADIAN.
external_id: tu identificador, opcional. Es único entre facturas, notas, documentos soporte y equivalentes (y sus notas); aparte, entre nóminas y sus ajustes; y aparte, entre eventos RADIAN. El existing_id de un conflicto puede ser el id de cualquiera de los recursos de su grupo.
Código de seguridad: se llama como lo llama la DIAN: cufe en la factura, cude en las notas, el documento equivalente y los eventos, cuds en el documento soporte y cune en la nómina.
Fechas: ISO 8601; issued_at en hora de Bogotá (-05:00).
Campos desconocidos: un campo que Trevol no conoce es un error (validation_error); no se ignora en silencio.
Cabeceras de respuesta: Request-Id (req_…) en cada respuesta, Trevol-Version con la versión usada e Idempotent-Replayed: true cuando se repite una respuesta guardada.

Cuando pidas ayuda

Comparte el Request-Id (req_…). Con él ubicamos tu petición en el registro sin ver los datos de tus clientes.