{ "_type": "export", "__export_format": 4, "__export_date": "2026-10-22T00:00:00.000Z", "__export_source": "trevol.sdks.colecciones", "resources": [ { "_id": "wrk_047e9a3422cdb40adb17ae433ec58d6b", "_type": "workspace", "parentId": null, "name": "API de Trevol (2026-10-22)", "description": "La API pública de Trevol (documentos electrónicos ante la DIAN). Pon tu llave en TREVOL_API_KEY del entorno base. https://platform.trevol.si/docs", "scope": "collection" }, { "_id": "env_f6cfdca82f485e5b4aba980450233d12", "_type": "environment", "parentId": "wrk_047e9a3422cdb40adb17ae433ec58d6b", "name": "Base Environment", "data": { "baseUrl": "https://api.trevol.si/v1", "TREVOL_API_KEY": "" }, "dataPropertyOrder": { "&": [ "baseUrl", "TREVOL_API_KEY" ] }, "color": null, "isPrivate": false, "metaSortKey": 1 }, { "_id": "fld_ca2bda45d439db2d57b3df7e8734b75d", "_type": "request_group", "parentId": "wrk_047e9a3422cdb40adb17ae433ec58d6b", "name": "General", "description": "Salud, la empresa de la llave y la consulta de adquirientes.", "environment": {}, "environmentPropertyOrder": null, "metaSortKey": 1000 }, { "_id": "req_57acb4588c1823d9ec4a9f59d9d95bf7", "_type": "request", "parentId": "fld_ca2bda45d439db2d57b3df7e8734b75d", "name": "Salud", "description": "Salud\n\nDocumentación: https://platform.trevol.si/docs/api#getHealth", "method": "GET", "url": "{{ _.baseUrl }}/health", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 1000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_b24287d38bfc1c6d13f0c77e189a9a5a", "_type": "request", "parentId": "fld_ca2bda45d439db2d57b3df7e8734b75d", "name": "La empresa de la llave", "description": "La empresa de la llave: NIT, razón social, ambiente y numeraciones activas. Desde la fase 3 trae `capabilities`, un resumen de lo que ESTA llave puede emitir ahora: documento soporte (con su numeración), documento equivalente (con los prefijos POS), nómina (`status`: `enabled`, `testing`, `not_registered` o `not_enabled`, según el ambiente de la llave) y eventos RADIAN (representante legal). Es informativo: si una lectura falla, esa clave no aparece.\n\nDocumentación: https://platform.trevol.si/docs/api#retrieveCompany", "method": "GET", "url": "{{ _.baseUrl }}/company", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 2000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_d6df092120ec8839bc55398c8852508c", "_type": "request", "parentId": "fld_ca2bda45d439db2d57b3df7e8734b75d", "name": "Datos del adquiriente en la DIAN", "description": "Datos del adquiriente en la DIAN\n\nDocumentación: https://platform.trevol.si/docs/api#retrieveDianAcquirer", "method": "GET", "url": "{{ _.baseUrl }}/dian/acquirer", "parameters": [ { "name": "document_type", "value": "31" }, { "name": "document_number", "value": "900373591" } ], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 3000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "fld_6c2552988c2f62fd1d9d03f3f35839ef", "_type": "request_group", "parentId": "wrk_047e9a3422cdb40adb17ae433ec58d6b", "name": "Saldo", "description": "El saldo prepago de la cuenta (lo comparten sus empresas), sus movimientos y las recargas con Wompi.", "environment": {}, "environmentPropertyOrder": null, "metaSortKey": 2000 }, { "_id": "req_4724138d8c2dc010da50ce0bcacc06fd", "_type": "request", "parentId": "fld_6c2552988c2f62fd1d9d03f3f35839ef", "name": "El saldo de la cuenta (lo comparten sus empresas)", "description": "El saldo prepago de Trevol. Es de la **cuenta**, no de la empresa: todas las empresas de la cuenta lo comparten (`shared: true`) y cualquier llave de cualquiera de ellas, de lectura o de escritura, `test` o `live`, ve el mismo. Solo lo que se emite en producción (llaves `live`) lo consume; la habilitación (`test`) no cobra. `available` es lo que se puede gastar (en pesos); `held`, lo apartado por documentos que la DIAN todavía valida; `overdraft`, cuánto puede bajar `available` de cero al apartar un documento; `low_threshold`, el umbral del aviso de saldo bajo (el 20 % de la última recarga; `null` sin recargas). `level`: `empty` con `available` ≤ 0, `low` por debajo de `low_threshold`, si no `ok`. Con `available` por debajo del precio de un documento, emitir en producción responde 402 `insufficient_balance`. El evento `balance.low` avisa por webhook.\n\nDocumentación: https://platform.trevol.si/docs/api#retrieveBalance", "method": "GET", "url": "{{ _.baseUrl }}/balance", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 1000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_97053906d7cc4d033d81bc0009a3492e", "_type": "request", "parentId": "fld_6c2552988c2f62fd1d9d03f3f35839ef", "name": "Los movimientos del saldo de la cuenta", "description": "Los movimientos del saldo de la cuenta (de todas sus empresas), del más nuevo al más viejo: lo mismo que «Saldo y recargas» en la app. Un documento es UNA fila (`type: document`) con su `status`: `pending` (apartado mientras la DIAN lo valida), `charged` (validado y cobrado) o `released` (la DIAN lo rechazó: no se cobró y `amount` es 0); `company` dice qué empresa lo emitió. Lo demás es una fila por movimiento: `top_up` (recarga, con su `reference`), `top_up_reversal`, `bonus`, `adjustment`, `license_fee`, `expiration` u `other`. `amount` es lo que el movimiento hizo con el disponible, con signo; `available_after`, el disponible justo después. Filtro `type`: `all` (por defecto), `documents`, `funding` (todo lo que no es un documento) o `top_ups`. Paginación por cursor: `limit` (1 a 100, 25 por defecto) y `starting_after` (el `id` de la última fila que tienes).\n\nDocumentación: https://platform.trevol.si/docs/api#listBalanceTransactions", "method": "GET", "url": "{{ _.baseUrl }}/balance/transactions", "parameters": [ { "name": "limit", "value": "100" } ], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 2000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_6466e495e456cc010401b59654dda350", "_type": "request", "parentId": "fld_6c2552988c2f62fd1d9d03f3f35839ef", "name": "Preparar una recarga del saldo (para el widget de Wompi)", "description": "Prepara una recarga del saldo de la cuenta y devuelve lo que necesita el widget de Wompi (`WidgetCheckout`: `publicKey`, `currency`, `amountInCents`, `reference`, `signature: {integrity}` y `expirationTime`). El pago se hace en el widget; cuando Wompi lo aprueba, Trevol abona el saldo (y la factura de la recarga sale a nombre de `buyer`). Preparar no mueve saldo y la firma vence en una hora: si el widget venció, prepara otra. Solo llaves de escritura; exige `Idempotency-Key` (repetir con la misma clave devuelve la MISMA recarga). Sin `buyer`, la factura va a nombre de la empresa de la llave con sus datos (NIT, DV, razón social, correo, teléfono, dirección y municipio); si no alcanzan, 422 en `buyer.*`. El monto va entre la recarga mínima y la máxima (422 `top_up_below_minimum` / `top_up_above_maximum` con `minimum_cop` / `maximum_cop`). Es dinero real con cualquier llave (también `test`): el saldo es uno solo. Hasta 20 por llave cada 10 minutos (429).\n\nIdempotency-Key: se genera una nueva en cada envío; para reintentar la MISMA llamada, fija una (p. ej. «VENTA-2026-000123»).\n\nOtros ejemplos de cuerpo en la documentación: empresa, comprador.\n\nDocumentación: https://platform.trevol.si/docs/api#createBalanceTopUp", "method": "POST", "url": "{{ _.baseUrl }}/balance/top_ups", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Idempotency-Key", "value": "{% uuid 'v4' %}" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"amount_cop\": 50000\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 3000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "fld_19118b29e8cbca29e239325cbd3718e9", "_type": "request_group", "parentId": "wrk_047e9a3422cdb40adb17ae433ec58d6b", "name": "Facturas", "description": "Emitir, consultar, corregir y reenviar facturas electrónicas, incluidas la exportación, la moneda extranjera, el AIU, los mandatos, el transporte, los notarios, las divisas y el sector salud.", "environment": {}, "environmentPropertyOrder": null, "metaSortKey": 3000 }, { "_id": "req_c70098fd9df37db8ec2acb90b5c1e662", "_type": "request", "parentId": "fld_19118b29e8cbca29e239325cbd3718e9", "name": "Emitir una factura", "description": "Valida, numera, firma y envía una factura a la DIAN. Además de la factura nacional acepta la exportación (`document_type: \"02\"`), la moneda extranjera (`currency`), los términos de entrega (`delivery_terms`), el AIU, los mandatos, el transporte de carga, los notarios, las divisas y el sector salud (`operation_type`). El envío físico de la mercancía va en `shipment` (no en `delivery`: ese es el estado del PDF, el ZIP y el correo en la respuesta). Las notas crédito y débito no admiten estos campos.\n\n**Respuestas.** `201` la DIAN lo validó (`status: accepted`). `202` solo en la versión 2026-10-22: la DIAN no contestó (`processing`), otra petición lo está enviando (`sending`) o, en habilitación, el set de pruebas todavía lo valida (`validating`, en las dos versiones); trae `Location` y `Retry-After`, y el resultado llega por GET y por webhook: **no crees otro documento para la misma operación**. `422` `validation_error` (se revisó a fondo ANTES de reservar: no se gastó el número, y `errors[]` dice el campo), `dian_rejected` (con `document` y las reglas traducidas; corrige con `PUT` y el mismo número), `company_not_enabled` o `numbering_unavailable` (con `reason`). `402` `insufficient_balance` (producción sin saldo: queda `pending` con su número). `409` `external_id_in_use` o `duplicate_document` (con `existing_id`). `503` `dian_unavailable` en la 2026-10-21. Pide `Idempotency-Key`: repetir la misma devuelve lo mismo sin enviar nada.\n\nIdempotency-Key: se genera una nueva en cada envío; para reintentar la MISMA llamada, fija una (p. ej. «VENTA-2026-000123»).\n\nOtros ejemplos de cuerpo en la documentación: venta, exportacion.\n\nDocumentación: https://platform.trevol.si/docs/api#createInvoice", "method": "POST", "url": "{{ _.baseUrl }}/invoices", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Idempotency-Key", "value": "{% uuid 'v4' %}" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"VENTA-2026-000123\",\n \"customer\": {\n \"document_type\": \"31\",\n \"document_number\": \"900123456\",\n \"name\": \"COMERCIALIZADORA ANDINA SAS\",\n \"person_type\": \"legal\",\n \"email\": \"facturacion@comercializadoraandina.example\",\n \"address\": \"Calle 72 # 10-34, Oficina 501\",\n \"municipality_code\": \"11001\"\n },\n \"items\": [\n {\n \"code\": \"LIC-ANUAL\",\n \"description\": \"Licencia anual de software\",\n \"quantity\": \"2\",\n \"unit_price\": \"150000\",\n \"taxes\": [\n {\n \"code\": \"01\",\n \"rate\": \"19\"\n }\n ]\n },\n {\n \"code\": \"SOP-MES\",\n \"description\": \"Soporte técnico mensual\",\n \"quantity\": \"1\",\n \"unit_price\": \"80000\",\n \"taxes\": [\n {\n \"code\": \"01\",\n \"rate\": \"19\"\n }\n ]\n }\n ],\n \"payment\": {\n \"form\": \"credit\",\n \"term_days\": 30\n },\n \"notes\": [\n \"Gracias por su compra\"\n ]\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 1000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_3db0b673d71bd004ef847d172507564e", "_type": "request", "parentId": "fld_19118b29e8cbca29e239325cbd3718e9", "name": "Listar (factura)", "description": "Listar (factura)\n\nDocumentación: https://platform.trevol.si/docs/api#listInvoices", "method": "GET", "url": "{{ _.baseUrl }}/invoices", "parameters": [ { "name": "limit", "value": "100" } ], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 2000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_4a98e77fee0074cd475b0612ebb211e6", "_type": "request", "parentId": "fld_19118b29e8cbca29e239325cbd3718e9", "name": "Calcular una factura sin emitirla", "description": "Calcular una factura sin emitirla\n\nOtros ejemplos de cuerpo en la documentación: venta, exportacion.\n\nDocumentación: https://platform.trevol.si/docs/api#previewInvoice", "method": "POST", "url": "{{ _.baseUrl }}/invoices/preview", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"VENTA-2026-000123\",\n \"customer\": {\n \"document_type\": \"31\",\n \"document_number\": \"900123456\",\n \"name\": \"COMERCIALIZADORA ANDINA SAS\",\n \"person_type\": \"legal\",\n \"email\": \"facturacion@comercializadoraandina.example\",\n \"address\": \"Calle 72 # 10-34, Oficina 501\",\n \"municipality_code\": \"11001\"\n },\n \"items\": [\n {\n \"code\": \"LIC-ANUAL\",\n \"description\": \"Licencia anual de software\",\n \"quantity\": \"2\",\n \"unit_price\": \"150000\",\n \"taxes\": [\n {\n \"code\": \"01\",\n \"rate\": \"19\"\n }\n ]\n },\n {\n \"code\": \"SOP-MES\",\n \"description\": \"Soporte técnico mensual\",\n \"quantity\": \"1\",\n \"unit_price\": \"80000\",\n \"taxes\": [\n {\n \"code\": \"01\",\n \"rate\": \"19\"\n }\n ]\n }\n ],\n \"payment\": {\n \"form\": \"credit\",\n \"term_days\": 30\n },\n \"notes\": [\n \"Gracias por su compra\"\n ]\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 3000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_af36dd3529011b88fba1a499f99454db", "_type": "request", "parentId": "fld_19118b29e8cbca29e239325cbd3718e9", "name": "Una factura", "description": "Una factura\n\nDocumentación: https://platform.trevol.si/docs/api#retrieveInvoice", "method": "GET", "url": "{{ _.baseUrl }}/invoices/inv_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 4000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_678784ce1e7d36789ababb1cf210d075", "_type": "request", "parentId": "fld_19118b29e8cbca29e239325cbd3718e9", "name": "Corregir una factura rechazada (mismo número) y reenviarla", "description": "Corregir una factura rechazada (mismo número) y reenviarla\n\nIdempotency-Key: se genera una nueva en cada envío; para reintentar la MISMA llamada, fija una (p. ej. «VENTA-2026-000123»).\n\nOtros ejemplos de cuerpo en la documentación: venta, exportacion.\n\nDocumentación: https://platform.trevol.si/docs/api#correctInvoice", "method": "PUT", "url": "{{ _.baseUrl }}/invoices/inv_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Idempotency-Key", "value": "{% uuid 'v4' %}" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"VENTA-2026-000123\",\n \"customer\": {\n \"document_type\": \"31\",\n \"document_number\": \"900123456\",\n \"name\": \"COMERCIALIZADORA ANDINA SAS\",\n \"person_type\": \"legal\",\n \"email\": \"facturacion@comercializadoraandina.example\",\n \"address\": \"Calle 72 # 10-34, Oficina 501\",\n \"municipality_code\": \"11001\"\n },\n \"items\": [\n {\n \"code\": \"LIC-ANUAL\",\n \"description\": \"Licencia anual de software\",\n \"quantity\": \"2\",\n \"unit_price\": \"150000\",\n \"taxes\": [\n {\n \"code\": \"01\",\n \"rate\": \"19\"\n }\n ]\n },\n {\n \"code\": \"SOP-MES\",\n \"description\": \"Soporte técnico mensual\",\n \"quantity\": \"1\",\n \"unit_price\": \"80000\",\n \"taxes\": [\n {\n \"code\": \"01\",\n \"rate\": \"19\"\n }\n ]\n }\n ],\n \"payment\": {\n \"form\": \"credit\",\n \"term_days\": 30\n },\n \"notes\": [\n \"Gracias por su compra\"\n ]\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 5000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_f01ac45224fa02459db265976ee9826e", "_type": "request", "parentId": "fld_19118b29e8cbca29e239325cbd3718e9", "name": "Reenviar una pendiente o en error", "description": "Reenviar una pendiente o en error\n\nDocumentación: https://platform.trevol.si/docs/api#sendInvoice", "method": "POST", "url": "{{ _.baseUrl }}/invoices/inv_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/send", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 6000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_beceb6d9707eae44ef48c90d22629393", "_type": "request", "parentId": "fld_19118b29e8cbca29e239325cbd3718e9", "name": "Archivo pdf", "description": "Archivo pdf\n\nDocumentación: https://platform.trevol.si/docs/api#downloadInvoicePdf", "method": "GET", "url": "{{ _.baseUrl }}/invoices/inv_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/pdf", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 7000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_52abc66aed958aaf049ecb3ce0defa39", "_type": "request", "parentId": "fld_19118b29e8cbca29e239325cbd3718e9", "name": "Archivo xml", "description": "Archivo xml\n\nDocumentación: https://platform.trevol.si/docs/api#downloadInvoiceXml", "method": "GET", "url": "{{ _.baseUrl }}/invoices/inv_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/xml", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 8000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_a1e0b6c2cd1ab766144c1687d196edc6", "_type": "request", "parentId": "fld_19118b29e8cbca29e239325cbd3718e9", "name": "Archivo zip", "description": "Archivo zip\n\nDocumentación: https://platform.trevol.si/docs/api#downloadInvoiceZip", "method": "GET", "url": "{{ _.baseUrl }}/invoices/inv_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/zip", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 9000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_4a6e7a0682037b3d803ac6288f48109e", "_type": "request", "parentId": "fld_19118b29e8cbca29e239325cbd3718e9", "name": "Archivo dian_response", "description": "Archivo dian_response\n\nDocumentación: https://platform.trevol.si/docs/api#downloadInvoiceDianResponse", "method": "GET", "url": "{{ _.baseUrl }}/invoices/inv_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/dian_response", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 10000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_79c730140ec937fdc74d9e6f6cdfea55", "_type": "request", "parentId": "fld_19118b29e8cbca29e239325cbd3718e9", "name": "¿Procede ya la aceptación tácita (034) de esta factura?", "description": "Consulta GetStatusEvent (con el certificado de la empresa) y aplica la regla de los 3 días hábiles; no envía nada. Usa el mismo historial que el envío del 034 (`POST /v1/radian_events`), así que la consulta y el envío no se contradicen. 404 si la factura no es de la empresa y el ambiente de la llave; 422 si no está validada, no es a crédito o es de consumidor final; 429 con más de 30 consultas por minuto por llave; 503 si la DIAN no contesta (reintentable).\n\nDocumentación: https://platform.trevol.si/docs/api#retrieveInvoiceTacitAcceptance", "method": "GET", "url": "{{ _.baseUrl }}/invoices/inv_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/tacit_acceptance", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 11000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "fld_f70129ae506174977a2e812b955b6ea7", "_type": "request_group", "parentId": "wrk_047e9a3422cdb40adb17ae433ec58d6b", "name": "Notas crédito", "description": "Notas crédito electrónicas.", "environment": {}, "environmentPropertyOrder": null, "metaSortKey": 4000 }, { "_id": "req_83d92148a207a27dbdc62a2f44540e70", "_type": "request", "parentId": "fld_f70129ae506174977a2e812b955b6ea7", "name": "Emitir una nota crédito", "description": "Emitir una nota crédito\n\nIdempotency-Key: se genera una nueva en cada envío; para reintentar la MISMA llamada, fija una (p. ej. «VENTA-2026-000123»).\n\nDocumentación: https://platform.trevol.si/docs/api#createCreditNote", "method": "POST", "url": "{{ _.baseUrl }}/credit_notes", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Idempotency-Key", "value": "{% uuid 'v4' %}" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"DEV-2026-000045\",\n \"concept\": \"1\",\n \"description\": \"Devolución de una unidad por empaque dañado\",\n \"invoice\": {\n \"id\": \"inv_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b\"\n },\n \"items\": [\n {\n \"description\": \"Café especial 500 g\",\n \"code\": \"CAF-500\",\n \"unit\": \"94\",\n \"quantity\": \"1\",\n \"unit_price\": \"32000\",\n \"taxes\": [\n {\n \"code\": \"01\",\n \"rate\": \"19\"\n }\n ]\n }\n ]\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 1000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_80f670152f37a5c8871b6811a4ea8884", "_type": "request", "parentId": "fld_f70129ae506174977a2e812b955b6ea7", "name": "Listar (nota crédito)", "description": "Listar (nota crédito)\n\nDocumentación: https://platform.trevol.si/docs/api#listCreditNotes", "method": "GET", "url": "{{ _.baseUrl }}/credit_notes", "parameters": [ { "name": "limit", "value": "100" } ], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 2000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_74d0c899feffce9b6994f4f6ae682b14", "_type": "request", "parentId": "fld_f70129ae506174977a2e812b955b6ea7", "name": "Calcular una nota crédito sin emitirla", "description": "Calcular una nota crédito sin emitirla\n\nDocumentación: https://platform.trevol.si/docs/api#previewCreditNote", "method": "POST", "url": "{{ _.baseUrl }}/credit_notes/preview", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"DEV-2026-000045\",\n \"concept\": \"1\",\n \"description\": \"Devolución de una unidad por empaque dañado\",\n \"invoice\": {\n \"id\": \"inv_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b\"\n },\n \"items\": [\n {\n \"description\": \"Café especial 500 g\",\n \"code\": \"CAF-500\",\n \"unit\": \"94\",\n \"quantity\": \"1\",\n \"unit_price\": \"32000\",\n \"taxes\": [\n {\n \"code\": \"01\",\n \"rate\": \"19\"\n }\n ]\n }\n ]\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 3000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_6b3698637470a5de3c171865c9b98135", "_type": "request", "parentId": "fld_f70129ae506174977a2e812b955b6ea7", "name": "Una nota crédito", "description": "Una nota crédito\n\nDocumentación: https://platform.trevol.si/docs/api#retrieveCreditNote", "method": "GET", "url": "{{ _.baseUrl }}/credit_notes/cn_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 4000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_5cc67ec37edff8ddcb5487907ee249dc", "_type": "request", "parentId": "fld_f70129ae506174977a2e812b955b6ea7", "name": "Corregir una nota crédito rechazada (mismo número) y reenviarla", "description": "Corregir una nota crédito rechazada (mismo número) y reenviarla\n\nIdempotency-Key: se genera una nueva en cada envío; para reintentar la MISMA llamada, fija una (p. ej. «VENTA-2026-000123»).\n\nDocumentación: https://platform.trevol.si/docs/api#correctCreditNote", "method": "PUT", "url": "{{ _.baseUrl }}/credit_notes/cn_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Idempotency-Key", "value": "{% uuid 'v4' %}" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"DEV-2026-000045\",\n \"concept\": \"1\",\n \"description\": \"Devolución de una unidad por empaque dañado\",\n \"invoice\": {\n \"id\": \"inv_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b\"\n },\n \"items\": [\n {\n \"description\": \"Café especial 500 g\",\n \"code\": \"CAF-500\",\n \"unit\": \"94\",\n \"quantity\": \"1\",\n \"unit_price\": \"32000\",\n \"taxes\": [\n {\n \"code\": \"01\",\n \"rate\": \"19\"\n }\n ]\n }\n ]\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 5000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_2408109a9261b34f9777043bd7e9728a", "_type": "request", "parentId": "fld_f70129ae506174977a2e812b955b6ea7", "name": "Reenviar una pendiente o en error", "description": "Reenviar una pendiente o en error\n\nDocumentación: https://platform.trevol.si/docs/api#sendCreditNote", "method": "POST", "url": "{{ _.baseUrl }}/credit_notes/cn_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/send", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 6000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_ea45b1aadf55af192e9ebe0458a2a5ee", "_type": "request", "parentId": "fld_f70129ae506174977a2e812b955b6ea7", "name": "Archivo pdf", "description": "Archivo pdf\n\nDocumentación: https://platform.trevol.si/docs/api#downloadCreditNotePdf", "method": "GET", "url": "{{ _.baseUrl }}/credit_notes/cn_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/pdf", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 7000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_9d11b1775f95780f8a2d034dd35a61ea", "_type": "request", "parentId": "fld_f70129ae506174977a2e812b955b6ea7", "name": "Archivo xml", "description": "Archivo xml\n\nDocumentación: https://platform.trevol.si/docs/api#downloadCreditNoteXml", "method": "GET", "url": "{{ _.baseUrl }}/credit_notes/cn_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/xml", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 8000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_f0b14844c5561d2b4ac191b73a9fa906", "_type": "request", "parentId": "fld_f70129ae506174977a2e812b955b6ea7", "name": "Archivo zip", "description": "Archivo zip\n\nDocumentación: https://platform.trevol.si/docs/api#downloadCreditNoteZip", "method": "GET", "url": "{{ _.baseUrl }}/credit_notes/cn_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/zip", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 9000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_241bf45204afc0f39ca019d2f854c838", "_type": "request", "parentId": "fld_f70129ae506174977a2e812b955b6ea7", "name": "Archivo dian_response", "description": "Archivo dian_response\n\nDocumentación: https://platform.trevol.si/docs/api#downloadCreditNoteDianResponse", "method": "GET", "url": "{{ _.baseUrl }}/credit_notes/cn_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/dian_response", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 10000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "fld_bb8b3802263af08a772bc0d357e5afb9", "_type": "request_group", "parentId": "wrk_047e9a3422cdb40adb17ae433ec58d6b", "name": "Notas débito", "description": "Notas débito electrónicas.", "environment": {}, "environmentPropertyOrder": null, "metaSortKey": 5000 }, { "_id": "req_60387f32b7a4b258f7dd3e5c0ec79196", "_type": "request", "parentId": "fld_bb8b3802263af08a772bc0d357e5afb9", "name": "Emitir una nota débito", "description": "Emitir una nota débito\n\nIdempotency-Key: se genera una nueva en cada envío; para reintentar la MISMA llamada, fija una (p. ej. «VENTA-2026-000123»).\n\nDocumentación: https://platform.trevol.si/docs/api#createDebitNote", "method": "POST", "url": "{{ _.baseUrl }}/debit_notes", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Idempotency-Key", "value": "{% uuid 'v4' %}" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"INT-2026-000012\",\n \"concept\": \"1\",\n \"description\": \"Intereses de mora de la factura de septiembre\",\n \"invoice\": {\n \"id\": \"inv_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b\"\n },\n \"items\": [\n {\n \"description\": \"Intereses de mora\",\n \"unit\": \"94\",\n \"quantity\": \"1\",\n \"unit_price\": \"45000\"\n }\n ]\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 1000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_687985c8a345442f59723468e7cefcc5", "_type": "request", "parentId": "fld_bb8b3802263af08a772bc0d357e5afb9", "name": "Listar (nota débito)", "description": "Listar (nota débito)\n\nDocumentación: https://platform.trevol.si/docs/api#listDebitNotes", "method": "GET", "url": "{{ _.baseUrl }}/debit_notes", "parameters": [ { "name": "limit", "value": "100" } ], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 2000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_515410a4acd264a65371758e4e784f35", "_type": "request", "parentId": "fld_bb8b3802263af08a772bc0d357e5afb9", "name": "Calcular una nota débito sin emitirla", "description": "Calcular una nota débito sin emitirla\n\nDocumentación: https://platform.trevol.si/docs/api#previewDebitNote", "method": "POST", "url": "{{ _.baseUrl }}/debit_notes/preview", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"INT-2026-000012\",\n \"concept\": \"1\",\n \"description\": \"Intereses de mora de la factura de septiembre\",\n \"invoice\": {\n \"id\": \"inv_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b\"\n },\n \"items\": [\n {\n \"description\": \"Intereses de mora\",\n \"unit\": \"94\",\n \"quantity\": \"1\",\n \"unit_price\": \"45000\"\n }\n ]\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 3000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_88a9f3f7128e6ba1b4112ad6b370e401", "_type": "request", "parentId": "fld_bb8b3802263af08a772bc0d357e5afb9", "name": "Una nota débito", "description": "Una nota débito\n\nDocumentación: https://platform.trevol.si/docs/api#retrieveDebitNote", "method": "GET", "url": "{{ _.baseUrl }}/debit_notes/dn_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 4000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_633fd4db584352ba1005a3df524c78b6", "_type": "request", "parentId": "fld_bb8b3802263af08a772bc0d357e5afb9", "name": "Corregir una nota débito rechazada (mismo número) y reenviarla", "description": "Corregir una nota débito rechazada (mismo número) y reenviarla\n\nIdempotency-Key: se genera una nueva en cada envío; para reintentar la MISMA llamada, fija una (p. ej. «VENTA-2026-000123»).\n\nDocumentación: https://platform.trevol.si/docs/api#correctDebitNote", "method": "PUT", "url": "{{ _.baseUrl }}/debit_notes/dn_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Idempotency-Key", "value": "{% uuid 'v4' %}" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"INT-2026-000012\",\n \"concept\": \"1\",\n \"description\": \"Intereses de mora de la factura de septiembre\",\n \"invoice\": {\n \"id\": \"inv_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b\"\n },\n \"items\": [\n {\n \"description\": \"Intereses de mora\",\n \"unit\": \"94\",\n \"quantity\": \"1\",\n \"unit_price\": \"45000\"\n }\n ]\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 5000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_b474ded35bee883e45ff3c4bbdfd8548", "_type": "request", "parentId": "fld_bb8b3802263af08a772bc0d357e5afb9", "name": "Reenviar una pendiente o en error", "description": "Reenviar una pendiente o en error\n\nDocumentación: https://platform.trevol.si/docs/api#sendDebitNote", "method": "POST", "url": "{{ _.baseUrl }}/debit_notes/dn_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/send", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 6000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_afa33b6340cce21fc63d15877eccca1a", "_type": "request", "parentId": "fld_bb8b3802263af08a772bc0d357e5afb9", "name": "Archivo pdf", "description": "Archivo pdf\n\nDocumentación: https://platform.trevol.si/docs/api#downloadDebitNotePdf", "method": "GET", "url": "{{ _.baseUrl }}/debit_notes/dn_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/pdf", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 7000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_3a5046ca19d77a64d66dc9011220b11e", "_type": "request", "parentId": "fld_bb8b3802263af08a772bc0d357e5afb9", "name": "Archivo xml", "description": "Archivo xml\n\nDocumentación: https://platform.trevol.si/docs/api#downloadDebitNoteXml", "method": "GET", "url": "{{ _.baseUrl }}/debit_notes/dn_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/xml", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 8000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_772f42f134003f28b2b6a0bfb6c22018", "_type": "request", "parentId": "fld_bb8b3802263af08a772bc0d357e5afb9", "name": "Archivo zip", "description": "Archivo zip\n\nDocumentación: https://platform.trevol.si/docs/api#downloadDebitNoteZip", "method": "GET", "url": "{{ _.baseUrl }}/debit_notes/dn_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/zip", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 9000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_c9e4ec379abe6564052ff78ba691b0a4", "_type": "request", "parentId": "fld_bb8b3802263af08a772bc0d357e5afb9", "name": "Archivo dian_response", "description": "Archivo dian_response\n\nDocumentación: https://platform.trevol.si/docs/api#downloadDebitNoteDianResponse", "method": "GET", "url": "{{ _.baseUrl }}/debit_notes/dn_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/dian_response", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 10000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "fld_ec962a8e7c86f153d4ead507b5113dfe", "_type": "request_group", "parentId": "wrk_047e9a3422cdb40adb17ae433ec58d6b", "name": "Documento soporte", "description": "Documento soporte en adquisiciones a no obligados a facturar (05) y su nota de ajuste (95). Se generan, no se expiden: sin PDF, ZIP ni correo.", "environment": {}, "environmentPropertyOrder": null, "metaSortKey": 6000 }, { "_id": "req_a865ae653edeaebe576871fa71397f87", "_type": "request", "parentId": "fld_ec962a8e7c86f153d4ead507b5113dfe", "name": "Emitir un documento soporte", "description": "Genera un **documento soporte** (tipo 05): el respaldo de una compra a quien no está obligado a facturar (una persona natural, un campesino, un proveedor del exterior). Trevol valida a fondo ANTES de reservar un número, numera con el rango de documento soporte vigente más nuevo (o el del prefijo de `numbering`), firma con el certificado de la empresa y lo manda a la DIAN. **Se genera, no se expide**: no hay PDF, ZIP ni correo; el XML y la respuesta de la DIAN se descargan en las dos versiones. La empresa necesita su software registrado ante la DIAN (`company_not_enabled` con `reason: missing_software`) y un rango vigente con números libres (`numbering_unavailable`, `no_resolution`). La `purchase_date` de cada línea no puede ser posterior a hoy (DSFC02b/c). Cuenta como documento de facturación en el cobro.\n\n**Respuestas.** `201` la DIAN lo validó (`status: accepted`). `202` solo en la versión 2026-10-22: la DIAN no contestó (`processing`), otra petición lo está enviando (`sending`) o, en habilitación, el set de pruebas todavía lo valida (`validating`, en las dos versiones); trae `Location` y `Retry-After`, y el resultado llega por GET y por webhook: **no crees otro documento para la misma operación**. `422` `validation_error` (se revisó a fondo ANTES de reservar: no se gastó el número, y `errors[]` dice el campo), `dian_rejected` (con `document` y las reglas traducidas; corrige con `PUT` y el mismo número), `company_not_enabled` o `numbering_unavailable` (con `reason`). `402` `insufficient_balance` (producción sin saldo: queda `pending` con su número). `409` `external_id_in_use` o `duplicate_document` (con `existing_id`). `503` `dian_unavailable` en la 2026-10-21. Pide `Idempotency-Key`: repetir la misma devuelve lo mismo sin enviar nada.\n\nIdempotency-Key: se genera una nueva en cada envío; para reintentar la MISMA llamada, fija una (p. ej. «VENTA-2026-000123»).\n\nDocumentación: https://platform.trevol.si/docs/api#createSupportDocument", "method": "POST", "url": "{{ _.baseUrl }}/support_documents", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Idempotency-Key", "value": "{% uuid 'v4' %}" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"OC-991\",\n \"seller\": {\n \"resident\": true,\n \"person_type\": \"natural\",\n \"document_type\": \"31\",\n \"document_number\": \"1020304050\",\n \"name\": \"PEREZ GOMEZ ANA MARIA\",\n \"address\": \"Vereda El Silencio, finca La Esperanza\",\n \"municipality_code\": \"25053\",\n \"postal_code\": \"252007\",\n \"tax_responsibilities\": [\n \"R-99-PN\"\n ]\n },\n \"items\": [\n {\n \"description\": \"Leche cruda\",\n \"unit\": \"LTR\",\n \"quantity\": \"120\",\n \"unit_price\": \"1800\"\n }\n ],\n \"payment\": {\n \"form\": \"cash\",\n \"methods\": [\n {\n \"code\": \"10\"\n }\n ]\n },\n \"notes\": [\n \"Compra de la semana 42 de octubre\"\n ]\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 1000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_80dc01440dade10b1946d97aba8a5cdd", "_type": "request", "parentId": "fld_ec962a8e7c86f153d4ead507b5113dfe", "name": "Listar (documento soporte)", "description": "Paginación por cursor (`limit` hasta 100, `starting_after`) y filtros `status`, `external_id`, `created_from` y `created_to`. `status=error` trae también los que están en verificación (`processing`).\n\nDocumentación: https://platform.trevol.si/docs/api#listSupportDocuments", "method": "GET", "url": "{{ _.baseUrl }}/support_documents", "parameters": [ { "name": "limit", "value": "100" } ], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 2000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_597ca0f31333f1db2634b732c881ebb6", "_type": "request", "parentId": "fld_ec962a8e7c86f153d4ead507b5113dfe", "name": "Calcular un documento soporte sin emitirlo", "description": "Valida y calcula los totales del documento soporte **sin** reservar un número ni enviar nada. No pide `Idempotency-Key` y no se cobra.\n\nDocumentación: https://platform.trevol.si/docs/api#previewSupportDocument", "method": "POST", "url": "{{ _.baseUrl }}/support_documents/preview", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"OC-991\",\n \"seller\": {\n \"resident\": true,\n \"person_type\": \"natural\",\n \"document_type\": \"31\",\n \"document_number\": \"1020304050\",\n \"name\": \"PEREZ GOMEZ ANA MARIA\",\n \"address\": \"Vereda El Silencio, finca La Esperanza\",\n \"municipality_code\": \"25053\",\n \"postal_code\": \"252007\",\n \"tax_responsibilities\": [\n \"R-99-PN\"\n ]\n },\n \"items\": [\n {\n \"description\": \"Leche cruda\",\n \"unit\": \"LTR\",\n \"quantity\": \"120\",\n \"unit_price\": \"1800\"\n }\n ],\n \"payment\": {\n \"form\": \"cash\",\n \"methods\": [\n {\n \"code\": \"10\"\n }\n ]\n },\n \"notes\": [\n \"Compra de la semana 42 de octubre\"\n ]\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 3000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_c265e9e18f181b1840efdc3ef6d09c97", "_type": "request", "parentId": "fld_ec962a8e7c86f153d4ead507b5113dfe", "name": "Un documento soporte", "description": "El documento soporte tal como se emitió: lo que mandaste, los totales, el CUDS y la respuesta de la DIAN. `delivery` no aplica (`status: null`).\n\nDocumentación: https://platform.trevol.si/docs/api#retrieveSupportDocument", "method": "GET", "url": "{{ _.baseUrl }}/support_documents/sd_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 4000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_c1c832cffac23eef3d4541dbfe810fc2", "_type": "request", "parentId": "fld_ec962a8e7c86f153d4ead507b5113dfe", "name": "Corregir un documento soporte rechazado (mismo número) y reenviarlo", "description": "Corrige un documento soporte rechazado con el **mismo número** y lo vuelve a enviar.\n\nSolo si el documento está `rejected`, `error` o `pending`. Uno `accepted` no se corrige (se ajusta con una nota) y uno que la DIAN todavía verifica es `409 invalid_state`: espera el resultado. El `external_id` y la numeración no se cambian. Pide `Idempotency-Key`.\n\nIdempotency-Key: se genera una nueva en cada envío; para reintentar la MISMA llamada, fija una (p. ej. «VENTA-2026-000123»).\n\nDocumentación: https://platform.trevol.si/docs/api#correctSupportDocument", "method": "PUT", "url": "{{ _.baseUrl }}/support_documents/sd_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Idempotency-Key", "value": "{% uuid 'v4' %}" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"OC-991\",\n \"seller\": {\n \"resident\": true,\n \"person_type\": \"natural\",\n \"document_type\": \"31\",\n \"document_number\": \"1020304050\",\n \"name\": \"PEREZ GOMEZ ANA MARIA\",\n \"address\": \"Vereda El Silencio, finca La Esperanza\",\n \"municipality_code\": \"25053\",\n \"postal_code\": \"252007\",\n \"tax_responsibilities\": [\n \"R-99-PN\"\n ]\n },\n \"items\": [\n {\n \"description\": \"Leche cruda\",\n \"unit\": \"LTR\",\n \"quantity\": \"120\",\n \"unit_price\": \"1800\"\n }\n ],\n \"payment\": {\n \"form\": \"cash\",\n \"methods\": [\n {\n \"code\": \"10\"\n }\n ]\n },\n \"notes\": [\n \"Compra de la semana 42 de octubre\"\n ]\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 5000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_e27742bbcfac3cd4dd3e7a1fffc31f0d", "_type": "request", "parentId": "fld_ec962a8e7c86f153d4ead507b5113dfe", "name": "Reenviar una pendiente o en error", "description": "Vuelve a enviar un documento soporte `pending` o `error` (por ejemplo, después de recargar saldo).\n\nSin cuerpo. Con un documento `accepted` responde `200` con el documento tal cual; con uno que la DIAN todavía verifica no reenvía nada (`202`); con uno `rejected` es `409 invalid_state` (se corrige con `PUT`). No pide `Idempotency-Key` (reintentarlo es seguro).\n\nDocumentación: https://platform.trevol.si/docs/api#sendSupportDocument", "method": "POST", "url": "{{ _.baseUrl }}/support_documents/sd_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/send", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 6000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_a7a49553a18f0e079dc86f726a834eec", "_type": "request", "parentId": "fld_ec962a8e7c86f153d4ead507b5113dfe", "name": "Archivo xml", "description": "El XML firmado que se mandó a la DIAN (`application/xml`).\n\nDocumentación: https://platform.trevol.si/docs/api#downloadSupportDocumentXml", "method": "GET", "url": "{{ _.baseUrl }}/support_documents/sd_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/xml", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 7000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_a4658d75be08b291ce76268d56e18664", "_type": "request", "parentId": "fld_ec962a8e7c86f153d4ead507b5113dfe", "name": "Archivo dian_response", "description": "El `ApplicationResponse` con que la DIAN contestó (`application/xml`), en las dos versiones.\n\nDocumentación: https://platform.trevol.si/docs/api#downloadSupportDocumentDianResponse", "method": "GET", "url": "{{ _.baseUrl }}/support_documents/sd_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/dian_response", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 8000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_ae7cba8a3989d9510fe2c57bfa94f19b", "_type": "request", "parentId": "fld_ec962a8e7c86f153d4ead507b5113dfe", "name": "Emitir una nota de ajuste del documento soporte", "description": "Genera la **nota de ajuste de un documento soporte** (95): corrige o anula una compra ya validada. El documento que ajusta es de Trevol (`support_document.id`) o de otra plataforma (`number`, `cuds`, `issue_date` y `total`). `concept` 1 a 5; el 2 anula y lleva exactamente los valores del documento. Sin `seller` hereda el del documento de Trevol. La suma de las notas no puede pasar del saldo del documento. Un documento soporte rechazado no se ajusta: se corrige con `PUT`.\n\n**Respuestas.** `201` la DIAN lo validó (`status: accepted`). `202` solo en la versión 2026-10-22: la DIAN no contestó (`processing`), otra petición lo está enviando (`sending`) o, en habilitación, el set de pruebas todavía lo valida (`validating`, en las dos versiones); trae `Location` y `Retry-After`, y el resultado llega por GET y por webhook: **no crees otro documento para la misma operación**. `422` `validation_error` (se revisó a fondo ANTES de reservar: no se gastó el número, y `errors[]` dice el campo), `dian_rejected` (con `document` y las reglas traducidas; corrige con `PUT` y el mismo número), `company_not_enabled` o `numbering_unavailable` (con `reason`). `402` `insufficient_balance` (producción sin saldo: queda `pending` con su número). `409` `external_id_in_use` o `duplicate_document` (con `existing_id`). `503` `dian_unavailable` en la 2026-10-21. Pide `Idempotency-Key`: repetir la misma devuelve lo mismo sin enviar nada.\n\nIdempotency-Key: se genera una nueva en cada envío; para reintentar la MISMA llamada, fija una (p. ej. «VENTA-2026-000123»).\n\nDocumentación: https://platform.trevol.si/docs/api#createSupportDocumentAdjustment", "method": "POST", "url": "{{ _.baseUrl }}/support_document_adjustments", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Idempotency-Key", "value": "{% uuid 'v4' %}" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"OC-991-ANULA\",\n \"concept\": \"2\",\n \"description\": \"Anulación: la compra de leche se registró dos veces en el ERP\",\n \"support_document\": {\n \"id\": \"sd_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b\"\n },\n \"items\": [\n {\n \"description\": \"Leche cruda\",\n \"unit\": \"LTR\",\n \"quantity\": \"120\",\n \"unit_price\": \"1800\"\n }\n ]\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 9000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_6c8401faa55f8dbd8650d72b012f8fc6", "_type": "request", "parentId": "fld_ec962a8e7c86f153d4ead507b5113dfe", "name": "Listar (nota de ajuste del documento soporte)", "description": "Paginación por cursor (`limit` hasta 100, `starting_after`) y filtros `status`, `external_id`, `created_from` y `created_to`. `status=error` trae también los que están en verificación (`processing`).\n\nDocumentación: https://platform.trevol.si/docs/api#listSupportDocumentAdjustments", "method": "GET", "url": "{{ _.baseUrl }}/support_document_adjustments", "parameters": [ { "name": "limit", "value": "100" } ], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 10000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_b593384482c61154a089eb3449a6e15e", "_type": "request", "parentId": "fld_ec962a8e7c86f153d4ead507b5113dfe", "name": "Calcular una nota de ajuste del documento soporte sin emitirla", "description": "Valida y calcula la nota de ajuste **sin** reservar un número ni enviar nada.\n\nDocumentación: https://platform.trevol.si/docs/api#previewSupportDocumentAdjustment", "method": "POST", "url": "{{ _.baseUrl }}/support_document_adjustments/preview", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"OC-991-ANULA\",\n \"concept\": \"2\",\n \"description\": \"Anulación: la compra de leche se registró dos veces en el ERP\",\n \"support_document\": {\n \"id\": \"sd_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b\"\n },\n \"items\": [\n {\n \"description\": \"Leche cruda\",\n \"unit\": \"LTR\",\n \"quantity\": \"120\",\n \"unit_price\": \"1800\"\n }\n ]\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 11000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_91f23db27a00dd6cf7efa807caf4b257", "_type": "request", "parentId": "fld_ec962a8e7c86f153d4ead507b5113dfe", "name": "Una nota de ajuste del documento soporte", "description": "La nota de ajuste del documento soporte, con `support_document` (el documento que ajusta).\n\nDocumentación: https://platform.trevol.si/docs/api#retrieveSupportDocumentAdjustment", "method": "GET", "url": "{{ _.baseUrl }}/support_document_adjustments/sda_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 12000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_b78c378611c3a58de2ef61ad4eb1f483", "_type": "request", "parentId": "fld_ec962a8e7c86f153d4ead507b5113dfe", "name": "Corregir una nota de ajuste del documento soporte rechazada (mismo número) y reenviarla", "description": "Corrige una nota de ajuste rechazada con el **mismo número** y la vuelve a enviar.\n\nSolo si el documento está `rejected`, `error` o `pending`. Uno `accepted` no se corrige (se ajusta con una nota) y uno que la DIAN todavía verifica es `409 invalid_state`: espera el resultado. El `external_id` y la numeración no se cambian. Pide `Idempotency-Key`.\n\nIdempotency-Key: se genera una nueva en cada envío; para reintentar la MISMA llamada, fija una (p. ej. «VENTA-2026-000123»).\n\nDocumentación: https://platform.trevol.si/docs/api#correctSupportDocumentAdjustment", "method": "PUT", "url": "{{ _.baseUrl }}/support_document_adjustments/sda_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Idempotency-Key", "value": "{% uuid 'v4' %}" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"OC-991-ANULA\",\n \"concept\": \"2\",\n \"description\": \"Anulación: la compra de leche se registró dos veces en el ERP\",\n \"support_document\": {\n \"id\": \"sd_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b\"\n },\n \"items\": [\n {\n \"description\": \"Leche cruda\",\n \"unit\": \"LTR\",\n \"quantity\": \"120\",\n \"unit_price\": \"1800\"\n }\n ]\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 13000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_62aded8cad4ca090b2b3505720a343d5", "_type": "request", "parentId": "fld_ec962a8e7c86f153d4ead507b5113dfe", "name": "Reenviar una pendiente o en error", "description": "Vuelve a enviar una nota de ajuste `pending` o `error`.\n\nSin cuerpo. Con un documento `accepted` responde `200` con el documento tal cual; con uno que la DIAN todavía verifica no reenvía nada (`202`); con uno `rejected` es `409 invalid_state` (se corrige con `PUT`). No pide `Idempotency-Key` (reintentarlo es seguro).\n\nDocumentación: https://platform.trevol.si/docs/api#sendSupportDocumentAdjustment", "method": "POST", "url": "{{ _.baseUrl }}/support_document_adjustments/sda_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/send", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 14000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_d78e258058e3da26f92d7aa6c836a087", "_type": "request", "parentId": "fld_ec962a8e7c86f153d4ead507b5113dfe", "name": "Archivo xml", "description": "El XML firmado que se mandó a la DIAN (`application/xml`).\n\nDocumentación: https://platform.trevol.si/docs/api#downloadSupportDocumentAdjustmentXml", "method": "GET", "url": "{{ _.baseUrl }}/support_document_adjustments/sda_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/xml", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 15000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_5d18e25775b98c86a572aa33bd631e2b", "_type": "request", "parentId": "fld_ec962a8e7c86f153d4ead507b5113dfe", "name": "Archivo dian_response", "description": "El `ApplicationResponse` con que la DIAN contestó (`application/xml`).\n\nDocumentación: https://platform.trevol.si/docs/api#downloadSupportDocumentAdjustmentDianResponse", "method": "GET", "url": "{{ _.baseUrl }}/support_document_adjustments/sda_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/dian_response", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 16000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "fld_de6535a082a319ef780523f7e7b5a1c4", "_type": "request_group", "parentId": "wrk_047e9a3422cdb40adb17ae433ec58d6b", "name": "Documento equivalente", "description": "Documento equivalente electrónico (tiquete POS 20 y los tipos 25, 27, 30, 35, 40, 45, 50, 55 y 60) y su nota de ajuste (crédito 94 y débito 93). Se expiden como la factura: PDF, ZIP y correo.", "environment": {}, "environmentPropertyOrder": null, "metaSortKey": 7000 }, { "_id": "req_aebaf1a14078b848606597afd1118ee6", "_type": "request", "parentId": "fld_de6535a082a319ef780523f7e7b5a1c4", "name": "Emitir un documento equivalente", "description": "Genera un **documento equivalente electrónico**: el tiquete POS (20, por defecto) o cualquiera de los otros nueve tipos de la tabla 16.3 (`document_type`: 25 cine, 27 espectáculos, 30 juegos, 35 transporte, 40 peajes, 45 extracto, 50 tiquete aéreo, 55 bolsa de valores, 60 servicios públicos; cada uno con su información propia en `extension`). El POS lleva su caja en `pos.register` y, si la empresa tiene varias cajas, el prefijo de su resolución en `numbering.prefix`. Se expide como la factura: PDF, ZIP y correo después del 201 (espera `equivalent_document.delivered` o consulta `delivery.status`). La contingencia 07 (documento físico) se pide con `contingency`; la 08 (la DIAN no contestó) la decide Trevol y responde `202` con `status: contingency`. En habilitación, el set de pruebas por tipo es automático: mientras la DIAN lo valida responde `202 validating` en las dos versiones y reintentar no vuelve a mandarlo. Cómo se calcula el CUDE del POS depende del despliegue del servicio, no de la empresa.\n\n**Respuestas.** `201` la DIAN lo validó (`status: accepted`). `202` solo en la versión 2026-10-22: la DIAN no contestó (`processing`), otra petición lo está enviando (`sending`) o, en habilitación, el set de pruebas todavía lo valida (`validating`, en las dos versiones); trae `Location` y `Retry-After`, y el resultado llega por GET y por webhook: **no crees otro documento para la misma operación**. `422` `validation_error` (se revisó a fondo ANTES de reservar: no se gastó el número, y `errors[]` dice el campo), `dian_rejected` (con `document` y las reglas traducidas; corrige con `PUT` y el mismo número), `company_not_enabled` o `numbering_unavailable` (con `reason`). `402` `insufficient_balance` (producción sin saldo: queda `pending` con su número). `409` `external_id_in_use` o `duplicate_document` (con `existing_id`). `503` `dian_unavailable` en la 2026-10-21. Pide `Idempotency-Key`: repetir la misma devuelve lo mismo sin enviar nada.\n\nIdempotency-Key: se genera una nueva en cada envío; para reintentar la MISMA llamada, fija una (p. ej. «VENTA-2026-000123»).\n\nDocumentación: https://platform.trevol.si/docs/api#createEquivalentDocument", "method": "POST", "url": "{{ _.baseUrl }}/equivalent_documents", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Idempotency-Key", "value": "{% uuid 'v4' %}" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"TIQ-1\",\n \"customer\": {\n \"final_consumer\": true\n },\n \"pos\": {\n \"register\": {\n \"plate\": \"CJ-01\",\n \"location\": \"Local 1, Jamundí\",\n \"cashier\": \"PEREZ ANA\",\n \"type\": \"Caja principal\"\n }\n },\n \"numbering\": {\n \"prefix\": \"POS2\"\n },\n \"payment\": {\n \"form\": \"cash\",\n \"methods\": [\n {\n \"code\": \"10\"\n }\n ]\n },\n \"items\": [\n {\n \"description\": \"Gaseosa 400 ml\",\n \"code\": \"GAS-1\",\n \"unit\": \"94\",\n \"quantity\": \"2\",\n \"unit_price\": \"3000\",\n \"taxes\": [\n {\n \"code\": \"01\",\n \"rate\": \"19\"\n }\n ]\n },\n {\n \"description\": \"Almuerzo\",\n \"unit\": \"94\",\n \"quantity\": \"1\",\n \"unit_price\": \"18000\"\n }\n ]\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 1000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_f39543a263ae02e5077c2debbbcf44bb", "_type": "request", "parentId": "fld_de6535a082a319ef780523f7e7b5a1c4", "name": "Listar (documento equivalente)", "description": "Paginación por cursor (`limit` hasta 100, `starting_after`) y filtros `status`, `external_id`, `created_from` y `created_to`. `status=error` trae también los que están en verificación (`processing`). Además, `document_type` filtra por tipo.\n\nDocumentación: https://platform.trevol.si/docs/api#listEquivalentDocuments", "method": "GET", "url": "{{ _.baseUrl }}/equivalent_documents", "parameters": [ { "name": "limit", "value": "100" } ], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 2000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_92d8f795cca8069ee6247b9b2bb899f5", "_type": "request", "parentId": "fld_de6535a082a319ef780523f7e7b5a1c4", "name": "Calcular un documento equivalente sin emitirlo", "description": "Valida y calcula los totales **sin** reservar un número ni enviar nada. No pide `Idempotency-Key`.\n\nDocumentación: https://platform.trevol.si/docs/api#previewEquivalentDocument", "method": "POST", "url": "{{ _.baseUrl }}/equivalent_documents/preview", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"TIQ-1\",\n \"customer\": {\n \"final_consumer\": true\n },\n \"pos\": {\n \"register\": {\n \"plate\": \"CJ-01\",\n \"location\": \"Local 1, Jamundí\",\n \"cashier\": \"PEREZ ANA\",\n \"type\": \"Caja principal\"\n }\n },\n \"numbering\": {\n \"prefix\": \"POS2\"\n },\n \"payment\": {\n \"form\": \"cash\",\n \"methods\": [\n {\n \"code\": \"10\"\n }\n ]\n },\n \"items\": [\n {\n \"description\": \"Gaseosa 400 ml\",\n \"code\": \"GAS-1\",\n \"unit\": \"94\",\n \"quantity\": \"2\",\n \"unit_price\": \"3000\",\n \"taxes\": [\n {\n \"code\": \"01\",\n \"rate\": \"19\"\n }\n ]\n },\n {\n \"description\": \"Almuerzo\",\n \"unit\": \"94\",\n \"quantity\": \"1\",\n \"unit_price\": \"18000\"\n }\n ]\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 3000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_7cc4b236e676514ee96351a618529a28", "_type": "request", "parentId": "fld_de6535a082a319ef780523f7e7b5a1c4", "name": "Un documento equivalente", "description": "El documento equivalente tal como se emitió. `contingency` dice si salió en contingencia (07 u 08) y, en la 08, cuándo se mandó el respaldo POS.\n\nDocumentación: https://platform.trevol.si/docs/api#retrieveEquivalentDocument", "method": "GET", "url": "{{ _.baseUrl }}/equivalent_documents/pos_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 4000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_fb189016c1791a2f7ff7bec4f4378472", "_type": "request", "parentId": "fld_de6535a082a319ef780523f7e7b5a1c4", "name": "Corregir un documento equivalente rechazado (mismo número) y reenviarlo", "description": "Corrige un documento equivalente rechazado con el **mismo número** y lo vuelve a enviar. Con el set de pruebas en curso responde `409 invalid_state`.\n\nSolo si el documento está `rejected`, `error` o `pending`. Uno `accepted` no se corrige (se ajusta con una nota) y uno que la DIAN todavía verifica es `409 invalid_state`: espera el resultado. El `external_id` y la numeración no se cambian. Pide `Idempotency-Key`.\n\nIdempotency-Key: se genera una nueva en cada envío; para reintentar la MISMA llamada, fija una (p. ej. «VENTA-2026-000123»).\n\nDocumentación: https://platform.trevol.si/docs/api#correctEquivalentDocument", "method": "PUT", "url": "{{ _.baseUrl }}/equivalent_documents/pos_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Idempotency-Key", "value": "{% uuid 'v4' %}" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"TIQ-1\",\n \"customer\": {\n \"final_consumer\": true\n },\n \"pos\": {\n \"register\": {\n \"plate\": \"CJ-01\",\n \"location\": \"Local 1, Jamundí\",\n \"cashier\": \"PEREZ ANA\",\n \"type\": \"Caja principal\"\n }\n },\n \"numbering\": {\n \"prefix\": \"POS2\"\n },\n \"payment\": {\n \"form\": \"cash\",\n \"methods\": [\n {\n \"code\": \"10\"\n }\n ]\n },\n \"items\": [\n {\n \"description\": \"Gaseosa 400 ml\",\n \"code\": \"GAS-1\",\n \"unit\": \"94\",\n \"quantity\": \"2\",\n \"unit_price\": \"3000\",\n \"taxes\": [\n {\n \"code\": \"01\",\n \"rate\": \"19\"\n }\n ]\n },\n {\n \"description\": \"Almuerzo\",\n \"unit\": \"94\",\n \"quantity\": \"1\",\n \"unit_price\": \"18000\"\n }\n ]\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 5000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_8c5b738b90372c238faf20bcf8d374bc", "_type": "request", "parentId": "fld_de6535a082a319ef780523f7e7b5a1c4", "name": "Reenviar una pendiente o en error", "description": "Vuelve a enviar un documento equivalente `pending` o `error`. En contingencia devuelve el documento (lo reenvía Trevol). Con el set de pruebas en curso (`validating`) solo consulta: no lo vuelve a mandar.\n\nSin cuerpo. Con un documento `accepted` responde `200` con el documento tal cual; con uno que la DIAN todavía verifica no reenvía nada (`202`); con uno `rejected` es `409 invalid_state` (se corrige con `PUT`). No pide `Idempotency-Key` (reintentarlo es seguro).\n\nDocumentación: https://platform.trevol.si/docs/api#sendEquivalentDocument", "method": "POST", "url": "{{ _.baseUrl }}/equivalent_documents/pos_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/send", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 6000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_f90e0581daef3fe2ffdae983cbf87335", "_type": "request", "parentId": "fld_de6535a082a319ef780523f7e7b5a1c4", "name": "Archivo pdf", "description": "La representación gráfica (`application/pdf`). Si todavía no se hizo, se genera en el momento.\n\nDocumentación: https://platform.trevol.si/docs/api#downloadEquivalentDocumentPdf", "method": "GET", "url": "{{ _.baseUrl }}/equivalent_documents/pos_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/pdf", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 7000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_b4889414ce58595bcce231dd37bdcc2f", "_type": "request", "parentId": "fld_de6535a082a319ef780523f7e7b5a1c4", "name": "Archivo xml", "description": "El XML firmado que se mandó a la DIAN (`application/xml`).\n\nDocumentación: https://platform.trevol.si/docs/api#downloadEquivalentDocumentXml", "method": "GET", "url": "{{ _.baseUrl }}/equivalent_documents/pos_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/xml", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 8000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_ced426033575b8a1d3537bd6d41e0476", "_type": "request", "parentId": "fld_de6535a082a319ef780523f7e7b5a1c4", "name": "Archivo zip", "description": "El ZIP de entrega con el XML firmado y el PDF (`application/zip`).\n\nDocumentación: https://platform.trevol.si/docs/api#downloadEquivalentDocumentZip", "method": "GET", "url": "{{ _.baseUrl }}/equivalent_documents/pos_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/zip", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 9000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_eea6e43ed0378bb76830d51dde7bf850", "_type": "request", "parentId": "fld_de6535a082a319ef780523f7e7b5a1c4", "name": "Archivo dian_response", "description": "El `ApplicationResponse` con que la DIAN contestó (`application/xml`).\n\nDocumentación: https://platform.trevol.si/docs/api#downloadEquivalentDocumentDianResponse", "method": "GET", "url": "{{ _.baseUrl }}/equivalent_documents/pos_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/dian_response", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 10000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_4045d539d9773671859406e76b0a89e5", "_type": "request", "parentId": "fld_de6535a082a319ef780523f7e7b5a1c4", "name": "Emitir una nota de ajuste del documento equivalente", "description": "Genera la **nota de ajuste de un documento equivalente**: crédito (94) o débito (93) según `note_type`. El documento que ajusta es de Trevol (`equivalent_document.id`) o de otra plataforma. `concept` 1 a 5 (el 2 anula y lleva exactamente los valores del documento). Sin `customer` toma el del documento; en juegos el adquirente es la DIAN. Se expide como el documento: PDF, ZIP y correo.\n\n**Respuestas.** `201` la DIAN lo validó (`status: accepted`). `202` solo en la versión 2026-10-22: la DIAN no contestó (`processing`), otra petición lo está enviando (`sending`) o, en habilitación, el set de pruebas todavía lo valida (`validating`, en las dos versiones); trae `Location` y `Retry-After`, y el resultado llega por GET y por webhook: **no crees otro documento para la misma operación**. `422` `validation_error` (se revisó a fondo ANTES de reservar: no se gastó el número, y `errors[]` dice el campo), `dian_rejected` (con `document` y las reglas traducidas; corrige con `PUT` y el mismo número), `company_not_enabled` o `numbering_unavailable` (con `reason`). `402` `insufficient_balance` (producción sin saldo: queda `pending` con su número). `409` `external_id_in_use` o `duplicate_document` (con `existing_id`). `503` `dian_unavailable` en la 2026-10-21. Pide `Idempotency-Key`: repetir la misma devuelve lo mismo sin enviar nada.\n\nIdempotency-Key: se genera una nueva en cada envío; para reintentar la MISMA llamada, fija una (p. ej. «VENTA-2026-000123»).\n\nDocumentación: https://platform.trevol.si/docs/api#createEquivalentDocumentAdjustment", "method": "POST", "url": "{{ _.baseUrl }}/equivalent_document_adjustments", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Idempotency-Key", "value": "{% uuid 'v4' %}" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"TIQ-1-DEV\",\n \"note_type\": \"credit\",\n \"concept\": \"1\",\n \"equivalent_document\": {\n \"id\": \"pos_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b\"\n },\n \"items\": [\n {\n \"description\": \"Devolución gaseosa\",\n \"unit\": \"94\",\n \"quantity\": \"1\",\n \"unit_price\": \"3000\",\n \"taxes\": [\n {\n \"code\": \"01\",\n \"rate\": \"19\"\n }\n ]\n }\n ]\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 11000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_c06281ef055c696aabac13ba349aa7d8", "_type": "request", "parentId": "fld_de6535a082a319ef780523f7e7b5a1c4", "name": "Listar (nota de ajuste del documento equivalente)", "description": "Paginación por cursor (`limit` hasta 100, `starting_after`) y filtros `status`, `external_id`, `created_from` y `created_to`. `status=error` trae también los que están en verificación (`processing`).\n\nDocumentación: https://platform.trevol.si/docs/api#listEquivalentDocumentAdjustments", "method": "GET", "url": "{{ _.baseUrl }}/equivalent_document_adjustments", "parameters": [ { "name": "limit", "value": "100" } ], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 12000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_6fab216a5f942e924ebadfddfe3375ac", "_type": "request", "parentId": "fld_de6535a082a319ef780523f7e7b5a1c4", "name": "Calcular una nota de ajuste del documento equivalente sin emitirla", "description": "Valida y calcula la nota de ajuste **sin** reservar un número ni enviar nada.\n\nDocumentación: https://platform.trevol.si/docs/api#previewEquivalentDocumentAdjustment", "method": "POST", "url": "{{ _.baseUrl }}/equivalent_document_adjustments/preview", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"TIQ-1-DEV\",\n \"note_type\": \"credit\",\n \"concept\": \"1\",\n \"equivalent_document\": {\n \"id\": \"pos_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b\"\n },\n \"items\": [\n {\n \"description\": \"Devolución gaseosa\",\n \"unit\": \"94\",\n \"quantity\": \"1\",\n \"unit_price\": \"3000\",\n \"taxes\": [\n {\n \"code\": \"01\",\n \"rate\": \"19\"\n }\n ]\n }\n ]\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 13000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_2c98a64cb7b49bad5c35453b7bf1465e", "_type": "request", "parentId": "fld_de6535a082a319ef780523f7e7b5a1c4", "name": "Una nota de ajuste del documento equivalente", "description": "La nota de ajuste del documento equivalente, con `equivalent_document` (el documento que ajusta).\n\nDocumentación: https://platform.trevol.si/docs/api#retrieveEquivalentDocumentAdjustment", "method": "GET", "url": "{{ _.baseUrl }}/equivalent_document_adjustments/posa_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 14000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_5a110d89f1180d99a9ae5f511e24843d", "_type": "request", "parentId": "fld_de6535a082a319ef780523f7e7b5a1c4", "name": "Corregir una nota de ajuste del documento equivalente rechazada (mismo número) y reenviarla", "description": "Corrige una nota de ajuste rechazada con el **mismo número** y la vuelve a enviar.\n\nSolo si el documento está `rejected`, `error` o `pending`. Uno `accepted` no se corrige (se ajusta con una nota) y uno que la DIAN todavía verifica es `409 invalid_state`: espera el resultado. El `external_id` y la numeración no se cambian. Pide `Idempotency-Key`.\n\nIdempotency-Key: se genera una nueva en cada envío; para reintentar la MISMA llamada, fija una (p. ej. «VENTA-2026-000123»).\n\nDocumentación: https://platform.trevol.si/docs/api#correctEquivalentDocumentAdjustment", "method": "PUT", "url": "{{ _.baseUrl }}/equivalent_document_adjustments/posa_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Idempotency-Key", "value": "{% uuid 'v4' %}" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"TIQ-1-DEV\",\n \"note_type\": \"credit\",\n \"concept\": \"1\",\n \"equivalent_document\": {\n \"id\": \"pos_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b\"\n },\n \"items\": [\n {\n \"description\": \"Devolución gaseosa\",\n \"unit\": \"94\",\n \"quantity\": \"1\",\n \"unit_price\": \"3000\",\n \"taxes\": [\n {\n \"code\": \"01\",\n \"rate\": \"19\"\n }\n ]\n }\n ]\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 15000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_91b7146ef42b9b38716b131ba4c8c328", "_type": "request", "parentId": "fld_de6535a082a319ef780523f7e7b5a1c4", "name": "Reenviar una pendiente o en error", "description": "Vuelve a enviar una nota de ajuste `pending` o `error`.\n\nSin cuerpo. Con un documento `accepted` responde `200` con el documento tal cual; con uno que la DIAN todavía verifica no reenvía nada (`202`); con uno `rejected` es `409 invalid_state` (se corrige con `PUT`). No pide `Idempotency-Key` (reintentarlo es seguro).\n\nDocumentación: https://platform.trevol.si/docs/api#sendEquivalentDocumentAdjustment", "method": "POST", "url": "{{ _.baseUrl }}/equivalent_document_adjustments/posa_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/send", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 16000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_8d8087297312219d2e1cc9b88890a6a5", "_type": "request", "parentId": "fld_de6535a082a319ef780523f7e7b5a1c4", "name": "Archivo pdf", "description": "La representación gráfica (`application/pdf`).\n\nDocumentación: https://platform.trevol.si/docs/api#downloadEquivalentDocumentAdjustmentPdf", "method": "GET", "url": "{{ _.baseUrl }}/equivalent_document_adjustments/posa_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/pdf", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 17000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_329837e5055414b0db76313d6f9ef351", "_type": "request", "parentId": "fld_de6535a082a319ef780523f7e7b5a1c4", "name": "Archivo xml", "description": "El XML firmado que se mandó a la DIAN (`application/xml`).\n\nDocumentación: https://platform.trevol.si/docs/api#downloadEquivalentDocumentAdjustmentXml", "method": "GET", "url": "{{ _.baseUrl }}/equivalent_document_adjustments/posa_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/xml", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 18000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_3749410dc6686a879aa3f24880a0b4e5", "_type": "request", "parentId": "fld_de6535a082a319ef780523f7e7b5a1c4", "name": "Archivo zip", "description": "El ZIP de entrega (`application/zip`).\n\nDocumentación: https://platform.trevol.si/docs/api#downloadEquivalentDocumentAdjustmentZip", "method": "GET", "url": "{{ _.baseUrl }}/equivalent_document_adjustments/posa_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/zip", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 19000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_3156726df121c3788a6136409c9324f9", "_type": "request", "parentId": "fld_de6535a082a319ef780523f7e7b5a1c4", "name": "Archivo dian_response", "description": "El `ApplicationResponse` con que la DIAN contestó (`application/xml`).\n\nDocumentación: https://platform.trevol.si/docs/api#downloadEquivalentDocumentAdjustmentDianResponse", "method": "GET", "url": "{{ _.baseUrl }}/equivalent_document_adjustments/posa_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/dian_response", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 20000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "fld_e164a7cf793473fd1e2437d289a18159", "_type": "request_group", "parentId": "wrk_047e9a3422cdb40adb17ae433ec58d6b", "name": "Nómina electrónica", "description": "Documento soporte de pago de nómina electrónica (102) y su nota de ajuste (103: Reemplazar o Eliminar). Un 102 por trabajador y por mes en producción (y en habilitación cuando la empresa ya pasó el set de pruebas). Sin PDF ni correo: `xml`, `zip` y `dian_response`. El trabajador solo sale al dueño de la llave.", "environment": {}, "environmentPropertyOrder": null, "metaSortKey": 8000 }, { "_id": "req_4620b7234847f7bf3135d663cd8516a4", "_type": "request", "parentId": "fld_e164a7cf793473fd1e2437d289a18159", "name": "Emitir una nómina electrónica", "description": "Emite el documento soporte de pago de **nómina electrónica** (102) de un trabajador para un periodo. Trevol valida todo el contrato (periodo, trabajador, devengados y deducciones) ANTES de reservar, calcula los totales, numera (prefijo de nómina de la empresa), firma y lo manda a la DIAN. **En producción hay un solo 102 por trabajador y por mes** (art. 1.5.3.2.2): otro es `409 duplicate_document` con `existing_id`; para cambiarlo usa `POST /v1/payroll_adjustments`. La empresa debe tener la nómina habilitada ante la DIAN (`company_not_enabled`, `payroll_not_enabled`): con una llave `live`, `habilitada`; con una `test`, también el set de pruebas (`GET /v1/company` → `capabilities.payroll`). En el set de pruebas de habilitación responde `202 validating` en las dos versiones y reintentar no lo reenvía. No hay PDF ni correo: `xml`, `zip` y `dian_response`. Se cobra por empleado. Los datos del trabajador solo salen al dueño de la llave: no van en los webhooks ni en el registro de peticiones, y la respuesta guardada para la idempotencia no los copia.\n\n**Respuestas.** `201` la DIAN lo validó (`status: accepted`). `202` solo en la versión 2026-10-22: la DIAN no contestó (`processing`), otra petición lo está enviando (`sending`) o, en habilitación, el set de pruebas todavía lo valida (`validating`, en las dos versiones); trae `Location` y `Retry-After`, y el resultado llega por GET y por webhook: **no crees otro documento para la misma operación**. `422` `validation_error` (se revisó a fondo ANTES de reservar: no se gastó el número, y `errors[]` dice el campo), `dian_rejected` (con `document` y las reglas traducidas; corrige con `PUT` y el mismo número), `company_not_enabled` o `numbering_unavailable` (con `reason`). `402` `insufficient_balance` (producción sin saldo: queda `pending` con su número). `409` `external_id_in_use` o `duplicate_document` (con `existing_id`). `503` `dian_unavailable` en la 2026-10-21. Pide `Idempotency-Key`: repetir la misma devuelve lo mismo sin enviar nada.\n\nIdempotency-Key: se genera una nueva en cada envío; para reintentar la MISMA llamada, fija una (p. ej. «VENTA-2026-000123»).\n\nDocumentación: https://platform.trevol.si/docs/api#createPayroll", "method": "POST", "url": "{{ _.baseUrl }}/payrolls", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Idempotency-Key", "value": "{% uuid 'v4' %}" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"NOM-2026-09-001\",\n \"period\": {\n \"hire_date\": \"2024-03-01\",\n \"start\": \"2026-09-01\",\n \"end\": \"2026-09-30\"\n },\n \"pay_period\": \"5\",\n \"notes\": [\n \"Nómina de septiembre de 2026\"\n ],\n \"employee\": {\n \"type\": \"01\",\n \"subtype\": \"00\",\n \"high_risk_pension\": false,\n \"document_type\": \"13\",\n \"document_number\": \"1000000101\",\n \"first_surname\": \"PRUEBA\",\n \"second_surname\": \"NOMINA01\",\n \"first_name\": \"TRABAJADOR\",\n \"other_names\": \"DE PRUEBA\",\n \"workplace\": {\n \"country\": \"CO\",\n \"municipality_code\": \"76001\",\n \"address\": \"Calle 1 # 1-1\"\n },\n \"integral_salary\": false,\n \"contract_type\": \"2\",\n \"salary\": \"1423500\",\n \"code\": \"TRAB-01\"\n },\n \"payment\": {\n \"form\": \"1\",\n \"method\": \"42\",\n \"bank\": \"Banco de Pruebas\",\n \"account_type\": \"Ahorros\",\n \"account_number\": \"0001234501\"\n },\n \"payment_dates\": [\n \"2026-09-30\"\n ],\n \"earnings\": {\n \"basic\": {\n \"days\": 30,\n \"amount\": \"1423500\"\n },\n \"transport\": [\n {\n \"allowance\": \"200000\"\n }\n ]\n },\n \"deductions\": {\n \"health\": {\n \"percent\": \"4\",\n \"amount\": \"56940\"\n },\n \"pension\": {\n \"percent\": \"4\",\n \"amount\": \"56940\"\n }\n }\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 1000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_7735acfa1956c16893df8f018eee0d82", "_type": "request", "parentId": "fld_e164a7cf793473fd1e2437d289a18159", "name": "Listar (nómina electrónica)", "description": "Paginación por cursor y filtros `status`, `external_id`, `created_from`, `created_to`, `employee_code` (el código interno del empleado) y `period_end_from` / `period_end_to`. **No se filtra por el documento del trabajador**: la cédula en la URL quedaría en los registros del servidor.\n\nDocumentación: https://platform.trevol.si/docs/api#listPayrolls", "method": "GET", "url": "{{ _.baseUrl }}/payrolls", "parameters": [ { "name": "limit", "value": "100" } ], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 2000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_e280d8e8c8a77f3356231bae791f3b0e", "_type": "request", "parentId": "fld_e164a7cf793473fd1e2437d289a18159", "name": "Calcular una nómina electrónica sin emitirla", "description": "Valida y calcula los totales de la nómina **sin** reservar un número ni enviar nada. No pide `Idempotency-Key` y no se cobra. El trabajador que mandaste vuelve en la respuesta; Trevol no lo guarda.\n\nDocumentación: https://platform.trevol.si/docs/api#previewPayroll", "method": "POST", "url": "{{ _.baseUrl }}/payrolls/preview", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"NOM-2026-09-001\",\n \"period\": {\n \"hire_date\": \"2024-03-01\",\n \"start\": \"2026-09-01\",\n \"end\": \"2026-09-30\"\n },\n \"pay_period\": \"5\",\n \"notes\": [\n \"Nómina de septiembre de 2026\"\n ],\n \"employee\": {\n \"type\": \"01\",\n \"subtype\": \"00\",\n \"high_risk_pension\": false,\n \"document_type\": \"13\",\n \"document_number\": \"1000000101\",\n \"first_surname\": \"PRUEBA\",\n \"second_surname\": \"NOMINA01\",\n \"first_name\": \"TRABAJADOR\",\n \"other_names\": \"DE PRUEBA\",\n \"workplace\": {\n \"country\": \"CO\",\n \"municipality_code\": \"76001\",\n \"address\": \"Calle 1 # 1-1\"\n },\n \"integral_salary\": false,\n \"contract_type\": \"2\",\n \"salary\": \"1423500\",\n \"code\": \"TRAB-01\"\n },\n \"payment\": {\n \"form\": \"1\",\n \"method\": \"42\",\n \"bank\": \"Banco de Pruebas\",\n \"account_type\": \"Ahorros\",\n \"account_number\": \"0001234501\"\n },\n \"payment_dates\": [\n \"2026-09-30\"\n ],\n \"earnings\": {\n \"basic\": {\n \"days\": 30,\n \"amount\": \"1423500\"\n },\n \"transport\": [\n {\n \"allowance\": \"200000\"\n }\n ]\n },\n \"deductions\": {\n \"health\": {\n \"percent\": \"4\",\n \"amount\": \"56940\"\n },\n \"pension\": {\n \"percent\": \"4\",\n \"amount\": \"56940\"\n }\n }\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 3000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_1f201854d39865feb2a1bbc02fe9aa5f", "_type": "request", "parentId": "fld_e164a7cf793473fd1e2437d289a18159", "name": "Una nómina electrónica", "description": "La nómina tal como se emitió, con el trabajador, los devengados, las deducciones y los totales (`earnings`, `deductions`, `net`).\n\nDocumentación: https://platform.trevol.si/docs/api#retrievePayroll", "method": "GET", "url": "{{ _.baseUrl }}/payrolls/pr_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 4000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_76c919d5a1a7dc725404a1a9d9892b7f", "_type": "request", "parentId": "fld_e164a7cf793473fd1e2437d289a18159", "name": "Corregir una nómina electrónica rechazada (mismo número) y reenviarla", "description": "Corrige una nómina rechazada con el **mismo número** y la vuelve a enviar. `409 invalid_state` si el set de pruebas la está validando.\n\nSolo si el documento está `rejected`, `error` o `pending`. Uno `accepted` no se corrige (se ajusta con una nota) y uno que la DIAN todavía verifica es `409 invalid_state`: espera el resultado. El `external_id` y la numeración no se cambian. Pide `Idempotency-Key`.\n\nIdempotency-Key: se genera una nueva en cada envío; para reintentar la MISMA llamada, fija una (p. ej. «VENTA-2026-000123»).\n\nDocumentación: https://platform.trevol.si/docs/api#correctPayroll", "method": "PUT", "url": "{{ _.baseUrl }}/payrolls/pr_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Idempotency-Key", "value": "{% uuid 'v4' %}" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"NOM-2026-09-001\",\n \"period\": {\n \"hire_date\": \"2024-03-01\",\n \"start\": \"2026-09-01\",\n \"end\": \"2026-09-30\"\n },\n \"pay_period\": \"5\",\n \"notes\": [\n \"Nómina de septiembre de 2026\"\n ],\n \"employee\": {\n \"type\": \"01\",\n \"subtype\": \"00\",\n \"high_risk_pension\": false,\n \"document_type\": \"13\",\n \"document_number\": \"1000000101\",\n \"first_surname\": \"PRUEBA\",\n \"second_surname\": \"NOMINA01\",\n \"first_name\": \"TRABAJADOR\",\n \"other_names\": \"DE PRUEBA\",\n \"workplace\": {\n \"country\": \"CO\",\n \"municipality_code\": \"76001\",\n \"address\": \"Calle 1 # 1-1\"\n },\n \"integral_salary\": false,\n \"contract_type\": \"2\",\n \"salary\": \"1423500\",\n \"code\": \"TRAB-01\"\n },\n \"payment\": {\n \"form\": \"1\",\n \"method\": \"42\",\n \"bank\": \"Banco de Pruebas\",\n \"account_type\": \"Ahorros\",\n \"account_number\": \"0001234501\"\n },\n \"payment_dates\": [\n \"2026-09-30\"\n ],\n \"earnings\": {\n \"basic\": {\n \"days\": 30,\n \"amount\": \"1423500\"\n },\n \"transport\": [\n {\n \"allowance\": \"200000\"\n }\n ]\n },\n \"deductions\": {\n \"health\": {\n \"percent\": \"4\",\n \"amount\": \"56940\"\n },\n \"pension\": {\n \"percent\": \"4\",\n \"amount\": \"56940\"\n }\n }\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 5000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_14b16a18dd9e00fa346f3da57b849da7", "_type": "request", "parentId": "fld_e164a7cf793473fd1e2437d289a18159", "name": "Reenviar una pendiente o en error", "description": "Vuelve a enviar una nómina `pending` o `error`. Si el set de pruebas la valida (`validating`), solo consulta.\n\nSin cuerpo. Con un documento `accepted` responde `200` con el documento tal cual; con uno que la DIAN todavía verifica no reenvía nada (`202`); con uno `rejected` es `409 invalid_state` (se corrige con `PUT`). No pide `Idempotency-Key` (reintentarlo es seguro).\n\nDocumentación: https://platform.trevol.si/docs/api#sendPayroll", "method": "POST", "url": "{{ _.baseUrl }}/payrolls/pr_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/send", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 6000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_681defb5a48d55598afda97d14fdcd1b", "_type": "request", "parentId": "fld_e164a7cf793473fd1e2437d289a18159", "name": "Archivo xml", "description": "El XML firmado que se mandó a la DIAN (`application/xml`).\n\nDocumentación: https://platform.trevol.si/docs/api#downloadPayrollXml", "method": "GET", "url": "{{ _.baseUrl }}/payrolls/pr_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/xml", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 7000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_1bc6dffe8d6345e22d69fa31460ff794", "_type": "request", "parentId": "fld_e164a7cf793473fd1e2437d289a18159", "name": "Archivo zip", "description": "El ZIP del documento (`application/zip`).\n\nDocumentación: https://platform.trevol.si/docs/api#downloadPayrollZip", "method": "GET", "url": "{{ _.baseUrl }}/payrolls/pr_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/zip", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 8000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_fc3041fcacea7921318e2cfa53e5811d", "_type": "request", "parentId": "fld_e164a7cf793473fd1e2437d289a18159", "name": "Archivo dian_response", "description": "El `ApplicationResponse` con que la DIAN contestó (`application/xml`), si la DIAN lo devolvió.\n\nDocumentación: https://platform.trevol.si/docs/api#downloadPayrollDianResponse", "method": "GET", "url": "{{ _.baseUrl }}/payrolls/pr_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/dian_response", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 9000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_63e89666b5ad7e2a9341dad29c1d8295", "_type": "request", "parentId": "fld_e164a7cf793473fd1e2437d289a18159", "name": "Emitir una nota de ajuste de nómina", "description": "Emite la **nota de ajuste de nómina electrónica** (103). `type: \"replace\"` (Reemplazar) lleva la nómina completa corregida; `type: \"delete\"` (Eliminar) solo el predecesor y las notas. El `predecessor` es una nómina de Trevol (`pr_…` o `pra_…`, validada) o una de otra plataforma (`number`, `cune`, `issue_date`); es de la misma empresa y ambiente de la llave, del mismo trabajador, y el último de su cadena. Una nómina eliminada no se ajusta.\n\n**Respuestas.** `201` la DIAN lo validó (`status: accepted`). `202` solo en la versión 2026-10-22: la DIAN no contestó (`processing`), otra petición lo está enviando (`sending`) o, en habilitación, el set de pruebas todavía lo valida (`validating`, en las dos versiones); trae `Location` y `Retry-After`, y el resultado llega por GET y por webhook: **no crees otro documento para la misma operación**. `422` `validation_error` (se revisó a fondo ANTES de reservar: no se gastó el número, y `errors[]` dice el campo), `dian_rejected` (con `document` y las reglas traducidas; corrige con `PUT` y el mismo número), `company_not_enabled` o `numbering_unavailable` (con `reason`). `402` `insufficient_balance` (producción sin saldo: queda `pending` con su número). `409` `external_id_in_use` o `duplicate_document` (con `existing_id`). `503` `dian_unavailable` en la 2026-10-21. Pide `Idempotency-Key`: repetir la misma devuelve lo mismo sin enviar nada.\n\nIdempotency-Key: se genera una nueva en cada envío; para reintentar la MISMA llamada, fija una (p. ej. «VENTA-2026-000123»).\n\nOtros ejemplos de cuerpo en la documentación: reemplazar, eliminar.\n\nDocumentación: https://platform.trevol.si/docs/api#createPayrollAdjustment", "method": "POST", "url": "{{ _.baseUrl }}/payroll_adjustments", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Idempotency-Key", "value": "{% uuid 'v4' %}" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"NOM-2026-09-001-R\",\n \"period\": {\n \"hire_date\": \"2024-03-01\",\n \"start\": \"2026-09-01\",\n \"end\": \"2026-09-30\"\n },\n \"pay_period\": \"5\",\n \"notes\": [\n \"Nómina de septiembre de 2026\"\n ],\n \"employee\": {\n \"type\": \"01\",\n \"subtype\": \"00\",\n \"high_risk_pension\": false,\n \"document_type\": \"13\",\n \"document_number\": \"1000000101\",\n \"first_surname\": \"PRUEBA\",\n \"second_surname\": \"NOMINA01\",\n \"first_name\": \"TRABAJADOR\",\n \"other_names\": \"DE PRUEBA\",\n \"workplace\": {\n \"country\": \"CO\",\n \"municipality_code\": \"76001\",\n \"address\": \"Calle 1 # 1-1\"\n },\n \"integral_salary\": false,\n \"contract_type\": \"2\",\n \"salary\": \"1423500\",\n \"code\": \"TRAB-01\"\n },\n \"payment\": {\n \"form\": \"1\",\n \"method\": \"42\",\n \"bank\": \"Banco de Pruebas\",\n \"account_type\": \"Ahorros\",\n \"account_number\": \"0001234501\"\n },\n \"payment_dates\": [\n \"2026-09-30\"\n ],\n \"earnings\": {\n \"basic\": {\n \"days\": 30,\n \"amount\": \"1423500\"\n },\n \"transport\": [\n {\n \"allowance\": \"210000\"\n }\n ]\n },\n \"deductions\": {\n \"health\": {\n \"percent\": \"4\",\n \"amount\": \"56940\"\n },\n \"pension\": {\n \"percent\": \"4\",\n \"amount\": \"56940\"\n }\n },\n \"type\": \"replace\",\n \"predecessor\": {\n \"id\": \"pr_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b\"\n }\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 10000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_794b869956e96754adbfd11f8c4998aa", "_type": "request", "parentId": "fld_e164a7cf793473fd1e2437d289a18159", "name": "Listar (nota de ajuste de nómina)", "description": "Paginación por cursor y los mismos filtros de `GET /v1/payrolls` (sin documento del trabajador).\n\nDocumentación: https://platform.trevol.si/docs/api#listPayrollAdjustments", "method": "GET", "url": "{{ _.baseUrl }}/payroll_adjustments", "parameters": [ { "name": "limit", "value": "100" } ], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 11000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_f1dddaebe5a971f3316eda1e8e229494", "_type": "request", "parentId": "fld_e164a7cf793473fd1e2437d289a18159", "name": "Calcular una nota de ajuste de nómina sin emitirla", "description": "Valida y calcula la nota de ajuste **sin** reservar un número ni enviar nada.\n\nOtros ejemplos de cuerpo en la documentación: reemplazar, eliminar.\n\nDocumentación: https://platform.trevol.si/docs/api#previewPayrollAdjustment", "method": "POST", "url": "{{ _.baseUrl }}/payroll_adjustments/preview", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"NOM-2026-09-001-R\",\n \"period\": {\n \"hire_date\": \"2024-03-01\",\n \"start\": \"2026-09-01\",\n \"end\": \"2026-09-30\"\n },\n \"pay_period\": \"5\",\n \"notes\": [\n \"Nómina de septiembre de 2026\"\n ],\n \"employee\": {\n \"type\": \"01\",\n \"subtype\": \"00\",\n \"high_risk_pension\": false,\n \"document_type\": \"13\",\n \"document_number\": \"1000000101\",\n \"first_surname\": \"PRUEBA\",\n \"second_surname\": \"NOMINA01\",\n \"first_name\": \"TRABAJADOR\",\n \"other_names\": \"DE PRUEBA\",\n \"workplace\": {\n \"country\": \"CO\",\n \"municipality_code\": \"76001\",\n \"address\": \"Calle 1 # 1-1\"\n },\n \"integral_salary\": false,\n \"contract_type\": \"2\",\n \"salary\": \"1423500\",\n \"code\": \"TRAB-01\"\n },\n \"payment\": {\n \"form\": \"1\",\n \"method\": \"42\",\n \"bank\": \"Banco de Pruebas\",\n \"account_type\": \"Ahorros\",\n \"account_number\": \"0001234501\"\n },\n \"payment_dates\": [\n \"2026-09-30\"\n ],\n \"earnings\": {\n \"basic\": {\n \"days\": 30,\n \"amount\": \"1423500\"\n },\n \"transport\": [\n {\n \"allowance\": \"210000\"\n }\n ]\n },\n \"deductions\": {\n \"health\": {\n \"percent\": \"4\",\n \"amount\": \"56940\"\n },\n \"pension\": {\n \"percent\": \"4\",\n \"amount\": \"56940\"\n }\n },\n \"type\": \"replace\",\n \"predecessor\": {\n \"id\": \"pr_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b\"\n }\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 12000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_d58739926d42d550525743812004bf41", "_type": "request", "parentId": "fld_e164a7cf793473fd1e2437d289a18159", "name": "Una nota de ajuste de nómina", "description": "La nota de ajuste, con `type` y `predecessor` (con el prefijo de la clase de su predecesor). El Eliminar no trae trabajador, devengados ni deducciones.\n\nDocumentación: https://platform.trevol.si/docs/api#retrievePayrollAdjustment", "method": "GET", "url": "{{ _.baseUrl }}/payroll_adjustments/pra_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 13000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_50ff2c58abbf24627e0852b75b5612af", "_type": "request", "parentId": "fld_e164a7cf793473fd1e2437d289a18159", "name": "Corregir una nota de ajuste de nómina rechazada (mismo número) y reenviarla", "description": "Corrige una nota de ajuste rechazada con el **mismo número** y la vuelve a enviar.\n\nSolo si el documento está `rejected`, `error` o `pending`. Uno `accepted` no se corrige (se ajusta con una nota) y uno que la DIAN todavía verifica es `409 invalid_state`: espera el resultado. El `external_id` y la numeración no se cambian. Pide `Idempotency-Key`.\n\nIdempotency-Key: se genera una nueva en cada envío; para reintentar la MISMA llamada, fija una (p. ej. «VENTA-2026-000123»).\n\nOtros ejemplos de cuerpo en la documentación: reemplazar, eliminar.\n\nDocumentación: https://platform.trevol.si/docs/api#correctPayrollAdjustment", "method": "PUT", "url": "{{ _.baseUrl }}/payroll_adjustments/pra_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Idempotency-Key", "value": "{% uuid 'v4' %}" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"NOM-2026-09-001-R\",\n \"period\": {\n \"hire_date\": \"2024-03-01\",\n \"start\": \"2026-09-01\",\n \"end\": \"2026-09-30\"\n },\n \"pay_period\": \"5\",\n \"notes\": [\n \"Nómina de septiembre de 2026\"\n ],\n \"employee\": {\n \"type\": \"01\",\n \"subtype\": \"00\",\n \"high_risk_pension\": false,\n \"document_type\": \"13\",\n \"document_number\": \"1000000101\",\n \"first_surname\": \"PRUEBA\",\n \"second_surname\": \"NOMINA01\",\n \"first_name\": \"TRABAJADOR\",\n \"other_names\": \"DE PRUEBA\",\n \"workplace\": {\n \"country\": \"CO\",\n \"municipality_code\": \"76001\",\n \"address\": \"Calle 1 # 1-1\"\n },\n \"integral_salary\": false,\n \"contract_type\": \"2\",\n \"salary\": \"1423500\",\n \"code\": \"TRAB-01\"\n },\n \"payment\": {\n \"form\": \"1\",\n \"method\": \"42\",\n \"bank\": \"Banco de Pruebas\",\n \"account_type\": \"Ahorros\",\n \"account_number\": \"0001234501\"\n },\n \"payment_dates\": [\n \"2026-09-30\"\n ],\n \"earnings\": {\n \"basic\": {\n \"days\": 30,\n \"amount\": \"1423500\"\n },\n \"transport\": [\n {\n \"allowance\": \"210000\"\n }\n ]\n },\n \"deductions\": {\n \"health\": {\n \"percent\": \"4\",\n \"amount\": \"56940\"\n },\n \"pension\": {\n \"percent\": \"4\",\n \"amount\": \"56940\"\n }\n },\n \"type\": \"replace\",\n \"predecessor\": {\n \"id\": \"pr_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b\"\n }\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 14000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_5015507153ed211d82556be45b02c2cb", "_type": "request", "parentId": "fld_e164a7cf793473fd1e2437d289a18159", "name": "Reenviar una pendiente o en error", "description": "Vuelve a enviar una nota de ajuste `pending` o `error`.\n\nSin cuerpo. Con un documento `accepted` responde `200` con el documento tal cual; con uno que la DIAN todavía verifica no reenvía nada (`202`); con uno `rejected` es `409 invalid_state` (se corrige con `PUT`). No pide `Idempotency-Key` (reintentarlo es seguro).\n\nDocumentación: https://platform.trevol.si/docs/api#sendPayrollAdjustment", "method": "POST", "url": "{{ _.baseUrl }}/payroll_adjustments/pra_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/send", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 15000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_6378b2402f4e4ce7e1a4925350259882", "_type": "request", "parentId": "fld_e164a7cf793473fd1e2437d289a18159", "name": "Archivo xml", "description": "El XML firmado que se mandó a la DIAN (`application/xml`).\n\nDocumentación: https://platform.trevol.si/docs/api#downloadPayrollAdjustmentXml", "method": "GET", "url": "{{ _.baseUrl }}/payroll_adjustments/pra_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/xml", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 16000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_037d0f8b37b9d190c5e6d5fa60ce30f3", "_type": "request", "parentId": "fld_e164a7cf793473fd1e2437d289a18159", "name": "Archivo zip", "description": "El ZIP del documento (`application/zip`).\n\nDocumentación: https://platform.trevol.si/docs/api#downloadPayrollAdjustmentZip", "method": "GET", "url": "{{ _.baseUrl }}/payroll_adjustments/pra_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/zip", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 17000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_98860d1a709dd1dfdcc652803906ad12", "_type": "request", "parentId": "fld_e164a7cf793473fd1e2437d289a18159", "name": "Archivo dian_response", "description": "El `ApplicationResponse` con que la DIAN contestó (`application/xml`), si la DIAN lo devolvió.\n\nDocumentación: https://platform.trevol.si/docs/api#downloadPayrollAdjustmentDianResponse", "method": "GET", "url": "{{ _.baseUrl }}/payroll_adjustments/pra_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/dian_response", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 18000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "fld_d2c1fba7d769c50d7ecbc286423e4ed7", "_type": "request_group", "parentId": "wrk_047e9a3422cdb40adb17ae433ec58d6b", "name": "Eventos RADIAN", "description": "Eventos sobre facturas: el acuse (030), el reclamo (031), el recibo del bien (032) y la aceptación expresa (033) de una factura RECIBIDA, y la aceptación tácita (034) de una factura PROPIA a crédito. Un rechazo es final: el siguiente intento es otro evento. Solo `xml`. Los eventos 035 a 051 necesitan un participante RADIAN y no están disponibles.", "environment": {}, "environmentPropertyOrder": null, "metaSortKey": 9000 }, { "_id": "req_f24dc3bb419957e74d4a27f2047f4b8c", "_type": "request", "parentId": "fld_d2c1fba7d769c50d7ecbc286423e4ed7", "name": "Emitir un evento RADIAN", "description": "Envía un **evento RADIAN** sobre una factura: el acuse de recibo (030), el reclamo (031), el recibo del bien o servicio (032) y la aceptación expresa (033) de una factura RECIBIDA (`invoice`), o la aceptación tácita (034) de una factura PROPIA a crédito: de Trevol (`invoice_id`) o emitida antes con otro software y traída por la sincronización con la DIAN (`invoice: {cufe, number?}`; exactamente uno de los dos). Los eventos 035 a 051 necesitan un participante RADIAN y no están disponibles. El 030 y el 032 necesitan el representante legal de la empresa (lo firma): se configura en la app. **Un rechazo es final**: el siguiente intento es otro evento, con otro número (`POST` nuevo). Un evento vivo del mismo código sobre la misma factura es `409 duplicate_document` con `existing_id`: reintenta ese con `POST …/send`. `already_registered: true` (con `201`) solo significa que la DIAN ya mostraba el CUDE de ESTE evento; si la factura ya tenía ese evento por otro camino es `422 dian_rejected` con `already_registered_elsewhere: true`. La DIAN pide el evento anterior antes del siguiente: en la 2026-10-21 es `409 previous_event_pending`; en la 2026-10-22, `202 processing` y Trevol lo manda cuando aparezca. Si la DIAN contesta 98 («en proceso de validación») es `202 validating`: no reenvíes. Para saber si el 034 procede antes de pedirlo, usa `GET /v1/invoices/{id}/tacit_acceptance` (o, por CUFE, `GET /v1/radian_events/tacit_acceptance?cufe=…`).\n\n**Respuestas.** `201` la DIAN lo validó (`status: accepted`). `202` solo en la versión 2026-10-22: la DIAN no contestó (`processing`), otra petición lo está enviando (`sending`) o, en habilitación, el set de pruebas todavía lo valida (`validating`, en las dos versiones); trae `Location` y `Retry-After`, y el resultado llega por GET y por webhook: **no crees otro documento para la misma operación**. `422` `validation_error` (se revisó a fondo ANTES de reservar: no se gastó el número, y `errors[]` dice el campo), `dian_rejected` (con `document` y las reglas traducidas; un rechazo es final: el siguiente intento es otro `POST`, con otro número), `company_not_enabled` o `numbering_unavailable` (con `reason`). `402` `insufficient_balance` (producción sin saldo: queda `pending` con su número). `409` `external_id_in_use` o `duplicate_document` (con `existing_id`). `503` `dian_unavailable` en la 2026-10-21. Pide `Idempotency-Key`: repetir la misma devuelve lo mismo sin enviar nada.\n\nIdempotency-Key: se genera una nueva en cada envío; para reintentar la MISMA llamada, fija una (p. ej. «VENTA-2026-000123»).\n\nOtros ejemplos de cuerpo en la documentación: acuse, reclamo, tacita, tacita_cufe.\n\nDocumentación: https://platform.trevol.si/docs/api#createRadianEvent", "method": "POST", "url": "{{ _.baseUrl }}/radian_events", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Idempotency-Key", "value": "{% uuid 'v4' %}" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"external_id\": \"ERP-ACUSE-OJ1234\",\n \"event_code\": \"030\",\n \"invoice\": {\n \"cufe\": \"cdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcd\",\n \"number\": \"OJ1234\",\n \"type\": \"01\",\n \"issuer\": {\n \"nit\": \"890330031\",\n \"check_digit\": 3,\n \"document_type\": \"31\",\n \"name\": \"OSPINA Y ASOCIADOS SAS\"\n }\n }\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 1000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_7c0da732780e222beb6fe98ea8450ebc", "_type": "request", "parentId": "fld_d2c1fba7d769c50d7ecbc286423e4ed7", "name": "Listar (evento RADIAN)", "description": "Paginación por cursor y filtros `status`, `external_id`, `created_from`, `created_to`, `event_code` y `invoice_cufe` (el CUFE de la factura).\n\nDocumentación: https://platform.trevol.si/docs/api#listRadianEvents", "method": "GET", "url": "{{ _.baseUrl }}/radian_events", "parameters": [ { "name": "limit", "value": "100" } ], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 2000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_66ba8c170b6b11c9b06ab2083ee45857", "_type": "request", "parentId": "fld_d2c1fba7d769c50d7ecbc286423e4ed7", "name": "Un evento radian", "description": "El evento tal como se envió, con su número, su CUDE, la factura y la respuesta de la DIAN. `already_registered`, `already_registered_elsewhere` y `tacit` se deducen de lo guardado.\n\nDocumentación: https://platform.trevol.si/docs/api#retrieveRadianEvent", "method": "GET", "url": "{{ _.baseUrl }}/radian_events/rev_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 3000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_d695d59a0218a01cc7b49158f12d9f04", "_type": "request", "parentId": "fld_d2c1fba7d769c50d7ecbc286423e4ed7", "name": "Reenviar una pendiente o en error", "description": "Vuelve a enviar un evento `pending` o `error` con el **mismo número** (por ejemplo, un 034 que todavía no procedía o un 031 que esperaba al evento anterior). Un evento que la DIAN verifica (`validating`) solo consulta; uno `rejected` es final (`409 invalid_state`): crea otro con `POST`.\n\nSin cuerpo. Con un documento `accepted` responde `200` con el documento tal cual; con uno que la DIAN todavía verifica no reenvía nada (`202`); con uno `rejected` es `409 invalid_state` (se corrige con `PUT`). No pide `Idempotency-Key` (reintentarlo es seguro).\n\nDocumentación: https://platform.trevol.si/docs/api#sendRadianEvent", "method": "POST", "url": "{{ _.baseUrl }}/radian_events/rev_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/send", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 4000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_44bb21b78f6a78041917c97d1b4210d6", "_type": "request", "parentId": "fld_d2c1fba7d769c50d7ecbc286423e4ed7", "name": "Archivo xml", "description": "El ApplicationResponse firmado que se mandó a la DIAN (`application/xml`). Los eventos no tienen PDF, ZIP ni `dian_response`.\n\nDocumentación: https://platform.trevol.si/docs/api#downloadRadianEventXml", "method": "GET", "url": "{{ _.baseUrl }}/radian_events/rev_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/xml", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 5000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_d67cd4c7e9c1e0a14b185a9e85bcde7a", "_type": "request", "parentId": "fld_d2c1fba7d769c50d7ecbc286423e4ed7", "name": "¿Procede ya la aceptación tácita (034) de esta factura? (por CUFE)", "description": "Lo mismo que `GET /v1/invoices/{id}/tacit_acceptance`, pero por el CUFE de la factura propia: sirve también para las facturas que no se emitieron con Trevol (emitidas antes, con otro software, y traídas por la sincronización con la DIAN; la sincronización trae las de producción). Consulta GetStatusEvent y aplica la regla de los 3 días hábiles; no envía nada. `invoice_id` solo sale si la factura es de Trevol. 404 si el CUFE no es de una factura propia de la empresa y el ambiente de la llave; 422 si falta `cufe` o la factura no admite el 034 (de contado, una nota, a consumidor final, sin el XML leído por la sincronización…); 429 con más de 30 consultas por minuto por llave (el mismo límite de la otra consulta); 503 si la DIAN no contesta (reintentable).\n\nDocumentación: https://platform.trevol.si/docs/api#retrieveTacitAcceptanceByCufe", "method": "GET", "url": "{{ _.baseUrl }}/radian_events/tacit_acceptance", "parameters": [ { "name": "cufe", "value": "abababababababababababababababababababababababababababababababababababababababababababababababab" } ], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 6000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "fld_3fba881681dd528b1c4ecb119fd3aac4", "_type": "request_group", "parentId": "wrk_047e9a3422cdb40adb17ae433ec58d6b", "name": "Webhooks", "description": "Endpoints que reciben avisos firmados (Standard Webhooks) cuando un documento cambia.", "environment": {}, "environmentPropertyOrder": null, "metaSortKey": 10000 }, { "_id": "req_54dc2debd88593df51a4f7e83b746188", "_type": "request", "parentId": "fld_3fba881681dd528b1c4ecb119fd3aac4", "name": "Los endpoints de webhooks de la empresa y el ambiente", "description": "Los de la empresa y el ambiente de la llave (máximo 5). Las llaves de lectura ven el esquema y el host de la `url`, con el camino enmascarado («https://tu-servidor.co/…»): a veces es un secreto. Las de escritura la ven completa.\n\nDocumentación: https://platform.trevol.si/docs/api#listWebhookEndpoints", "method": "GET", "url": "{{ _.baseUrl }}/webhook_endpoints", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 1000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_ae5112b96db1781cf07882f662b0a63a", "_type": "request", "parentId": "fld_3fba881681dd528b1c4ecb119fd3aac4", "name": "Crear un endpoint de webhooks (máximo 5 por empresa y ambiente)", "description": "El `secret` (whsec_…) viene SOLO en esta respuesta. Cada entrega lleva `webhook-id` (el mismo en cada reintento: deduplica con él), `webhook-timestamp` y `webhook-signature`: `v1,` + base64(HMAC-SHA256(clave, `{webhook-id}.{webhook-timestamp}.{cuerpo}`)), con la clave de los 32 bytes que siguen a `whsec_`. No usa Idempotency-Key: la respuesta lleva el secreto y no se guarda.\n\nDocumentación: https://platform.trevol.si/docs/api#createWebhookEndpoint", "method": "POST", "url": "{{ _.baseUrl }}/webhook_endpoints", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"url\": \"https://tu-servidor.co/webhooks/trevol\",\n \"description\": \"Producción: facturación\",\n \"events\": [\n \"invoice.accepted\",\n \"invoice.rejected\",\n \"credit_note.accepted\"\n ]\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 2000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_348b1d6bdb08349e26169c2a7b4f92fd", "_type": "request", "parentId": "fld_3fba881681dd528b1c4ecb119fd3aac4", "name": "Un endpoint", "description": "El endpoint (nunca el secreto: solo se muestra al crear o rotar). Un id de otra empresa o de otro ambiente es 404.\n\nDocumentación: https://platform.trevol.si/docs/api#retrieveWebhookEndpoint", "method": "GET", "url": "{{ _.baseUrl }}/webhook_endpoints/we_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 3000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_10cdb28a7e6e38db7c72ae02840c1aba", "_type": "request", "parentId": "fld_3fba881681dd528b1c4ecb119fd3aac4", "name": "Cambiar la URL, la descripción, los eventos o pausar y reactivar", "description": "Solo cambia lo que mandes. `status: paused` cancela las entregas pendientes; `status: enabled` reactiva el endpoint (también uno que Trevol desactivó por fallos sostenidos) y pone en cero el contador de fallos. `disabled` no se puede pedir.\n\nDocumentación: https://platform.trevol.si/docs/api#updateWebhookEndpoint", "method": "PATCH", "url": "{{ _.baseUrl }}/webhook_endpoints/we_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"description\": \"Pausado mientras migramos el servidor\",\n \"status\": \"paused\"\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 4000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_3f066dfe90eda0875ca86d7c3fb6da84", "_type": "request", "parentId": "fld_3fba881681dd528b1c4ecb119fd3aac4", "name": "Borrar el endpoint (con sus entregas)", "description": "Tu servidor deja de recibir avisos de inmediato. No se puede deshacer; si solo quieres detenerlo un rato, pausa el endpoint.\n\nDocumentación: https://platform.trevol.si/docs/api#deleteWebhookEndpoint", "method": "DELETE", "url": "{{ _.baseUrl }}/webhook_endpoints/we_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 5000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_5b879c3db344eb6b289ffe9a3e17e4b2", "_type": "request", "parentId": "fld_3fba881681dd528b1c4ecb119fd3aac4", "name": "Rotar el secreto", "description": "El `secret` (whsec_…) viene SOLO en esta respuesta. Cada entrega lleva `webhook-id` (el mismo en cada reintento: deduplica con él), `webhook-timestamp` y `webhook-signature`: `v1,` + base64(HMAC-SHA256(clave, `{webhook-id}.{webhook-timestamp}.{cuerpo}`)), con la clave de los 32 bytes que siguen a `whsec_`. El secreto anterior sigue firmando `grace_period_hours` (0 a 72; 24 por defecto): durante la gracia cada entrega lleva las dos firmas, separadas por un espacio.\n\nDocumentación: https://platform.trevol.si/docs/api#rotateWebhookEndpointSecret", "method": "POST", "url": "{{ _.baseUrl }}/webhook_endpoints/we_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/rotate_secret", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"grace_period_hours\": 24\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 6000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_a2e245d924a10ac23f3b05f8d124f316", "_type": "request", "parentId": "fld_3fba881681dd528b1c4ecb119fd3aac4", "name": "Mandar un evento `webhook.test` solo a este endpoint (debe estar activo)", "description": "Encola una entrega manual de prueba (3 intentos) y despierta el envío: en segundos llega a tu servidor con la firma de siempre. Hasta 60 por hora. Mira cómo salió en …/deliveries.\n\nDocumentación: https://platform.trevol.si/docs/api#testWebhookEndpoint", "method": "POST", "url": "{{ _.baseUrl }}/webhook_endpoints/we_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/test", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 7000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_d41d36cc17165a938976f182d8f02d74", "_type": "request", "parentId": "fld_3fba881681dd528b1c4ecb119fd3aac4", "name": "Las entregas de este endpoint, de la más nueva a la más vieja", "description": "Cada intento con su estado HTTP, su error (`timeout`, `http_5xx`, `blocked_address`…) y su duración. Nunca guardamos la respuesta de tu servidor. Se conservan 30 días.\n\nDocumentación: https://platform.trevol.si/docs/api#listWebhookEndpointDeliveries", "method": "GET", "url": "{{ _.baseUrl }}/webhook_endpoints/we_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/deliveries", "parameters": [ { "name": "limit", "value": "100" } ], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 8000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "fld_6462abf303f76942414138b15640e704", "_type": "request_group", "parentId": "wrk_047e9a3422cdb40adb17ae433ec58d6b", "name": "Eventos", "description": "Los eventos que Trevol manda a tus webhooks, guardados 30 días, y su reenvío.", "environment": {}, "environmentPropertyOrder": null, "metaSortKey": 11000 }, { "_id": "req_5778268922f66327122d7f0b0ff94218", "_type": "request", "parentId": "fld_6462abf303f76942414138b15640e704", "name": "Los eventos de 30 días de la empresa y el ambiente", "description": "Solo se guardan eventos si la empresa tiene al menos un endpoint en este ambiente. Útil para recuperar lo que se perdió mientras tu servidor estaba caído.\n\nDocumentación: https://platform.trevol.si/docs/api#listEvents", "method": "GET", "url": "{{ _.baseUrl }}/events", "parameters": [ { "name": "limit", "value": "100" } ], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 1000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_816bf691bdee7ac6ae2432aac27f2c9b", "_type": "request", "parentId": "fld_6462abf303f76942414138b15640e704", "name": "Un evento", "description": "El evento tal como se mandó al endpoint.\n\nDocumentación: https://platform.trevol.si/docs/api#retrieveEvent", "method": "GET", "url": "{{ _.baseUrl }}/events/evt_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 2000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "req_5b0d378d8c2c977812fcc552e2f25f12", "_type": "request", "parentId": "fld_6462abf303f76942414138b15640e704", "name": "Reenviar un evento a un endpoint (entrega manual nueva; el `webhook-id` es el mismo)", "description": "Vuelve a mandar el evento a un endpoint activo de la misma empresa y el mismo ambiente. Lleva el mismo `webhook-id`: si tu servidor ya lo procesó, deduplica con él. Hasta 60 por hora.\n\nDocumentación: https://platform.trevol.si/docs/api#resendEvent", "method": "POST", "url": "{{ _.baseUrl }}/events/evt_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/resend", "parameters": [], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" }, { "name": "Content-Type", "value": "application/json" } ], "body": { "mimeType": "application/json", "text": "{\n \"endpoint_id\": \"we_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b\"\n}" }, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 3000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" }, { "_id": "fld_2ee6bb999bd0c9eee230512879778d46", "_type": "request_group", "parentId": "wrk_047e9a3422cdb40adb17ae433ec58d6b", "name": "Registro de peticiones", "description": "Qué pidió tu software a la API, cómo le fue y cuánto tardó (30 días, sin cuerpos).", "environment": {}, "environmentPropertyOrder": null, "metaSortKey": 12000 }, { "_id": "req_8ccc9e8e9fe4dd5a891e8189ebe6ec95", "_type": "request", "parentId": "fld_2ee6bb999bd0c9eee230512879778d46", "name": "El registro de peticiones de la empresa y el ambiente de la llave (30 días)", "description": "Cada petición que pasó la autenticación de una llave, aunque terminara en 403, 422 o 429. Sin cuerpos, consultas, IP ni llaves; `path` es la plantilla.\n\nDocumentación: https://platform.trevol.si/docs/api#listRequests", "method": "GET", "url": "{{ _.baseUrl }}/requests", "parameters": [ { "name": "limit", "value": "100" } ], "headers": [ { "name": "Trevol-Version", "value": "2026-10-22" } ], "body": {}, "authentication": { "type": "bearer", "token": "{{ _.TREVOL_API_KEY }}" }, "metaSortKey": 1000, "settingStoreCookies": true, "settingSendCookies": true, "settingFollowRedirects": "global" } ] }