{ "info": { "_postman_id": "3c40b720-2c0f-4e07-aadf-dbcbb3106877", "name": "ApiDianV2.1", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "item": [ { "name": "01 - Configuraciones Basicas", "item": [ { "name": "01A - Documentos Equivalentes", "item": [ { "name": "Paso 1 - Config-Software Documentos Equivalentes", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "cache-control", "value": "no-cache", "type": "text" }, { "key": "Connection", "value": "keep-alive", "type": "text" }, { "key": "Accept-Encoding", "value": "gzip, deflate", "type": "text" }, { "key": "Host", "value": "localhost", "type": "text", "disabled": true }, { "key": "accept", "value": "application/json", "type": "text" }, { "key": "X-CSRF-TOKEN", "value": "", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"ideqdocs\": \"478be703-d445-4729-86db-9d5a7308f6f4\",\r\n\t\"pineqdocs\": 12345\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/config/softwareeqdocs", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "config", "softwareeqdocs" ] }, "description": "# PASO 1 - CONFIGURAR SOFTWARE PARA DOCUMENTOS EQUIVALENTES\r\n\r\n## 📋 Descripcion General\r\n\r\nRegistra y configura el software de facturacion electronica destinado **exclusivamente a la emision de Documentos Equivalentes (EqDocs)** ante la DIAN. Este es el primer paso obligatorio.\r\n\r\n**Endpoint:** `PUT /api/ubl2.1/config/softwareeqdocs`\r\n\r\n---\r\n\r\n## 📤 Cuerpo de la Peticion\r\n\r\n| Campo | Tipo | Obligatorio | Descripcion |\r\n|-------|------|-------------|-------------|\r\n| **ideqdocs** | string (UUID) | ✅ Si | UUID del software registrado en DIAN para Documentos Equivalentes |\r\n| **pineqdocs** | integer | ✅ Si | PIN de 5 digitos proporcionado por DIAN |\r\n\r\n**Ejemplo:**\r\n```json\r\n{\r\n \"ideqdocs\": \"478be703-d445-4729-86db-9d5a7308f6f4\",\r\n \"pineqdocs\": 12345\r\n}\r\n```\r\n\r\n---\r\n\r\n## ✅ Respuesta Exitosa\r\n\r\nLa respuesta contiene confirmacion del registro:\r\n\r\n```json\r\n{\r\n \"success\": true,\r\n \"message\": \"Software Documentos Equivalentes configurado exitosamente\"\r\n}\r\n```\r\n\r\n---\r\n\r\n## 📌 Notas Importantes\r\n\r\n- ✓ UUID DIAN: Identificador unico del software\r\n- ✓ PIN: Debe coincidir exactamente con lo registrado en DIAN\r\n- ✓ Requerido: Antes de configurar resoluciones\r\n- ⚠️ No se puede cambiar una vez registrado sin limpiar configuracion" }, "response": [] }, { "name": "Paso 2 - Config-Resolution POS Documentos Equivalentes", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"type_document_id\": 15,\r\n\t\"prefix\": \"EPOS\",\r\n\t\"resolution\": \"18760000001\",\r\n\t\"resolution_date\": \"2019-01-19\",\r\n\t\"from\": 1,\r\n\t\"to\": 1000000,\r\n\t\"generated_to_date\": 0,\r\n\t\"date_from\": \"2019-01-19\",\r\n\t\"date_to\": \"2030-01-19\"\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/config/resolution", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "config", "resolution" ] }, "description": "# PASO 2 - CONFIGURAR RESOLUCION POS (EQUIVALENTES)\r\n\r\n## 📋 Descripcion General\r\n\r\nConfigura la **numeracion y rango de Posiciones Equivalentes (EPOS)** - **type_document_id: 15**. Define los numeros secuenciales autorizados para emitir estos documentos.\r\n\r\n**Endpoint:** `PUT /api/ubl2.1/config/resolution`\r\n\r\n---\r\n\r\n## 📤 Cuerpo de la Peticion\r\n\r\n| Campo | Tipo | Obligatorio | Descripcion |\r\n|-------|------|-------------|-------------|\r\n| **type_document_id** | integer | ✅ Si | **FIJO: 15** (Posicion Equivalente) |\r\n| **prefix** | string | ✅ Si | Prefijo unico (max 4 caracteres, ej: EPOS) |\r\n| **resolution** | string | ✅ Si | Numero de resolucion DIAN (ej: 18760000001) |\r\n| **resolution_date** | date | ✅ Si | Fecha de emision de la resolucion |\r\n| **from** | integer | ✅ Si | Numero inicial del rango (tipicamente 1) |\r\n| **to** | integer | ✅ Si | Numero final del rango |\r\n| **date_from** | date | ✅ Si | Fecha inicio de vigencia (YYYY-MM-DD) |\r\n| **date_to** | date | ✅ Si | Fecha fin de vigencia |\r\n\r\n**Ejemplo:**\r\n```json\r\n{\r\n \"type_document_id\": 15,\r\n \"prefix\": \"EPOS\",\r\n \"resolution\": \"18760000001\",\r\n \"resolution_date\": \"2019-01-19\",\r\n \"from\": 1,\r\n \"to\": 1000000,\r\n \"generated_to_date\": 0,\r\n \"date_from\": \"2019-01-19\",\r\n \"date_to\": \"2030-01-19\"\r\n}\r\n```\r\n\r\n---\r\n\r\n## ✅ Respuesta Exitosa\r\n\r\n```json\r\n{\r\n \"success\": true,\r\n \"resolutionId\": \"uuid-del-recurso\",\r\n \"message\": \"Resolucion EPOS configurada exitosamente\"\r\n}\r\n```\r\n\r\n---\r\n\r\n## 📌 Notas Importantes\r\n\r\n- ✓ type_document_id: FIJO en 15 para EPOS\r\n- ✓ Rango tipico: 1 a 1,000,000\r\n- ✓ Vigencia minima: 5 anos\r\n- ✓ Prefijo debe ser unico en el sistema" }, "response": [] }, { "name": "Paso 3 - Config-Resolution TranspTerr Documentos Equivalentes", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"type_document_id\": 19,\r\n\t\"prefix\": \"DETP\",\r\n\t\"resolution\": \"DETP\",\r\n\t\"resolution_date\": \"2025-01-01\",\r\n\t\"from\": 1,\r\n\t\"to\": 100000,\r\n\t\"generated_to_date\": 0,\r\n\t\"date_from\": \"2025-01-01\",\r\n\t\"date_to\": \"2030-01-01\"\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/config/resolution", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "config", "resolution" ] }, "description": "# PASO 3 - CONFIGURAR RESOLUCION TRANSPORTE TERRESTRE (DETP)\r\n\r\n## 📋 Descripcion General\r\n\r\nConfigura la **numeracion para Documentos de Transporte Terrestre (DETP)** - **type_document_id: 19**. Autoriza la emision de Documentos Equivalentes para transporte de carga terrestre con integracion RNDC.\r\n\r\n**Endpoint:** `PUT /api/ubl2.1/config/resolution`\r\n\r\n---\r\n\r\n## 📤 Cuerpo de la Peticion\r\n\r\n| Campo | Tipo | Obligatorio | Descripcion |\r\n|-------|------|-------------|-------------|\r\n| **type_document_id** | integer | ✅ Si | **FIJO: 19** (Documento Transporte Terrestre) |\r\n| **prefix** | string | ✅ Si | Prefijo unico (max 4 caracteres, ej: DETP) |\r\n| **resolution** | string | ✅ Si | Identificador de resolucion |\r\n| **resolution_date** | date | ✅ Si | Fecha de emision |\r\n| **from** | integer | ✅ Si | Numero inicial |\r\n| **to** | integer | ✅ Si | Numero final |\r\n| **date_from** | date | ✅ Si | Inicio vigencia |\r\n| **date_to** | date | ✅ Si | Fin vigencia |\r\n\r\n**Ejemplo:**\r\n```json\r\n{\r\n \"type_document_id\": 19,\r\n \"prefix\": \"DETP\",\r\n \"resolution\": \"DETP\",\r\n \"resolution_date\": \"2025-01-01\",\r\n \"from\": 1,\r\n \"to\": 100000,\r\n \"generated_to_date\": 0,\r\n \"date_from\": \"2025-01-01\",\r\n \"date_to\": \"2030-01-01\"\r\n}\r\n```\r\n\r\n---\r\n\r\n## ✅ Respuesta Exitosa\r\n\r\n```json\r\n{\r\n \"success\": true,\r\n \"resolutionId\": \"uuid\",\r\n \"message\": \"Resolucion DETP configurada\"\r\n}\r\n```\r\n\r\n---\r\n\r\n## 📌 Notas Importantes\r\n\r\n- ✓ type_document_id: FIJO en 19\r\n- ✓ Requiere RNDC previo\r\n- ✓ Integracion con sistema de rastreo\r\n- ✓ Documento de transporte terrestre de carga" }, "response": [] }, { "name": "Paso 4 - Config-Resolution Boleta Ingreso a Cine Documentos Equivalentes", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"type_document_id\": 16,\r\n\t\"prefix\": \"CIN\",\r\n\t\"resolution\": \"CIN\",\r\n\t\"resolution_date\": \"2025-01-01\",\r\n\t\"from\": 1,\r\n\t\"to\": 100000,\r\n\t\"generated_to_date\": 0,\r\n\t\"date_from\": \"2024-01-01\",\r\n\t\"date_to\": \"2030-01-01\"\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/config/resolution", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "config", "resolution" ] }, "description": "# PASO 4 - CONFIGURAR RESOLUCION BOLETA CINE (CIN)\r\n\r\n## 📋 Descripcion General\r\n\r\nConfigura la **numeracion para Boletas de Ingreso a Cine** - **type_document_id: 16**. Autoriza la emision de Documentos Equivalentes para venta de boletas de entrada a salas cinematograficas.\r\n\r\n**Endpoint:** `PUT /api/ubl2.1/config/resolution`\r\n\r\n---\r\n\r\n## 📤 Cuerpo de la Peticion\r\n\r\n| Campo | Tipo | Obligatorio | Descripcion |\r\n|-------|------|-------------|-------------|\r\n| **type_document_id** | integer | ✅ Si | **FIJO: 16** (Boleta Cine) |\r\n| **prefix** | string | ✅ Si | Prefijo unico (ej: CIN) |\r\n| **resolution** | string | ✅ Si | Identificador de resolucion |\r\n| **resolution_date** | date | ✅ Si | Fecha emision |\r\n| **from** | integer | ✅ Si | Numero inicial |\r\n| **to** | integer | ✅ Si | Numero final |\r\n| **date_from** | date | ✅ Si | Inicio vigencia |\r\n| **date_to** | date | ✅ Si | Fin vigencia |\r\n\r\n**Ejemplo:**\r\n```json\r\n{\r\n \"type_document_id\": 16,\r\n \"prefix\": \"CIN\",\r\n \"resolution\": \"CIN\",\r\n \"resolution_date\": \"2025-01-01\",\r\n \"from\": 1,\r\n \"to\": 100000,\r\n \"generated_to_date\": 0,\r\n \"date_from\": \"2024-01-01\",\r\n \"date_to\": \"2030-01-01\"\r\n}\r\n```\r\n\r\n---\r\n\r\n## ✅ Respuesta Exitosa\r\n\r\n```json\r\n{\r\n \"success\": true,\r\n \"resolutionId\": \"uuid\",\r\n \"message\": \"Resolucion Boleta Cine configurada\"\r\n}\r\n```\r\n\r\n---\r\n\r\n## 📌 Notas Importantes\r\n\r\n- ✓ type_document_id: FIJO en 16\r\n- ✓ Para salas cinematograficas y teatros\r\n- ✓ Documento de entrada/boleta\r\n- ✓ Rango configurable segun demanda" }, "response": [] }, { "name": "Paso 5 - Config-Resolution Servicios Publicos Documentos Equivalentes", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"type_document_id\": 24,\r\n\t\"prefix\": \"SSP\",\r\n\t\"resolution\": \"SSP\",\r\n\t\"resolution_date\": \"2025-01-01\",\r\n\t\"from\": 1,\r\n\t\"to\": 100000,\r\n\t\"generated_to_date\": 0,\r\n\t\"date_from\": \"2024-01-01\",\r\n\t\"date_to\": \"2030-01-01\"\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/config/resolution", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "config", "resolution" ] }, "description": "# PASO 5 - CONFIGURAR RESOLUCION SERVICIOS PUBLICOS (SSP)\r\n\r\n## 📋 Descripcion General\r\n\r\nConfigura la **numeracion para Servicios Publicos** - **type_document_id: 24**. Autoriza la emision de Documentos Equivalentes para empresas de servicios publicos (energia, agua, gas, telecomunicaciones).\r\n\r\n**Endpoint:** `PUT /api/ubl2.1/config/resolution`\r\n\r\n---\r\n\r\n## 📤 Cuerpo de la Peticion\r\n\r\n| Campo | Tipo | Obligatorio | Descripcion |\r\n|-------|------|-------------|-------------|\r\n| **type_document_id** | integer | ✅ Si | **FIJO: 24** (Servicios Publicos) |\r\n| **prefix** | string | ✅ Si | Prefijo unico (ej: SSP) |\r\n| **resolution** | string | ✅ Si | Identificador resolucion |\r\n| **resolution_date** | date | ✅ Si | Fecha emision |\r\n| **from** | integer | ✅ Si | Numero inicial |\r\n| **to** | integer | ✅ Si | Numero final |\r\n| **date_from** | date | ✅ Si | Inicio vigencia |\r\n| **date_to** | date | ✅ Si | Fin vigencia |\r\n\r\n**Ejemplo:**\r\n```json\r\n{\r\n \"type_document_id\": 24,\r\n \"prefix\": \"SSP\",\r\n \"resolution\": \"SSP\",\r\n \"resolution_date\": \"2025-01-01\",\r\n \"from\": 1,\r\n \"to\": 100000,\r\n \"generated_to_date\": 0,\r\n \"date_from\": \"2024-01-01\",\r\n \"date_to\": \"2030-01-01\"\r\n}\r\n```\r\n\r\n---\r\n\r\n## ✅ Respuesta Exitosa\r\n\r\n```json\r\n{\r\n \"success\": true,\r\n \"resolutionId\": \"uuid\",\r\n \"message\": \"Resolucion Servicios Publicos configurada\"\r\n}\r\n```\r\n\r\n---\r\n\r\n## 📌 Notas Importantes\r\n\r\n- ✓ type_document_id: FIJO en 24\r\n- ✓ Para empresas de servicios (energia, agua, gas, telecom)\r\n- ✓ Emision de recibos/facturas por servicios\r\n- ✓ Numeracion independiente por servicio recomendado" }, "response": [] }, { "name": "Paso 6 - Config-Resolution NC EqDocs", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "type": "text", "value": "application/json" }, { "key": "accept", "type": "text", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"type_document_id\": 26,\r\n\t\"from\": 1,\r\n\t\"to\": 99999999,\r\n\t\"prefix\": \"NCP\"\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/config/resolution", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "config", "resolution" ] }, "description": "# PASO 6 - CONFIGURAR RESOLUCION NOTA CREDITO (NC)\r\n\r\n## 📋 Descripcion General\r\n\r\nConfigura la **numeracion para Notas Credito** - **type_document_id: 26**. Autoriza la emision de Documentos Equivalentes como ajustes por devolucion o rebaja en valor.\r\n\r\n**Endpoint:** `PUT /api/ubl2.1/config/resolution`\r\n\r\n---\r\n\r\n## 📤 Cuerpo de la Peticion\r\n\r\n| Campo | Tipo | Obligatorio | Descripcion |\r\n|-------|------|-------------|-------------|\r\n| **type_document_id** | integer | ✅ Si | **FIJO: 26** (Nota Credito) |\r\n| **prefix** | string | ✅ Si | Prefijo unico (ej: NCP) |\r\n| **from** | integer | ✅ Si | Numero inicial |\r\n| **to** | integer | ✅ Si | Numero final |\r\n\r\n**Ejemplo:**\r\n```json\r\n{\r\n \"type_document_id\": 26,\r\n \"from\": 1,\r\n \"to\": 99999999,\r\n \"prefix\": \"NCP\"\r\n}\r\n```\r\n\r\n---\r\n\r\n## ✅ Respuesta Exitosa\r\n\r\n```json\r\n{\r\n \"success\": true,\r\n \"resolutionId\": \"uuid\",\r\n \"message\": \"Resolucion Nota Credito configurada\"\r\n}\r\n```\r\n\r\n---\r\n\r\n## 📌 Notas Importantes\r\n\r\n- ✓ type_document_id: FIJO en 26\r\n- ✓ Ajuste por devolucion o rebaja\r\n- ✓ Debe referencia documento original (factura)\r\n- ✓ Rango amplio disponible\r\n- ✓ Requiere razon y soporte documental" }, "response": [] }, { "name": "Paso 7 - Config-Resolution ND EqDocs", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "type": "text", "value": "application/json" }, { "key": "accept", "type": "text", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"type_document_id\": 25,\r\n\t\"from\": 1,\r\n\t\"to\": 99999999,\r\n\t\"prefix\": \"NDP\"\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/config/resolution", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "config", "resolution" ] }, "description": "# PASO 7 - CONFIGURAR RESOLUCION NOTA DEBITO (ND)\r\n\r\n## 📋 Descripcion General\r\n\r\nConfigura la **numeracion para Notas Debito** - **type_document_id: 27**. Autoriza la emision de Documentos Equivalentes para cobros adicionales por conceptos no facturados inicialmente.\r\n\r\n**Endpoint:** `PUT /api/ubl2.1/config/resolution`\r\n\r\n---\r\n\r\n## 📤 Cuerpo de la Peticion\r\n\r\n| Campo | Tipo | Obligatorio | Descripcion |\r\n|-------|------|-------------|-------------|\r\n| **type_document_id** | integer | ✅ Si | **FIJO: 27** (Nota Debito) |\r\n| **prefix** | string | ✅ Si | Prefijo unico (ej: NDP) |\r\n| **from** | integer | ✅ Si | Numero inicial |\r\n| **to** | integer | ✅ Si | Numero final |\r\n\r\n**Ejemplo:**\r\n```json\r\n{\r\n \"type_document_id\": 27,\r\n \"from\": 1,\r\n \"to\": 99999999,\r\n \"prefix\": \"NDP\"\r\n}\r\n```\r\n\r\n---\r\n\r\n## ✅ Respuesta Exitosa\r\n\r\n```json\r\n{\r\n \"success\": true,\r\n \"resolutionId\": \"uuid\",\r\n \"message\": \"Resolucion Nota Debito configurada\"\r\n}\r\n```\r\n\r\n---\r\n\r\n## 📌 Notas Importantes\r\n\r\n- ✓ type_document_id: FIJO en 27\r\n- ✓ Ajuste por cobro adicional\r\n- ✓ Debe referencia documento original (factura)\r\n- ✓ Rango amplio disponible\r\n- ✓ Requiere razon y soporte documental\r\n- ✓ Incrementa valor de deuda original" }, "response": [] } ] }, { "name": "Paso 1 - Config-Company", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"type_document_identification_id\": 3,\r\n\t\"type_organization_id\": 2,\r\n\t\"type_regime_id\": 2,\r\n\t\"type_liability_id\": 117,\r\n\t\"business_name\": \"VILLADA CARDONA ELIZABETH\",\r\n\t\"merchant_registration\": \"0000000-00\",\r\n\t\"municipality_id\": 820,\r\n\t\"address\": \"URB VILLA ALEJANDRA ET 1 MZ 2 CS 9\",\r\n\t\"phone\": 3108572153,\r\n\t\"email\": \"evilladadecardona@gmail.com.com\",\r\n \"mail_host\": \"smtp.gmail.com\",\r\n \"mail_port\": \"587\",\r\n \"mail_username\": \"backupsbabel7@gmail.com\",\r\n \"mail_password\": \"ccsdfjruqddyxcsjgfggqlqvttt\",\r\n \"mail_encryption\": \"tls\",\r\n \"mail_from_address\": \"backupsbabel7@gmail.com\",\r\n \"mail_from_name\": \"API DE FACTURACION ELECTRONICA\",\r\n \"imap_server\": \"imap.gmail.com\",\r\n \"imap_user\": \"alexanderobandolondono@gmail.com\",\r\n \"imap_password\": \"sstghufkwdatgjnsnqthxw\",\r\n \"imap_encryption\": \"ssl\",\r\n \"imap_port\": \"993\"\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/config/24479929/0", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "config", "24479929", "0" ] }, "description": "# PASO 1 - CONFIGURAR COMPAÑÍA\n\n## 📋 Descripción General\nEste es el **primer endpoint** que debe ejecutarse para configurar una nueva compañía en la API de facturación electrónica. Crea el usuario, la compañía y genera el **api_token** necesario para todas las operaciones posteriores.\n\n**Request Handler:** `ConfigurationController@store` \n**Request Validation:** `ConfigurationRequest` \n**Modelos:** `User`, `Company`\n\n### 🔄 Comportamiento Inteligente\n- **Si la compañía NO existe (CREATE):** Crea usuario y compañía nuevos\n- **Si la compañía YA existe (UPDATE):** Actualiza la información existente (idempotente)\n- **Validación de email:** No permite duplicar emails entre diferentes empresas\n- **Validación de DV:** Utiliza regla personalizada `dian_dv` para verificar dígito de verificación\n- **Usuario creado:** Email = `{email del request}`, Password = `{NIT}`\n- **Token generado:** `SHA256` hash del NIT (usado como password)\n- **Transaccional:** Toda la operación se ejecuta en una transacción DB con rollback automático en caso de error\n\n---\n\n## 🔗 URL del Endpoint\n\n### Patrón de URL\n```\nPOST /api/ubl2.1/config/{NIT}/{DV}\n```\n\n### Ejemplos:\n**Desarrollo local:**\n```\nhttp://apidian2026-8.oo/api/ubl2.1/config/24479929/0\n```\n\n**Producción con dominio:**\n```\nhttp://midominio.com/api/ubl2.1/config/89008003/2\n```\n\n### Parámetros de URL\n| Parámetro | Descripción | Ejemplo |\n|-----------|-------------|----------|\n| `NIT` | Número de Identificación Tributaria | `24479929` |\n| `DV` | Dígito de Verificación | `0` |\n\n---\n\n## 🔓 Autenticación\n**NO requiere token de autorización** - Este es el endpoint inicial que genera el token.\n\n---\n\n## 📤 Cuerpo de la Solicitud (JSON)\n\n### Estructura Completa\n```json\n{\n \"type_document_identification_id\": 3,\n \"type_organization_id\": 2,\n \"type_regime_id\": 2,\n \"type_liability_id\": 117,\n \"business_name\": \"VILLADA CARDONA ELIZABETH\",\n \"merchant_registration\": \"0000000-00\",\n \"municipality_id\": 820,\n \"address\": \"URB VILLA ALEJANDRA ET 1 MZ 2 CS 9\",\n \"phone\": 3108572153,\n \"email\": \"evilladadecardona@gmail.com\",\n \"mail_host\": \"smtp.gmail.com\",\n \"mail_port\": \"587\",\n \"mail_username\": \"backupsbabel7@gmail.com\",\n \"mail_password\": \"ccsdfjruqddyxcsjgfggqlqvttt\",\n \"mail_encryption\": \"tls\",\n \"mail_from_address\": \"backupsbabel7@gmail.com\",\n \"mail_from_name\": \"API DE FACTURACION ELECTRONICA\",\n \"imap_server\": \"imap.gmail.com\",\n \"imap_user\": \"alexanderobandolondono@gmail.com\",\n \"imap_password\": \"sstghufkwdatgjnsnqthxw\",\n \"imap_encryption\": \"ssl\",\n \"imap_port\": \"993\"\n}\n```\n\n### Campos Requeridos (Información de la Compañía)\n| Campo | Tipo | Validación | Descripción |\n|-------|------|------------|-------------|\n| `type_document_identification_id` | integer | required, exists:type_document_identifications | ID del tipo de documento (Tabla: `type_document_identifications`) |\n| `type_organization_id` | integer | required, exists:type_organizations | ID del tipo de organización (Tabla: `type_organizations`) |\n| `type_regime_id` | integer | required, exists:type_regimes | ID del régimen tributario (Tabla: `type_regimes`) |\n| `type_liability_id` | integer | required, exists:type_liabilities | ID del tipo de responsabilidad fiscal (Tabla: `type_liabilities`) |\n| `business_name` | string | required | Razón social completa de la empresa |\n| `merchant_registration` | string | required | Matrícula mercantil (formato: \"0000000-00\") |\n| `municipality_id` | integer | required, exists:municipalities | ID del municipio DANE (Tabla: `municipalities`) |\n| `address` | string | required | Dirección física completa de la empresa |\n| `phone` | integer | required, digits_between:7,10 | Teléfono de contacto (7-10 dígitos) |\n| `email` | string | required, email | Email principal de la empresa (usado para crear el usuario) |\n\n**Nota:** Los parámetros `{NIT}` y `{DV}` en la URL también son requeridos:\n- `nit`: required, numeric, digits_between:1,15\n- `dv`: required, numeric, digits:1, validación con algoritmo DIAN\n\n### Campos Opcionales - Configuración de Entorno\n| Campo | Tipo | Default | Descripción |\n|-------|------|---------|-------------|\n| `language_id` | integer | 79 (Español) | ID del idioma (Tabla: `languages`) |\n| `tax_id` | integer | 1 (IVA) | ID del impuesto (Tabla: `taxes`) |\n| `country_id` | integer | 46 (Colombia) | ID del país (Tabla: `countries`) |\n| `type_currency_id` | integer | 35 (COP) | ID de la moneda (Tabla: `type_currencies`) |\n| `type_environment_id` | integer | 2 (Producción) | Ambiente DIAN para facturación (1=Habilitación, 2=Producción) |\n| `payroll_type_environment_id` | integer | 2 | Ambiente DIAN para nómina electrónica |\n| `eqdocs_type_environment_id` | integer | 2 | Ambiente DIAN para documentos equivalentes |\n| `type_operation_id` | integer | 10 | ID del tipo de operación (Tabla: `type_operations`) |\n| `state` | boolean | 1 | Estado de la compañía (1=Activa, 0=Inactiva) |\n| `id_administrator` | integer | 1 | ID del administrador (Tabla: `administrators`) |\n\n### Campos Opcionales - Configuración SMTP (Envío de correos)\n**Todos los campos SMTP son dependientes entre sí** (`required_with`) \nSi configuras uno, debes configurar todos:\n\n| Campo | Tipo | Descripción | Ejemplo |\n|-------|------|-------------|----------|\n| `mail_host` | string | Servidor SMTP | `smtp.gmail.com` |\n| `mail_port` | integer | Puerto SMTP | `587` (TLS) o `465` (SSL) |\n| `mail_username` | string | Usuario SMTP completo | `usuario@gmail.com` |\n| `mail_password` | string | Contraseña o App Password | `abc123xyz456` |\n| `mail_encryption` | string | Tipo de encriptación | `tls` o `ssl` |\n| `mail_from_address` | string | Email remitente en facturas | `noreply@empresa.com` |\n| `mail_from_name` | string | Nombre del remitente | `Mi Empresa` |\n\n### Campos Opcionales - Configuración IMAP (Recepción de correos DIAN)\n**Todos los campos IMAP son dependientes entre sí** (`required_with`) \nSi configuras uno, debes configurar todos:\n\n| Campo | Tipo | Descripción | Ejemplo |\n|-------|------|-------------|----------|\n| `imap_server` | string | Servidor IMAP | `imap.gmail.com` |\n| `imap_user` | string | Usuario IMAP completo | `recepcion@gmail.com` |\n| `imap_password` | string | Contraseña IMAP | `xyz789abc123` |\n| `imap_encryption` | string | Tipo de encriptación | `ssl` o `tls` |\n| `imap_port` | string | Puerto IMAP | `993` (SSL) o `143` (TLS) |\n\n### Campos Opcionales - Planes de Suscripción\n| Campo | Tipo | Descripción |\n|-------|------|-------------|\n| `type_plan_id` | integer | ID del plan principal (Tabla: `type_plans`, min:1) |\n| `type_plan2_id` | integer | ID del plan secundario (Tabla: `type_plans`, min:1) |\n| `type_plan3_id` | integer | ID del plan terciario (Tabla: `type_plans`, min:1) |\n| `type_plan4_id` | integer | ID del plan cuaternario (Tabla: `type_plans`, min:1) |\n| `absolut_plan_documents` | integer | Número absoluto de documentos contratados |\n| `renew_plan1` | boolean | Renovar plan 1 (reinicia fecha de inicio) |\n| `renew_plan2` | boolean | Renovar plan 2 (reinicia fecha de inicio) |\n| `renew_plan3` | boolean | Renovar plan 3 (reinicia fecha de inicio) |\n| `renew_plan4` | boolean | Renovar plan 4 (reinicia fecha de inicio) |\n| `renew_absolut_plan` | boolean | Renovar plan absoluto |\n\n**Comportamiento de Planes:**\n- Si se asigna un `type_plan_id` por primera vez, se establece `start_plan_date` = fecha/hora actual\n- En UPDATE, si cambias el plan o marcas `renew_plan` = true, se reinicia la fecha\n- Las fechas de inicio se manejan automáticamente por el sistema\n\n---\n\n## 📥 Respuesta Exitosa\n\n### Código HTTP\n```\n200 OK\n```\n\n### Cuerpo de la Respuesta\n```json\n{\n \"success\": true,\n \"message\": \"Compañía creada exitosamente\",\n \"api_token\": \"4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa\",\n \"operation\": \"CREATE\"\n}\n```\n\n**En caso de UPDATE:**\n```json\n{\n \"success\": true,\n \"message\": \"Compañía actualizada exitosamente\",\n \"api_token\": \"4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa\",\n \"operation\": \"UPDATE\"\n}\n```\n\n### ⚠️ CRÍTICO: Gestión del api_token\nEl campo **`api_token`** es el más importante de la respuesta:\n\n**📌 Características:**\n- Generado con: `hash('sha256', $nit)` - SHA256 del NIT\n- Longitud: 64 caracteres hexadecimales\n- Permanente: No expira (a menos que cambies la contraseña del usuario)\n- Único por compañía\n\n**🔐 Uso en Siguientes Requests:**\n```\nAuthorization: Bearer 4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa\n```\n\n**💾 Almacenamiento:**\n- Guárdalo en tu base de datos asociado al NIT\n- Guárdalo en variables de entorno para testing\n- NO lo compartas públicamente\n\n**🔄 Recuperación si se pierde:**\n1. Consulta directa en BD: `SELECT api_token FROM users WHERE email = '{nit}@api.com'`\n2. Tabla: `users`, Campo: `api_token`\n3. O vuelve a ejecutar este endpoint (UPDATE) - devuelve el mismo token\n\n---\n\n## 🗄️ Estructura de Datos Creada\n\n### Tabla: `users`\n```sql\nINSERT INTO users (\n name, -- business_name del request\n email, -- email del request \n password, -- bcrypt($nit)\n api_token, -- hash('sha256', $nit)\n id_administrator, -- id_administrator del request o 1\n mail_host, -- configuración SMTP\n mail_port,\n mail_username,\n mail_password,\n mail_encryption,\n mail_from_address,\n mail_from_name\n)\n```\n\n### Tabla: `companies`\n```sql\nINSERT INTO companies (\n user_id, -- ID del usuario creado\n identification_number, -- NIT de la URL\n dv, -- DV de la URL\n language_id, -- default: 79 (Español)\n tax_id, -- default: 1 (IVA)\n type_environment_id, -- default: 2 (Producción)\n payroll_type_environment_id, -- default: 2\n eqdocs_type_environment_id, -- default: 2\n type_operation_id, -- default: 10\n type_document_identification_id, -- del request\n country_id, -- default: 46 (Colombia)\n type_currency_id, -- default: 35 (COP)\n type_organization_id, -- del request\n type_regime_id, -- del request\n type_liability_id, -- del request\n municipality_id, -- del request\n merchant_registration, -- del request\n address, -- del request\n phone, -- del request\n type_plan_id, -- default: 0\n state, -- default: 1 (Activa)\n start_plan_date, -- Carbon::now() si type_plan_id presente\n imap_server, -- configuración IMAP\n imap_user,\n imap_password,\n imap_encryption,\n imap_port\n)\n```\n\n---\n\n## 🔄 Comportamiento\n- **Si la compañía NO existe (CREATE):** \n * Crea registro en tabla `users`\n * Crea registro en tabla `companies` vinculado al user\n * Genera `api_token` = `hash('sha256', $nit)`\n * Establece password = `bcrypt($nit)`\n * Si se especifican planes, establece `start_plan_date` = fecha/hora actual\n * Retorna `{\"operation\": \"CREATE\"}`\n\n- **Si la compañía YA existe (UPDATE):**\n * Busca la compañía por NIT\n * Valida que el email no esté duplicado en otras compañías\n * Actualiza datos del usuario y compañía\n * **NO cambia** el `api_token` ni el password (permanecen igual)\n * Si cambias plan o marcas `renew_plan` = true, reinicia `start_plan_date`\n * Retorna `{\"operation\": \"UPDATE\"}`\n\n- **Transaccionalidad:**\n * Todo se ejecuta en `DB::beginTransaction()`\n * Si hay error, hace `DB::rollBack()` automático\n * Si hay éxito, hace `commit` y retorna el token\n\n- **Credenciales generadas:**\n * **Email de usuario:** El que envíes en el campo `email` del request\n * **Password:** `$nit` (el NIT sin encriptar, para que puedas hacer login)\n * **Password encriptado:** `bcrypt($nit)` en la BD\n * **API Token:** `hash('sha256', $nit)` para usar en la API\n\n---\n\n## 📚 Consulta de Tablas Paramétricas\n\nLos campos que terminan en `_id` hacen referencia a tablas de la base de datos.\n\n### Tabla de Referencia Completa\n\n| Campo en JSON | Tabla en BD | Descripción | Ejemplos |\n|---------------|-------------|-------------|----------|\n| `type_document_identification_id` | `type_document_identifications` | Tipo de documento | 3=NIT, 1=CC, 2=CE, 4=Pasaporte |\n| `type_organization_id` | `type_organizations` | Tipo de organización | 1=Persona Jurídica, 2=Persona Natural |\n| `type_regime_id` | `type_regimes` | Régimen tributario | 1=Régimen Común, 2=Régimen Simplificado |\n| `type_liability_id` | `type_liabilities` | Responsabilidades fiscales | 117=Gran Contribuyente, 48=IVA |\n| `municipality_id` | `municipalities` | Código DANE del municipio | 820=Pereira, 1=Medellín, 149=Bogotá |\n| `language_id` | `languages` | Idioma | 79=Español, 52=Inglés |\n| `tax_id` | `taxes` | Tipo de impuesto | 1=IVA (01), 2=IC (04) |\n| `country_id` | `countries` | País | 46=Colombia (CO) |\n| `type_currency_id` | `type_currencies` | Moneda | 35=COP, 156=USD, 52=EUR |\n| `type_environment_id` | `type_environments` | Ambiente DIAN | 1=Habilitación, 2=Producción |\n| `type_operation_id` | `type_operations` | Tipo de operación | 10=Estándar, 9=AIU, 22=Mandatos |\n| `type_plan_id` | `type_plans` | Plan de suscripción | Consultar tabla `type_plans` |\n| `id_administrator` | `administrators` | Administrador del sistema | 1=Administrador por defecto |\n\n### 🔍 Cómo Consultar las Tablas\n\n**Opción 1 - Directamente en MySQL:**\n```sql\n-- Ver todos los tipos de documento\nSELECT id, name, code FROM type_document_identifications;\n\n-- Ver todos los municipios\nSELECT id, name, state_name FROM municipalities;\n\n-- Ver regímenes\nSELECT id, name, code FROM type_regimes;\n\n-- Ver responsabilidades fiscales\nSELECT id, name, code FROM type_liabilities;\n```\n\n**Opción 2 - Endpoints de la API:**\nLa API puede tener endpoints para consultar estas tablas paramétricas. \nBuscar en la colección: endpoints que devuelvan listados de parámetros.\n\n**Recomendación:** Carga estas tablas en tu aplicación al inicio y guárdalas en caché local para evitar consultas constantes.\n\n---\n\n## 🚀 Siguientes Pasos\n\nDespués de configurar la compañía:\n\n1. **Paso 2:** Configurar Software (`POST /api/ubl2.1/config-software`)\n - Usar el `api_token` recibido\n - Configurar certificado digital y credenciales DIAN\n\n2. **Paso 3:** Configurar Resolución de Facturación\n - Registrar resolución DIAN\n - Configurar rangos de numeración\n\n3. **Iniciar facturación electrónica**\n\n---\n\n## ❌ Errores Comunes\n\n### Error 422 - Unprocessable Entity (Validation Error)\n**Respuesta:**\n```json\n{\n \"message\": \"The given data was invalid.\",\n \"errors\": {\n \"nit\": [\"El campo nit es obligatorio.\"],\n \"email\": [\"El formato del email es inválido.\"]\n }\n}\n```\n**Causas comunes:**\n- Campos requeridos faltantes (`type_document_identification_id`, `type_organization_id`, etc.)\n- Email con formato inválido\n- Teléfono con menos de 7 o más de 10 dígitos\n- IDs que no existen en las tablas paramétricas\n- Dígito de verificación (DV) incorrecto según algoritmo DIAN\n\n**Solución:**\n- Verificar que todos los campos requeridos estén presentes\n- Validar formato de email y teléfono\n- Confirmar IDs contra las tablas de la base de datos\n- Calcular correctamente el DV del NIT\n\n---\n\n### Error 400 - Bad Request (Email Duplicado)\n**Respuesta:**\n```json\n{\n \"message\": \"Error de registro, el correo electronico ya existe o es el mismo que tiene registrado actualmente.\",\n \"success\": false\n}\n```\n**Causa:**\n- El email que intentas usar ya está registrado en otra compañía diferente\n- En operación UPDATE, intentas cambiar a un email que usa otra empresa\n\n**Solución:**\n- Usar un email diferente y único\n- Cada compañía debe tener su propio email\n- En UPDATE, puedes mantener el mismo email o usar uno nuevo no registrado\n\n---\n\n### Error 500 - Internal Server Error\n**Causas posibles:**\n- IDs de tablas paramétricas incorrectos (no existen en la BD)\n- Problema de conexión con la base de datos\n- Error en la transacción (se ejecuta rollback automático)\n- Problema con campos mal formateados en la BD\n\n**Solución:**\n1. Verificar logs del servidor: `storage/logs/laravel.log`\n2. Confirmar que todos los IDs existen en sus respectivas tablas\n3. Verificar conexión a la base de datos\n4. Revisar que la estructura de las tablas esté correcta\n\n---\n\n### Error de configuración SMTP/IMAP\n**Síntomas:**\n- El endpoint funciona pero los emails no se envían\n- No se reciben respuestas de la DIAN por IMAP\n\n**Validación de campos SMTP:**\n```php\n// Todos estos campos deben estar presentes juntos:\nmail_host, mail_port, mail_username, mail_password, \nmail_encryption, mail_from_address, mail_from_name\n```\n\n**Validación de campos IMAP:**\n```php\n// Todos estos campos deben estar presentes juntos:\nimap_server, imap_user, imap_password, imap_encryption, imap_port\n```\n\n**Solución Gmail:**\n1. Habilitar \"Acceso de aplicaciones menos seguras\"\n2. O mejor: Generar \"Contraseña de aplicación\" (App Password)\n3. Configuración recomendada:\n - SMTP: `smtp.gmail.com`, puerto `587`, encryption `tls`\n - IMAP: `imap.gmail.com`, puerto `993`, encryption `ssl`\n\n**Solución Outlook/Hotmail:**\n- SMTP: `smtp.office365.com`, puerto `587`, encryption `tls`\n- IMAP: `outlook.office365.com`, puerto `993`, encryption `ssl`\n\n---\n\n### Error de validación de DV (Dígito de Verificación)\n**Respuesta:**\n```json\n{\n \"message\": \"The given data was invalid.\",\n \"errors\": {\n \"dv\": [\"El dígito de verificación no es válido para este NIT.\"]\n }\n}\n```\n**Causa:**\n- El DV enviado no coincide con el calculado según el algoritmo DIAN\n\n**Solución:**\n- Usa una calculadora de DV en línea o implementa el algoritmo:\n * Algoritmo DIAN: https://www.dian.gov.co/\n- Ejemplo: NIT `890123456` → DV = `7`\n- El DV se valida con la regla custom `dian_dv` implementada en la API\n\n---\n\n### Transacción con Rollback\n**Escenario:**\nSi algo falla durante la creación (user o company), toda la operación se revierte.\n\n**Qué se revierte:**\n- Inserción en tabla `users`\n- Inserción en tabla `companies`\n- Cualquier otra operación dentro de la transacción\n\n**Ventaja:**\nNo quedan registros huérfanos o inconsistentes en la BD.\n\n**Logs:**\nRevisa `storage/logs/laravel.log` para ver el detalle del error que causó el rollback.\n\n---\n\n## 💡 Ejemplo de Uso con cURL\n\n```bash\ncurl -X POST \"http://apidian2026-8.oo/api/ubl2.1/config/24479929/0\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Accept: application/json\" \\\n -d '{\n \"type_document_identification_id\": 3,\n \"type_organization_id\": 2,\n \"type_regime_id\": 2,\n \"type_liability_id\": 117,\n \"business_name\": \"MI EMPRESA SAS\",\n \"merchant_registration\": \"0000000-00\",\n \"municipality_id\": 820,\n \"address\": \"Calle 123 #45-67\",\n \"phone\": 3001234567,\n \"email\": \"contacto@miempresa.com\",\n \"mail_host\": \"smtp.gmail.com\",\n \"mail_port\": \"587\",\n \"mail_username\": \"facturacion@miempresa.com\",\n \"mail_password\": \"tu_app_password_aqui\",\n \"mail_encryption\": \"tls\",\n \"mail_from_address\": \"facturacion@miempresa.com\",\n \"mail_from_name\": \"Mi Empresa - Facturación\"\n }'\n```\n\n---\n\n## 📞 Soporte\nSi encuentras problemas, verifica:\n1. ✅ NIT y DV correctos en la URL\n2. ✅ Todos los campos requeridos presentes\n3. ✅ IDs de tablas paramétricas válidos\n4. ✅ Formato JSON válido (sin comas extras)\n5. ✅ Conexión a la base de datos activa" }, "response": [] }, { "name": "Paso 2 - Config-Software", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "cache-control", "value": "no-cache", "type": "text" }, { "key": "Connection", "value": "keep-alive", "type": "text" }, { "key": "Accept-Encoding", "value": "gzip, deflate", "type": "text" }, { "key": "Host", "value": "localhost", "type": "text", "disabled": true }, { "key": "accept", "value": "application/json", "type": "text" }, { "key": "X-CSRF-TOKEN", "value": "", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"id\": \"48e1e388-588a-4e78-94be-8f5554adb373\",\r\n\t\"pin\": 12345\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/config/software", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "config", "software" ] }, "description": "# PASO 2 - CONFIGURAR SOFTWARE\n\n## 📋 Descripción General\nConfigura las credenciales del software registrado ante la DIAN para facturación electrónica. Este endpoint permite configurar múltiples softwares para diferentes tipos de documentos (facturación, nómina, documentos equivalentes).\n\n**Request Handler:** `ConfigurationController@storeSoftware` \n**Request Validation:** `ConfigurationSoftwareRequest` \n**Modelo:** `Software`\n\n### 🔄 Comportamiento\n- **Si NO existe software:** Crea nuevo registro en tabla `softwares`\n- **Si YA existe software:** Actualiza el registro existente\n- **URLs por defecto:** Si no se especifica URL, usa `https://vpfe-hab.dian.gov.co/WcfDianCustomerServices.svc`\n- **Transaccional:** Opera con DB transaction y rollback automático\n\n---\n\n## 🔗 URL del Endpoint\n\n### Patrón de URL\n```\nPUT /api/ubl2.1/config/software\n```\n\n### Ejemplos:\n**Desarrollo local:**\n```\nhttp://apidian2026-8.oo/api/ubl2.1/config/software\n```\n\n**Producción:**\n```\nhttp://midominio.com/api/ubl2.1/config/software\n```\n\n---\n\n## 🔐 Autenticación\n**Requiere Bearer Token** - Usa el `api_token` del Paso 1\n\n```\nAuthorization: Bearer {api_token}\n```\n\n---\n\n## 📤 Cuerpo de la Solicitud (JSON)\n\n### Estructura Completa\n```json\n{\n \"id\": \"48e1e388-588a-4e78-94be-8f5554adb373\",\n \"pin\": 12345,\n \"url\": \"https://vpfe.dian.gov.co/WcfDianCustomerServices.svc\",\n \"idpayroll\": \"478be703-d445-4729-86db-9d5a7308f6f4\",\n \"pinpayroll\": 54321,\n \"urlpayroll\": \"https://vpfe.dian.gov.co/WcfDianCustomerServices.svc\",\n \"ideqdocs\": \"378be703-d445-4729-86db-9d5a7308f6f5\",\n \"pineqdocs\": 11111,\n \"urleqdocs\": \"https://vpfe.dian.gov.co/WcfDianCustomerServices.svc\"\n}\n```\n\n### Software de Facturación Electrónica\n| Campo | Tipo | Validación | Descripción |\n|-------|------|------------|-------------|\n| `id` | string (UUID) | nullable | ID del software (Software ID de DIAN) |\n| `pin` | integer | nullable, required_with:id, digits:5 | PIN de 5 dígitos del software |\n| `url` | string (URL) | nullable, url | URL del servicio web DIAN (default: habilitación) |\n\n**Importante:** Si especificas `id`, debes Especificar también `pin` (dependencia `required_with`).\n\n### Software de Nómina Electrónica\n| Campo | Tipo | Validación | Descripción |\n|-------|------|------------|-------------|\n| `idpayroll` | string (UUID) | nullable | ID del software de nómina |\n| `pinpayroll` | integer | nullable, required_with:idpayroll, digits:5 | PIN de 5 dígitos para nómina |\n| `urlpayroll` | string (URL) | nullable, url | URL servicio web DIAN nómina |\n\n### Software de Documentos Equivalentes\n| Campo | Tipo | Validación | Descripción |\n|-------|------|------------|-------------|\n| `ideqdocs` | string (UUID) | nullable | ID del software de documentos equivalentes |\n| `pineqdocs` | integer | nullable, required_with:ideqdocs, digits:5 | PIN de 5 dígitos para docs equivalentes |\n| `urleqdocs` | string (URL) | nullable, url | URL servicio web DIAN docs equivalentes |\n\n---\n\n## 📊 Información de Software ID y PIN\n\n### ¿Dónde obtener el Software ID y PIN?\n1. Registrarse en el portal de la DIAN como facturador electrónico\n2. Crear un registro de software con \"Modo de operación: Software propio\"\n3. La DIAN genera un **Software ID** (UUID formato: `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`)\n4. Tú defines un **PIN** de 5 dígitos durante el registro\n\n### Tipos de Software que puedes registrar:\n- **Software de Facturación:** Para facturas, notas crédito, notas débito\n- **Software de Nómina:** Para documentos de nómina electrónica\n- **Software Documentos Equivalentes:** Para POS, tiquetes, etc.\n\n**Nota:** Puedes configurar los 3 tipos de software en la misma API, o solo los que necesites.\n\n---\n\n## 🗄️ Estructura en Base de Datos\n\n### Tabla: `softwares`\n```sql\nINSERT/UPDATE softwares (\n company_id, -- ID de la compañía (automático)\n identifier, -- id del request (Facturación)\n pin, -- pin del request (Facturación)\n url, -- url del request o default\n identifier_payroll, -- idpayroll del request (Nómina)\n pin_payroll, -- pinpayroll del request (Nómina)\n url_payroll, -- urlpayroll del request o default\n identifier_eqdocs, -- ideqdocs del request (Docs Equiv.)\n pin_eqdocs, -- pineqdocs del request (Docs Equiv.)\n url_eqdocs -- urleqdocs del request o default\n)\n```\n\n### Valores Default:\n- **URLs no especificadas:** `https://vpfe-hab.dian.gov.co/WcfDianCustomerServices.svc` (ambiente de habilitación)\n- **URLs en producción:** `https://vpfe.dian.gov.co/WcfDianCustomerServices.svc`\n\n---\n\n## 📥 Respuesta Exitosa\n\n### Código HTTP\n```\n200 OK\n```\n\n### Cuerpo de la Respuesta\n```json\n{\n \"success\": true,\n \"message\": \"Software creado/actualizado con éxito\",\n \"software\": {\n \"id\": 1,\n \"company_id\": 1,\n \"identifier\": \"48e1e388-588a-4e78-94be-8f5554adb373\",\n \"pin\": \"12345\",\n \"url\": \"https://vpfe.dian.gov.co/WcfDianCustomerServices.svc\",\n \"identifier_payroll\": \"478be703-d445-4729-86db-9d5a7308f6f4\",\n \"pin_payroll\": \"54321\",\n \"url_payroll\": \"https://vpfe.dian.gov.co/WcfDianCustomerServices.svc\",\n \"identifier_eqdocs\": \"378be703-d445-4729-86db-9d5a7308f6f5\",\n \"pin_eqdocs\": \"11111\",\n \"url_eqdocs\": \"https://vpfe.dian.gov.co/WcfDianCustomerServices.svc\",\n \"created_at\": \"2025-11-18T10:30:00.000000Z\",\n \"updated_at\": \"2025-11-18T10:30:00.000000Z\"\n }\n}\n```\n\n---\n\n## 🔄 Ambientes DIAN\n\n### Ambiente de Habilitación (Pruebas)\n```\nhttps://vpfe-hab.dian.gov.co/WcfDianCustomerServices.svc\n```\n- Usado para pruebas y certificación\n- No tiene validez fiscal\n- Documentos de prueba\n\n### Ambiente de Producción\n```\nhttps://vpfe.dian.gov.co/WcfDianCustomerServices.svc\n```\n- Usado para facturación real\n- Documentos con validez fiscal\n- Requiere habilitación previa\n\n**Flujo:**\n1. Registrar software en habilitación\n2. Realizar set de pruebas (TestSet)\n3. Solicitar habilitación a producción\n4. Cambiar URL a producción en este endpoint\n\n---\n\n## ❌ Errores Comunes\n\n### Error 401 - Unauthorized\n**Respuesta:**\n```json\n{\n \"message\": \"Unauthenticated.\"\n}\n```\n**Causa:** Token de autorización inválido, expirado o no proporcionado\n\n**Solución:**\n- Verificar que el header `Authorization: Bearer {token}` esté presente\n- Usar el token obtenido en Paso 1 - Config Company\n- Revisar tabla `users` campo `api_token` si se perdió el token\n\n---\n\n### Error 422 - Validation Error\n**Respuesta:**\n```json\n{\n \"message\": \"The given data was invalid.\",\n \"errors\": {\n \"pin\": [\"El campo pin debe tener 5 dígitos.\"],\n \"pinpayroll\": [\"El campo pinpayroll es requerido cuando idpayroll está presente.\"]\n }\n}\n```\n\n**Causas comunes:**\n- PIN no tiene exactamente 5 dígitos\n- Especificaste `id` pero no `pin` (o viceversa con payroll/eqdocs)\n- URL con formato inválido\n\n**Solución:**\n- PIN debe ser numérico de exactamente 5 dígitos: `12345`, `00001`, `99999`\n- Si configuras `id`, debes configurar también `pin`\n- URLs deben empezar con `http://` o `https://`\n\n---\n\n### Error 500 - Internal Server Error\n**Respuesta:**\n```json\n{\n \"message\": \"Internal Server Error\",\n \"payload\": \"Detalle del error...\"\n}\n```\n\n**Causas posibles:**\n- Error en la transacción de base de datos\n- Problema de conexión con la BD\n- Compañía no encontrada para el usuario autenticado\n\n**Solución:**\n1. Verificar logs: `storage/logs/laravel.log`\n2. Confirmar que la compañía del usuario exista (Paso 1 completado)\n3. Revisar conexión a base de datos\n4. El campo `payload` en la respuesta contiene el detalle técnico del error\n\n---\n\n### Software ID inválido en DIAN\n**Síntoma:** El endpoint funciona pero la DIAN rechaza los documentos enviados\n\n**Error DIAN:**\n```xml\n\n Regla: FAJ18, Rechazo: Software ID no registrado\n\n```\n\n**Causa:** El Software ID no está registrado en DIAN o el PIN es incorrecto\n\n**Solución:**\n1. Verificar Software ID en portal DIAN\n2. Confirmar que el PIN coincide con el registrado\n3. Verificar que el software esté en estado \"Activo\" en DIAN\n4. Si es ambiente de habilitación, usar el Software ID de habilitación\n5. Si es producción, usar el Software ID de producción\n\n---\n\n## 🚀 Siguientes Pasos\n\nDespués de configurar el software:\n\n1. **Paso 3:** Configurar Certificado (`POST /api/ubl2.1/config/certificate`)\n - Subir certificado digital .p12 o .pfx\n - Configurar password del certificado\n\n2. **Paso 4:** Configurar Resolución de Facturación\n - Registrar resolución DIAN\n - Configurar rangos de numeración\n\n3. **Realizar pruebas (TestSet)** si estás en ambiente de habilitación\n\n4. **Iniciar facturación**\n\n---\n\n## 💡 Ejemplo Completo con cURL\n\n```bash\ncurl -X PUT \"http://apidian2026-8.oo/api/ubl2.1/config/software\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Accept: application/json\" \\\n -H \"Authorization: Bearer 4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa\" \\\n -d '{\n \"id\": \"48e1e388-588a-4e78-94be-8f5554adb373\",\n \"pin\": 12345,\n \"url\": \"https://vpfe.dian.gov.co/WcfDianCustomerServices.svc\"\n }'\n```\n\n### Ejemplo solo actualizando Software de Nómina:\n```bash\ncurl -X PUT \"http://apidian2026-8.oo/api/ubl2.1/config/software\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Accept: application/json\" \\\n -H \"Authorization: Bearer {tu_api_token}\" \\\n -d '{\n \"idpayroll\": \"478be703-d445-4729-86db-9d5a7308f6f4\",\n \"pinpayroll\": 54321\n }'\n```\n\n---\n\n## 📞 Soporte\nSi encuentras problemas, verifica:\n1. ✅ Token de autorización válido en header\n2. ✅ Software ID y PIN correctos de portal DIAN\n3. ✅ PIN de exactamente 5 dígitos\n4. ✅ URLs con formato correcto (http:// o https://)\n5. ✅ Ambiente correcto (habilitación vs producción)\n6. ✅ Software registrado y activo en portal DIAN" }, "response": [] }, { "name": "Paso 3 - Config-Certificate", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "cache-control", "value": "no-cache", "type": "text" }, { "key": "Connection", "value": "keep-alive", "type": "text" }, { "key": "Accept-Encoding", "value": "gzip, deflate", "type": "text" }, { "key": "Host", "value": "localhost", "type": "text", "disabled": true }, { "key": "accept", "value": "application/json", "type": "text" }, { "key": "X-CSRF-TOKEN", "value": "", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"certificate\": \"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\",\r\n\t\"password\": \"KuuybadfamIQv7llnaSBapJIN\"\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/config/certificate", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "config", "certificate" ] }, "description": "# PASO 3 - CONFIGURAR CERTIFICADO DIGITAL\n\n## 📋 Descripción General\nConfigura el certificado digital (.p12/.pfx) necesario para firmar los documentos electrónicos. Este certificado es emitido por una entidad certificadora autorizada por la DIAN.\n\n**Request Handler:** `ConfigurationController@storeCertificate` \n**Request Validation:** `ConfigurationCertificateRequest` \n**Modelo:** `Certificate`\n\n### 🔄 Comportamiento\n- **Elimina certificado previo** si existe (un solo certificado por compañía)\n- **Valida Base64:** Verifica que el certificado esté correctamente codificado\n- **Valida PKCS12:** Verifica que el certificado sea válido con la contraseña\n- **Extrae información:** Lee datos del certificado (fecha de expiración, claves)\n- **Almacena:** Guarda el certificado en storage (LOCAL o S3)\n- **Transaccional:** Opera con DB transaction\n\n---\n\n## 🔗 URL del Endpoint\n\n```\nPUT /api/ubl2.1/config/certificate\n```\n\n**Desarrollo local:**\n```\nhttp://apidian2026-8.oo/api/ubl2.1/config/certificate\n```\n\n**Producción:**\n```\nhttp://midominio.com/api/ubl2.1/config/certificate\n```\n\n---\n\n## 🔐 Autenticación\n**Requiere Bearer Token**\n\n```\nAuthorization: Bearer {api_token}\n```\n\n---\n\n## 📤 Cuerpo de la Solicitud (JSON)\n\n### Estructura\n```json\n{\n \"certificate\": \"MIACAQMwgAYJKoZIhvcNAQcBoIAkgASCA+gwgDCABgkq...\",\n \"password\": \"tu_password_certificado\"\n}\n```\n\n### Campos\n| Campo | Tipo | Validación | Descripción |\n|-------|------|------------|-------------|\n| `certificate` | string (Base64) | required | Certificado .p12/.pfx codificado en Base64 |\n| `password` | string | required | Contraseña del certificado |\n\n---\n\n## 📝 Cómo Codificar el Certificado en Base64\n\n### Opción 1: En línea\n1. Ir a https://www.base64encode.org/\n2. Subir el archivo .p12 o .pfx\n3. Copiar el resultado\n\n### Opción 2: PHP\n```php\n$certificate = base64_encode(file_get_contents('certificado.p12'));\n```\n\n### Opción 3: Python\n```python\nimport base64\nwith open('certificado.p12', 'rb') as f:\n certificate = base64.b64encode(f.read()).decode()\n```\n\n### Opción 4: Node.js\n```javascript\nconst fs = require('fs');\nconst certificate = fs.readFileSync('certificado.p12').toString('base64');\n```\n\n### Opción 5: PowerShell\n```powershell\n$bytes = [System.IO.File]::ReadAllBytes(\"certificado.p12\")\n$certificate = [Convert]::ToBase64String($bytes)\n```\n\n---\n\n## 🗄️ Estructura en Base de Datos\n\n### Tabla: `certificates`\n```sql\nINSERT certificates (\n company_id, -- ID de la compañía (automático)\n name, -- {NIT}{DV}.p12\n password, -- password del request\n expiration_date, -- Extraído del certificado\n path -- Ruta de almacenamiento (hidden)\n)\n```\n\n### Almacenamiento Físico\n**LOCAL:** `storage/app/certificates/{NIT}{DV}.p12` \n**S3:** `certificates/{NIT}{DV}.p12`\n\n---\n\n## 📥 Respuesta Exitosa\n\n### Código HTTP\n```\n200 OK\n```\n\n### Cuerpo\n```json\n{\n \"success\": true,\n \"message\": \"Certificado creado/actualizado con éxito\",\n \"certificate\": {\n \"id\": 1,\n \"name\": \"244799290.p12\",\n \"expiration_date\": \"2027/12/31 23:59:59\",\n \"created_at\": \"2025-11-18T10:30:00.000000Z\",\n \"updated_at\": \"2025-11-18T10:30:00.000000Z\"\n }\n}\n```\n\n---\n\n## ❌ Errores Comunes\n\n### Error 422 - Base64 Inválido\n```json\n{\n \"message\": \"Los datos proporcionados son inválidos.\",\n \"errors\": {\n \"certificate\": \"The base64 encoding is not valid.\"\n }\n}\n```\n**Causa:** El string no es Base64 válido\n**Solución:** Recodificar el certificado correctamente\n\n---\n\n### Error 422 - Contraseña Incorrecta\n```json\n{\n \"message\": \"El certificado no pudo ser leído.\",\n \"errors\": {\n \"certificate\": \"error:23076071:PKCS12 routines:PKCS12_parse:mac verify failure\",\n \"password\": \"error:23076071:PKCS12 routines:PKCS12_parse:mac verify failure\"\n }\n}\n```\n**Causa:** La contraseña no coincide con el certificado\n**Solución:** Verificar la contraseña con el proveedor del certificado\n\n---\n\n### Error 500 - No se pudo almacenar\n```json\n{\n \"message\": \"El certificado no pudo ser almacenado.\",\n \"payload\": \"Error details...\"\n}\n```\n**Causa:** Problema escribiendo en storage o S3\n**Solución:** Verificar permisos de carpeta o configuración de S3\n\n---\n\n## 📚 Información del Certificado Digital\n\n### ¿Qué es?\nCertificado PKCS#12 (.p12 o .pfx) que contiene:\n- Clave privada (para firmar)\n- Clave pública (para verificar)\n- Certificado X.509\n- Cadena de certificación\n\n### ¿Dónde obtenerlo?\nProveedores autorizados por DIAN:\n- GSE (Gestión de Seguridad Electrónica)\n- Certicámara\n- ANDES SCD\n- Otros autorizados\n\n### Vigencia\nNormalmente 1-3 años. Debe renovarse antes de expirar.\n\n---\n\n## 🚀 Siguientes Pasos\n\n1. **Paso 4:** Configurar Resolución de Facturación\n2. Realizar pruebas (TestSet)\n3. Iniciar facturación\n\n---\n\n## 💡 Ejemplo cURL\n\n```bash\ncurl -X PUT \"http://apidian2026-8.oo/api/ubl2.1/config/certificate\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer {token}\" \\\n -d '{\n \"certificate\": \"MIACAQMwgAYJKoZIhvcNAQcBoIAk...\",\n \"password\": \"mi_password\"\n }'\n```" }, "response": [] }, { "name": "Paso 4 - Config-Resolution", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"type_document_id\": 1,\r\n\t\"prefix\": \"SETP\",\r\n\t\"resolution\": \"18760000001\",\r\n\t\"resolution_date\": \"2019-01-19\",\r\n\t\"technical_key\": \"fc8eac422eba16e22ffd8c6f94b3f40a6e38162c\",\r\n\t\"from\": 990000000,\r\n\t\"to\": 995000000,\r\n\t\"generated_to_date\": 0,\r\n\t\"date_from\": \"2019-01-19\",\r\n\t\"date_to\": \"2030-01-19\"\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/config/resolution", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "config", "resolution" ] }, "description": "# PASO 4 - CONFIGURAR RESOLUCIÓN DE FACTURACIÓN\n\n## 📋 Descripción General\nConfigura la resolución de facturación electrónica autorizada por la DIAN. Esta resolución define el rango de numeración autorizado y la clave técnica para firmar documentos.\n\n**Request Handler:** `ConfigurationController@storeResolution` \n**Request Validation:** `ConfigurationResolutionRequest` \n**Modelo:** `Resolution`\n\n### 🔄 Comportamiento\n- Crea nueva resolución para el tipo de documento especificado\n- Valida rangos de numeración (from < to)\n- Almacena información del documento 1876 de DIAN\n- Permite múltiples resoluciones por tipo de documento\n- Transaccional con DB transaction\n\n---\n\n## 🔗 URL del Endpoint\n\n```\nPUT /api/ubl2.1/config/resolution\n```\n\n**Desarrollo local:**\n```\nhttp://apidian2026-8.oo/api/ubl2.1/config/resolution\n```\n\n---\n\n## 🔐 Autenticación\n**Requiere Bearer Token**\n\n```\nAuthorization: Bearer {api_token}\n```\n\n---\n\n## 📤 Cuerpo de la Solicitud (JSON)\n\n### Estructura para Facturas (type_document_id: 1)\n```json\n{\n \"type_document_id\": 1,\n \"prefix\": \"SETP\",\n \"resolution\": \"18760000001\",\n \"resolution_date\": \"2019-01-19\",\n \"technical_key\": \"fc8eac422eba16e22ffd8c6f94b3f40a6e38162c\",\n \"from\": 990000000,\n \"to\": 995000000,\n \"generated_to_date\": 0,\n \"date_from\": \"2019-01-19\",\n \"date_to\": \"2030-01-19\"\n}\n```\n\n### Campos\n| Campo | Tipo | Validación | Descripción |\n|-------|------|------------|-------------|\n| `type_document_id` | integer | required, exists:type_documents | Tipo de documento (1=Factura, 4=NC, 5=ND) |\n| `prefix` | string | nullable, max:5 | Prefijo de numeración (ej: \"SETP\", \"FE\") |\n| `resolution` | string | required_if:type_document_id,1 | Número de resolución DIAN |\n| `resolution_date` | date | required_if:type_document_id,1 | Fecha de la resolución (Y-m-d) |\n| `technical_key` | string | required_if:type_document_id,1 | Clave técnica DIAN |\n| `from` | integer | required | Número inicial del rango |\n| `to` | integer | required, min:from+1 | Número final del rango |\n| `generated_to_date` | integer | nullable | Consecutivo actual (default: 0) |\n| `date_from` | date | required_if:type_document_id,1 | Fecha inicio vigencia (Y-m-d) |\n| `date_to` | date | required_if:type_document_id,1, after:date_from | Fecha fin vigencia (Y-m-d) |\n| `delete_all_type_resolutions` | boolean | nullable | Eliminar todas las resoluciones de este tipo antes de crear |\n\n---\n\n## 📊 Tipos de Documentos\n\n| type_document_id | Tipo | Requiere Resolución DIAN |\n|------------------|------|------------------------|\n| 1 | Factura de Venta | ✅ Sí |\n| 4 | Nota Crédito | ❌ No |\n| 5 | Nota Débito | ❌ No |\n| 7 | Documento Soporte | ✅ Sí |\n| 10 | Factura de Exportación | ✅ Sí |\n| 11 | Nota Crédito Exportación | ❌ No |\n\n---\n\n## 🔑 Clave Técnica (technical_key)\n\n### Ambiente de Habilitación\n**Siempre usar esta clave:**\n```\nfc8eac422eba16e22ffd8c6f94b3f40a6e38162c\n```\n\n### Ambiente de Producción\n\n**Obtener del endpoint:**\n```\nGET /api/ubl2.1/getnumberingrange\n```\nO consultar en el documento 1876 de DIAN.\n\n---\n\n## 📄 Documento 1876 de DIAN\n\nAl solicitar una resolución de facturación, la DIAN emite el **documento 1876** que contiene:\n\n- **Número de resolución:** `resolution`\n- **Fecha de resolución:** `resolution_date`\n- **Prefijo autorizado:** `prefix`\n- **Rango de numeración:** `from` - `to`\n- **Vigencia:** `date_from` - `date_to`\n- **Clave técnica:** `technical_key`\n\n**Todos estos datos deben coincidir exactamente** con los enviados en este endpoint.\n\n---\n\n## 🗄️ Estructura en Base de Datos\n\n### Tabla: `resolutions`\n```sql\nINSERT resolutions (\n company_id, -- ID de la compañía (automático)\n type_document_id, -- del request\n prefix, -- del request\n resolution, -- del request\n resolution_date, -- del request\n technical_key, -- del request\n from, -- del request\n to, -- del request\n generated_to_date, -- del request o 0\n date_from, -- del request\n date_to, -- del request\n created_at,\n updated_at\n)\n```\n\n---\n\n## 📥 Respuesta Exitosa\n\n```json\n{\n \"success\": true,\n \"message\": \"Resolución creada con éxito\",\n \"resolution\": {\n \"id\": 1,\n \"type_document_id\": 1,\n \"prefix\": \"SETP\",\n \"resolution\": \"18760000001\",\n \"resolution_date\": \"2019-01-19\",\n \"technical_key\": \"fc8eac422eba16e22ffd8c6f94b3f40a6e38162c\",\n \"from\": 990000000,\n \"to\": 995000000,\n \"generated_to_date\": 0,\n \"date_from\": \"2019-01-19\",\n \"date_to\": \"2030-01-19\"\n }\n}\n```\n\n---\n\n## ❌ Errores Comunes\n\n### Error 422 - Validación\n```json\n{\n \"message\": \"The given data was invalid.\",\n \"errors\": {\n \"to\": [\"El campo to debe ser mayor que from.\"],\n \"technical_key\": [\"El campo technical key es requerido cuando type document id es 1.\"]\n }\n}\n```\n\n**Causas:**\n- `to` menor o igual que `from`\n- Falta `technical_key` para facturas (type_document_id=1)\n- Formato de fecha incorrecto (debe ser Y-m-d)\n- `date_to` anterior a `date_from`\n\n---\n\n### Clave Técnica Incorrecta en Producción\n**Síntoma:** DIAN rechaza documentos\n```xml\n\n Regla: FAD07, Rechazo: Clave técnica inválida\n\n```\n**Solución:** Consultar clave técnica real con endpoint `getnumberingrange`\n\n---\n\n## 🚀 Siguientes Pasos\n\n1. **Paso 5:** Configurar Resolución de Notas Crédito\n2. **Paso 6:** Configurar Resolución de Notas Débito\n3. Enviar facturas de prueba (TestSet)\n4. Solicitar habilitación a producción\n\n---\n\n## 💡 Ejemplo cURL\n\n```bash\ncurl -X PUT \"http://apidian2026-8.oo/api/ubl2.1/config/resolution\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer {token}\" \\\n -d '{\n \"type_document_id\": 1,\n \"prefix\": \"SETP\",\n \"resolution\": \"18760000001\",\n \"resolution_date\": \"2019-01-19\",\n \"technical_key\": \"fc8eac422eba16e22ffd8c6f94b3f40a6e38162c\",\n \"from\": 990000000,\n \"to\": 995000000,\n \"date_from\": \"2019-01-19\",\n \"date_to\": \"2030-01-19\"\n }'\n```" }, "response": [] }, { "name": "Paso 5 - Config-Resolution NC", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "type": "text", "value": "application/json" }, { "key": "accept", "type": "text", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"type_document_id\": 4,\r\n\t\"from\": 1,\r\n\t\"to\": 99999999,\r\n\t\"prefix\": \"NC\"\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/config/resolution", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "config", "resolution" ] }, "description": "# PASO 5 - CONFIGURAR RESOLUCIÓN DE NOTAS CRÉDITO\n\n## 📋 Descripción General\nConfigura la numeración para Notas Crédito. A diferencia de las facturas, las Notas Crédito **NO requieren resolución DIAN**, por lo que defines tú mismo el rango de numeración y prefijo.\n\n**Request Handler:** `ConfigurationController@storeResolution` \n**Request Validation:** `ConfigurationResolutionRequest` \n**Modelo:** `Resolution`\n\n### 🔄 Comportamiento\n- Usa el **mismo endpoint** que resolución de facturas\n- **NO requiere** `resolution`, `resolution_date`, `technical_key`, `date_from`, `date_to`\n- Solo requiere `type_document_id`, `prefix`, `from`, `to`\n- Tú defines el rango de numeración libremente\n\n---\n\n## 🔗 URL del Endpoint\n\n```\nPUT /api/ubl2.1/config/resolution\n```\n\n**Es la misma URL del Paso 4**, la diferencia está en el `type_document_id`.\n\n---\n\n## 🔐 Autenticación\n**Requiere Bearer Token**\n\n```\nAuthorization: Bearer {api_token}\n```\n\n---\n\n## 📤 Cuerpo de la Solicitud (JSON)\n\n### Estructura para Notas Crédito\n```json\n{\n \"type_document_id\": 4,\n \"prefix\": \"NC\",\n \"from\": 1,\n \"to\": 99999999\n}\n```\n\n### Campos\n| Campo | Tipo | Validación | Descripción |\n|-------|------|------------|-------------|\n| `type_document_id` | integer | required | **4** = Nota Crédito |\n| `prefix` | string | nullable, max:5 | Prefijo de tu elección (\"NC\", \"NCR\", etc.) |\n| `from` | integer | required | Número inicial (tú lo defines) |\n| `to` | integer | required, min:from+1 | Número final (tú lo defines) |\n| `generated_to_date` | integer | nullable | Consecutivo actual (default: 0) |\n\n### ❌ Campos NO Requeridos\nEstos campos son opcionales para Notas Crédito:\n- `resolution`\n- `resolution_date`\n- `technical_key`\n- `date_from`\n- `date_to`\n\n---\n\n## 📊 Diferencias con Factura\n\n| Aspecto | Factura (type_document_id=1) | Nota Crédito (type_document_id=4) |\n|---------|------------------------------|------------------------------------|\n| Resolución DIAN | ✅ Requerida | ❌ No requerida |\n| `resolution` | ✅ Obligatorio | ❌ No aplica |\n| `technical_key` | ✅ Obligatorio | ❌ No aplica |\n| `date_from` / `date_to` | ✅ Obligatorio | ❌ No aplica |\n| Rango `from`-`to` | DIAN lo define | Tú lo defines libremente |\n| `prefix` | DIAN lo autoriza | Tú lo defines libremente |\n\n---\n\n## 💡 Recomendaciones de Numeración\n\n### Opción 1: Rango Grande\n```json\n{\n \"type_document_id\": 4,\n \"prefix\": \"NC\",\n \"from\": 1,\n \"to\": 99999999\n}\n```\nVentaja: No te preocupas por quedarte sin números.\n\n### Opción 2: Rango Controlado\n```json\n{\n \"type_document_id\": 4,\n \"prefix\": \"NCR\",\n \"from\": 1000,\n \"to\": 9999\n}\n```\nVentaja: Numeración más controlada y profesional.\n\n### Opción 3: Múltiples Prefijos\nPuedes crear varias resoluciones con diferentes prefijos:\n- `NC` para notas crédito normales\n- `NCD` para notas crédito de devolución\n- `NCA` para notas crédito de ajuste\n\n---\n\n## 📥 Respuesta Exitosa\n\n```json\n{\n \"success\": true,\n \"message\": \"Resolución creada con éxito\",\n \"resolution\": {\n \"id\": 2,\n \"type_document_id\": 4,\n \"prefix\": \"NC\",\n \"from\": 1,\n \"to\": 99999999,\n \"generated_to_date\": 0\n }\n}\n```\n\n---\n\n## ❌ Errores Comunes\n\n### Error 422 - to menor que from\n```json\n{\n \"errors\": {\n \"to\": [\"El campo to debe ser mayor que from.\"]\n }\n}\n```\n**Solución:** Asegurar que `to` > `from`\n\n---\n\n## 🚀 Siguientes Pasos\n\n1. **Paso 6:** Configurar Resolución de Notas Débito (similar a este)\n2. Enviar Notas Crédito de prueba\n3. Validar numeración consecutiva\n\n---\n\n## 💡 Ejemplo cURL\n\n```bash\ncurl -X PUT \"http://apidian2026-8.oo/api/ubl2.1/config/resolution\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer {token}\" \\\n -d '{\n \"type_document_id\": 4,\n \"prefix\": \"NC\",\n \"from\": 1,\n \"to\": 99999999\n }'\n```\n\n---\n\n## 📌 Nota Importante\nLas Notas Crédito **deben referenciar** una factura existente en su XML. Aunque no requieren resolución DIAN para la numeración, sí deben cumplir con todas las validaciones UBL 2.1 de la DIAN." }, "response": [] }, { "name": "Paso 6 - Config-Resolution ND", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"type_document_id\": 5,\r\n\t\"from\": 1,\r\n\t\"to\": 99999999,\r\n\t\"prefix\": \"ND\"\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/config/resolution", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "config", "resolution" ] }, "description": "# PASO 6 - CONFIGURAR RESOLUCIÓN DE NOTAS DÉBITO\n\n## 📋 Descripción General\nConfigura la numeración para Notas Débito. Al igual que las Notas Crédito, las Notas Débito **NO requieren resolución DIAN**, permitiéndote definir libremente el rango de numeración y prefijo.\n\n**Request Handler:** `ConfigurationController@storeResolution` \n**Request Validation:** `ConfigurationResolutionRequest` \n**Modelo:** `Resolution`\n\n### 🔄 Comportamiento\n- Usa el **mismo endpoint** que facturas y notas crédito\n- **NO requiere** `resolution`, `resolution_date`, `technical_key`, `date_from`, `date_to`\n- Solo requiere `type_document_id`, `prefix`, `from`, `to`\n- Tú defines el rango de numeración libremente\n\n---\n\n## 🔗 URL del Endpoint\n\n```\nPUT /api/ubl2.1/config/resolution\n```\n\n**Es la misma URL del Paso 4**, la diferencia está en el `type_document_id`.\n\n---\n\n## 🔐 Autenticación\n**Requiere Bearer Token**\n\n```\nAuthorization: Bearer {api_token}\n```\n\n---\n\n## 📤 Cuerpo de la Solicitud (JSON)\n\n### Estructura para Notas Débito\n```json\n{\n \"type_document_id\": 5,\n \"prefix\": \"ND\",\n \"from\": 1,\n \"to\": 99999999\n}\n```\n\n### Campos\n| Campo | Tipo | Validación | Descripción |\n|-------|------|------------|-------------|\n| `type_document_id` | integer | required | **5** = Nota Débito |\n| `prefix` | string | nullable, max:5 | Prefijo de tu elección (\"ND\", \"NDB\", etc.) |\n| `from` | integer | required | Número inicial (tú lo defines) |\n| `to` | integer | required, min:from+1 | Número final (tú lo defines) |\n| `generated_to_date` | integer | nullable | Consecutivo actual (default: 0) |\n\n### ❌ Campos NO Requeridos\nEstos campos son opcionales para Notas Débito:\n- `resolution`\n- `resolution_date`\n- `technical_key`\n- `date_from`\n- `date_to`\n\n---\n\n## 📊 ¿Qué es una Nota Débito?\n\nUna Nota Débito es un documento que **incrementa** el valor de una factura por:\n- **Intereses de mora** por pago tardío\n- **Gastos adicionales** no incluidos en la factura original\n- **Corrección de errores** cuando se cobró de menos\n- **Recargos** por servicios extras\n\nDiferencia con Nota Crédito:\n- **Nota Crédito** → DISMINUYE el valor (devoluciones, descuentos)\n- **Nota Débito** → AUMENTA el valor (intereses, recargos)\n\n---\n\n## 💡 Recomendaciones de Numeración\n\n### Opción 1: Rango Grande\n```json\n{\n \"type_document_id\": 5,\n \"prefix\": \"ND\",\n \"from\": 1,\n \"to\": 99999999\n}\n```\nVentaja: No te preocupas por quedarte sin números.\n\n### Opción 2: Rango Controlado\n```json\n{\n \"type_document_id\": 5,\n \"prefix\": \"NDB\",\n \"from\": 1000,\n \"to\": 9999\n}\n```\nVentaja: Numeración más controlada y profesional.\n\n### Opción 3: Múltiples Prefijos\nPuedes crear varias resoluciones con diferentes prefijos:\n- `ND` para notas débito normales\n- `NDI` para notas débito de intereses\n- `NDR` para notas débito de recargos\n\n---\n\n## 📥 Respuesta Exitosa\n\n```json\n{\n \"success\": true,\n \"message\": \"Resolución creada con éxito\",\n \"resolution\": {\n \"id\": 3,\n \"type_document_id\": 5,\n \"prefix\": \"ND\",\n \"from\": 1,\n \"to\": 99999999,\n \"generated_to_date\": 0\n }\n}\n```\n\n---\n\n## ❌ Errores Comunes\n\n### Error 422 - to menor que from\n```json\n{\n \"errors\": {\n \"to\": [\"El campo to debe ser mayor que from.\"]\n }\n}\n```\n**Solución:** Asegurar que `to` > `from`\n\n---\n\n## 🚀 Siguientes Pasos\n\n1. **Paso 7:** Configurar Software de Nómina (si aplica)\n2. **Paso 8:** Configurar Resolución de Documentos Soporte (si aplica)\n3. Enviar Notas Débito de prueba\n4. Validar numeración consecutiva\n\n---\n\n## 💡 Ejemplo cURL\n\n```bash\ncurl -X PUT \"http://apidian2026-8.oo/api/ubl2.1/config/resolution\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer {token}\" \\\n -d '{\n \"type_document_id\": 5,\n \"prefix\": \"ND\",\n \"from\": 1,\n \"to\": 99999999\n }'\n```\n\n---\n\n## 📌 Nota Importante\nLas Notas Débito **deben referenciar** una factura existente en su XML. Aunque no requieren resolución DIAN para la numeración, sí deben cumplir con todas las validaciones UBL 2.1 de la DIAN.\n\n## 📋 Resumen de Resoluciones Configuradas\n\nAl finalizar los Pasos 4-6, deberías tener:\n\n| Paso | Tipo | type_document_id | Resolución DIAN |\n|------|------|------------------|------------------|\n| Paso 4 | Factura | 1 | ✅ Sí (documento 1876) |\n| Paso 5 | Nota Crédito | 4 | ❌ No (libre) |\n| Paso 6 | Nota Débito | 5 | ❌ No (libre) |" }, "response": [] }, { "name": "Paso 7 - Config-Software Payroll", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "cache-control", "value": "no-cache", "type": "text" }, { "key": "Connection", "value": "keep-alive", "type": "text" }, { "key": "Accept-Encoding", "value": "gzip, deflate", "type": "text" }, { "key": "Host", "value": "apidian2026-8.oo", "type": "text", "disabled": true }, { "key": "accept", "value": "application/json", "type": "text" }, { "key": "X-CSRF-TOKEN", "value": "", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"idpayroll\": \"fae3162f-c29d-4f5d-b84b-42bf53c75e88\",\r\n\t\"pinpayroll\": 12345\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/config/softwarepayroll", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "config", "softwarepayroll" ] }, "description": "# PASO 7 - CONFIGURAR SOFTWARE DE NÓMINA ELECTRÓNICA\n\n## 📋 Descripción General\nConfigura el software de nómina electrónica registrado ante la DIAN. Este paso es **OPCIONAL** y solo se requiere si vas a emitir documentos de nómina electrónica.\n\n**Request Handler:** `ConfigurationController@storeSoftwarePayroll` \n**Request Validation:** `ConfigurationSoftwarePayrollRequest` \n**Modelo:** `Software` (campos payroll)\n\n### 🔄 Comportamiento\n- Actualiza los campos `identifier_payroll`, `pin_payroll`, `url_payroll` en la tabla `softwares`\n- Si no existe registro de software, lo crea\n- NO afecta la configuración de software de facturación (Paso 2)\n- Transaccional con DB transaction\n\n---\n\n## 🔗 URL del Endpoint\n\n```\nPUT /api/ubl2.1/config/softwarepayroll\n```\n\n---\n\n## 🔐 Autenticación\n**Requiere Bearer Token**\n\n```\nAuthorization: Bearer {api_token}\n```\n\n---\n\n## 📤 Cuerpo de la Solicitud (JSON)\n\n```json\n{\n \"idpayroll\": \"fae3162f-c29d-4f5d-b84b-42bf53c75e88\",\n \"pinpayroll\": 12345\n}\n```\n\n### Campos\n| Campo | Tipo | Validación | Descripción |\n|-------|------|------------|-------------|\n| `idpayroll` | string (UUID) | required | ID del software de nómina otorgado por DIAN |\n| `pinpayroll` | integer | required | PIN de 5 dígitos que definiste al registrar el software |\n\n---\n\n## 📚 ¿Cómo obtener estos datos?\n\n### 1. Registrar Software en DIAN\n1. Ingresar al portal de la DIAN\n2. Ir a **Facturación Electrónica > Registro de Software**\n3. Seleccionar **\"Software de Nómina Electrónica\"**\n4. Registrar tu software con modo \"Software Propio\"\n5. Definir un PIN de 5 dígitos\n\n### 2. DIAN entrega\n- **Software ID** (`idpayroll`): UUID único\n- **PIN**: El que tú definiste\n\n---\n\n## 🗄️ Estructura en Base de Datos\n\n### Tabla: `softwares`\n```sql\nUPDATE softwares SET\n identifier_payroll = :idpayroll,\n pin_payroll = :pinpayroll,\n url_payroll = 'https://catalogo-vpfe.dian.gov.co/Document/FindDocument?documentKey={CUNE}&partitionKey={PARTITION_KEY}&emissionDate={FECHA}'\nWHERE company_id = :company_id\n```\n\n---\n\n## 📥 Respuesta Exitosa\n\n```json\n{\n \"success\": true,\n \"message\": \"Software de nómina configurado correctamente\",\n \"software\": {\n \"id\": 1,\n \"identifier_payroll\": \"fae3162f-c29d-4f5d-b84b-42bf53c75e88\",\n \"pin_payroll\": 12345,\n \"url_payroll\": \"https://catalogo-vpfe.dian.gov.co/Document/FindDocument?documentKey={CUNE}&partitionKey={PARTITION_KEY}&emissionDate={FECHA}\"\n }\n}\n```\n\n---\n\n## ❌ Errores Comunes\n\n### Error 422 - Validación\n```json\n{\n \"errors\": {\n \"idpayroll\": [\"El campo idpayroll es requerido.\"],\n \"pinpayroll\": [\"El campo pinpayroll es requerido.\"]\n }\n}\n```\n\n---\n\n## 🚀 Siguientes Pasos\n\n1. **Paso 8:** Configurar Resolución de Nómina Individual\n2. **Paso 9:** Configurar Resolución de Notas de Ajuste a Nómina\n3. Enviar nóminas de prueba\n\n---\n\n## 💡 Ejemplo cURL\n\n```bash\ncurl -X PUT \"http://apidian2026-8.oo/api/ubl2.1/config/softwarepayroll\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer {token}\" \\\n -d '{\n \"idpayroll\": \"fae3162f-c29d-4f5d-b84b-42bf53c75e88\",\n \"pinpayroll\": 12345\n }'\n```\n\n---\n\n## 📌 Nota Importante\nEste endpoint es **OPCIONAL**. Solo configúralo si tu empresa emite nómina electrónica. Si solo emites facturas, puedes omitir los Pasos 7, 8 y 9." }, "response": [] }, { "name": "Paso 8 - Config-Resolution Payroll", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"type_document_id\": 9,\r\n\t\"from\": 1,\r\n\t\"to\": 99999999,\r\n\t\"prefix\": \"NI\"\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/config/resolution", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "config", "resolution" ] }, "description": "# PASO 8 - CONFIGURAR RESOLUCIÓN DE NÓMINA INDIVIDUAL\n\n## 📋 Descripción General\nConfigura la numeración para Nómina Individual (Recibo de Pago). La nómina electrónica **NO requiere resolución DIAN**, defines tú mismo el rango de numeración.\n\n**Request Handler:** `ConfigurationController@storeResolution` \n**Request Validation:** `ConfigurationResolutionRequest` \n**Modelo:** `Resolution`\n\n### 🔄 Comportamiento\n- Usa el mismo endpoint de resoluciones\n- Solo requiere `type_document_id`, `prefix`, `from`, `to`\n- Numeración libre\n- Este paso es **OPCIONAL** (solo si emites nómina)\n\n---\n\n## 🔗 URL del Endpoint\n\n```\nPUT /api/ubl2.1/config/resolution\n```\n\n---\n\n## 📤 Cuerpo de la Solicitud (JSON)\n\n```json\n{\n \"type_document_id\": 9,\n \"prefix\": \"NI\",\n \"from\": 1,\n \"to\": 99999999\n}\n```\n\n### Campos\n| Campo | Tipo | Validación | Descripción |\n|-------|------|------------|-------------|\n| `type_document_id` | integer | required | **9** = Nómina Individual |\n| `prefix` | string | nullable, max:5 | Prefijo (\"NI\", \"NOM\", etc.) |\n| `from` | integer | required | Número inicial |\n| `to` | integer | required | Número final |\n\n---\n\n## 📊 Tipos de Documentos de Nómina\n\n| type_document_id | Tipo | Descripción |\n|------------------|------|-------------|\n| 9 | Nómina Individual | Recibo de pago mensual/quincenal |\n| 10 | Nota de Ajuste | Correcciones a nóminas |\n\n---\n\n## 📥 Respuesta Exitosa\n\n```json\n{\n \"success\": true,\n \"message\": \"Resolución creada con éxito\",\n \"resolution\": {\n \"id\": 4,\n \"type_document_id\": 9,\n \"prefix\": \"NI\",\n \"from\": 1,\n \"to\": 99999999\n }\n}\n```\n\n---\n\n## 🚀 Siguientes Pasos\n\n1. **Paso 9:** Configurar Resolución de Notas de Ajuste\n2. Enviar nóminas de prueba\n\n---\n\n## 💡 Ejemplo cURL\n\n```bash\ncurl -X PUT \"http://apidian2026-8.oo/api/ubl2.1/config/resolution\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer {token}\" \\\n -d '{\n \"type_document_id\": 9,\n \"prefix\": \"NI\",\n \"from\": 1,\n \"to\": 99999999\n }'\n```" }, "response": [] }, { "name": "Paso 9 - Config-Resolution Payroll Note", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"type_document_id\": 10,\r\n\t\"from\": 1,\r\n\t\"to\": 99999999,\r\n\t\"prefix\": \"NA\"\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/config/resolution", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "config", "resolution" ] }, "description": "# PASO 9 - CONFIGURAR RESOLUCIÓN DE NOTAS DE AJUSTE A NÓMINA\n\n## 📋 Descripción General\nConfigura la numeración para Notas de Ajuste a Nómina. Estas notas se usan para corregir o ajustar nóminas previamente emitidas. **NO requiere resolución DIAN**.\n\n**Request Handler:** `ConfigurationController@storeResolution` \n**Request Validation:** `ConfigurationResolutionRequest` \n**Modelo:** `Resolution`\n\n---\n\n## 🔗 URL del Endpoint\n\n```\nPUT /api/ubl2.1/config/resolution\n```\n\n---\n\n## 📤 Cuerpo de la Solicitud (JSON)\n\n```json\n{\n \"type_document_id\": 10,\n \"prefix\": \"NA\",\n \"from\": 1,\n \"to\": 99999999\n}\n```\n\n### Campos\n| Campo | Tipo | Validación | Descripción |\n|-------|------|------------|-------------|\n| `type_document_id` | integer | required | **10** = Nota de Ajuste a Nómina |\n| `prefix` | string | nullable | Prefijo (\"NA\", \"NADJ\", etc.) |\n| `from` | integer | required | Número inicial |\n| `to` | integer | required | Número final |\n\n---\n\n## 📊 ¿Cuándo usar Notas de Ajuste?\n\nLas Notas de Ajuste a Nómina se usan para:\n- **Eliminar** una nómina emitida por error\n- **Reemplazar** una nómina con datos incorrectos\n- **Corregir** valores en nóminas ya enviadas\n\n### Tipos de Ajuste\n1. **Eliminación:** Anula completamente la nómina\n2. **Reemplazo:** Sustituye la nómina por una nueva versión\n\n---\n\n## 📥 Respuesta Exitosa\n\n```json\n{\n \"success\": true,\n \"message\": \"Resolución creada con éxito\",\n \"resolution\": {\n \"id\": 5,\n \"type_document_id\": 10,\n \"prefix\": \"NA\",\n \"from\": 1,\n \"to\": 99999999\n }\n}\n```\n\n---\n\n## 🚀 Siguientes Pasos\n\n1. **Paso 10:** Configurar Documentos Soporte (si aplica)\n2. Enviar nóminas y notas de ajuste de prueba\n\n---\n\n## 💡 Ejemplo cURL\n\n```bash\ncurl -X PUT \"http://apidian2026-8.oo/api/ubl2.1/config/resolution\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer {token}\" \\\n -d '{\n \"type_document_id\": 10,\n \"prefix\": \"NA\",\n \"from\": 1,\n \"to\": 99999999\n }'\n```\n\n---\n\n## 📌 Nota Importante\nEste endpoint es **OPCIONAL**. Solo configúralo si tu empresa emite nómina electrónica y necesitas hacer ajustes a las nóminas." }, "response": [] }, { "name": "Paso 10 - Config-Resolution Support Document", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"type_document_id\": 11,\r\n\t\"prefix\": \"SEDS\",\r\n\t\"resolution\": \"18760000001\",\r\n\t\"resolution_date\": \"2025-01-01\",\r\n\t\"from\": 984000000,\r\n\t\"to\": 985000000,\r\n\t\"generated_to_date\": 0,\r\n\t\"date_from\": \"2025-01-01\",\r\n\t\"date_to\": \"2025-12-31\"\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/config/resolution", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "config", "resolution" ] }, "description": "# PASO 10 - CONFIGURAR RESOLUCIÓN DE DOCUMENTOS SOPORTE\n\n## 📋 Descripción General\nConfigura la resolución para Documentos Soporte en adquisiciones realizadas a **sujetos no obligados a facturar** (personas naturales, régimen simplificado). **REQUIERE autorización DIAN** mediante documento 1876.\n\n**Request Handler:** `ConfigurationController@storeResolution` \n**Request Validation:** `ConfigurationResolutionRequest` \n**Modelo:** `Resolution`\n\n---\n\n## 🔗 URL del Endpoint\n\n```\nPUT /api/ubl2.1/config/resolution\n```\n\n---\n\n## 📤 Cuerpo de la Solicitud (JSON)\n\n```json\n{\n \"type_document_id\": 11,\n \"prefix\": \"SEDS\",\n \"resolution\": \"18760000001\",\n \"resolution_date\": \"2025-01-01\",\n \"from\": 984000000,\n \"to\": 985000000,\n \"generated_to_date\": 0,\n \"date_from\": \"2025-01-01\",\n \"date_to\": \"2025-12-31\"\n}\n```\n\n### Campos Requeridos\n| Campo | Tipo | Validación | Descripción |\n|-------|------|------------|-------------|\n| `type_document_id` | integer | required | **11** = Documento Soporte |\n| `prefix` | string | required | Prefijo autorizado (ej: \"SEDS\", \"DS\") |\n| `resolution` | string | required | Número documento 1876 |\n| `resolution_date` | date | required | Fecha emisión documento 1876 |\n| `from` | integer | required | Número inicial autorizado |\n| `to` | integer | required | Número final autorizado |\n| `generated_to_date` | integer | required | Consecutivo actual (usar 0 inicio) |\n| `date_from` | date | required | Fecha inicio vigencia |\n| `date_to` | date | required | Fecha fin vigencia |\n\n⚠️ **NOTA:** Este tipo de documento **NO requiere** el campo `technical_key`\n\n---\n\n## 📊 ¿Qué son los Documentos Soporte?\n\nLos Documentos Soporte se usan cuando tu empresa compra productos/servicios a:\n- ✅ Personas naturales no obligadas a facturar\n- ✅ Productores agropecuarios\n- ✅ Régimen simplificado\n\nReemplazan la factura de compra y permiten soportar costos/deducciones fiscales.\n\n---\n\n## 🔍 Validación en ConfigurationResolutionRequest\n\n```php\n'resolution' => 'required_if:type_document_id,1,2,11',\n'resolution_date' => 'required_if:type_document_id,1,2,11',\n'date_from' => 'required_if:type_document_id,1,2,11',\n'date_to' => 'required_if:type_document_id,1,2,11',\n```\n\nTipo 11 requiere los mismos campos que Facturas (1) y Exportación (2), **excepto** `technical_key`.\n\n---\n\n## 🗄️ Almacenamiento en Base de Datos\n\n**Tabla:** `resolutions`\n\n```sql\ntype_document_id = 11\nprefix = 'SEDS'\nresolution = '18760000001'\nresolution_date = '2025-01-01'\nnext = 984000000 (from)\nfrom = 984000000\nto = 985000000\ndate_from = '2025-01-01'\ndate_to = '2025-12-31'\ntechnical_key = NULL\n```\n\n---\n\n## 📥 Respuesta Exitosa\n\n```json\n{\n \"success\": true,\n \"message\": \"Resolución creada con éxito\",\n \"resolution\": {\n \"id\": 6,\n \"type_document_id\": 11,\n \"prefix\": \"SEDS\",\n \"resolution\": \"18760000001\",\n \"from\": 984000000,\n \"to\": 985000000\n }\n}\n```\n\n---\n\n## ❌ Errores Comunes\n\n| Código | Descripción | Solución |\n|--------|-------------|----------|\n| 422 | `resolution required` | Incluir número documento 1876 |\n| 422 | `date_from required` | Incluir fechas de vigencia |\n| 422 | `from must be less than to` | Verificar rango numérico |\n\n---\n\n## 💡 Ejemplo cURL\n\n```bash\ncurl -X PUT \"http://apidian2026-8.oo/api/ubl2.1/config/resolution\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer {token}\" \\\n -d '{\n \"type_document_id\": 11,\n \"prefix\": \"SEDS\",\n \"resolution\": \"18760000001\",\n \"resolution_date\": \"2025-01-01\",\n \"from\": 984000000,\n \"to\": 985000000,\n \"generated_to_date\": 0,\n \"date_from\": \"2025-01-01\",\n \"date_to\": \"2025-12-31\"\n }'\n```\n\n---\n\n## 🚀 Siguientes Pasos\n\n1. **Paso 11:** Configurar NC de Documentos Soporte (si aplica)\n2. Enviar documentos soporte de prueba" }, "response": [] }, { "name": "Paso 11 - Config-Resolution NC Support Document", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "type": "text", "value": "application/json" }, { "key": "accept", "type": "text", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"type_document_id\": 13,\r\n\t\"from\": 1,\r\n\t\"to\": 99999999,\r\n\t\"prefix\": \"NDS\"\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/config/resolution", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "config", "resolution" ] }, "description": "# PASO 11 - CONFIGURAR RESOLUCIÓN DE NC DOCUMENTOS SOPORTE\n\n## 📋 Descripción General\nConfigura la numeración para Notas Crédito de Documentos Soporte. Se usan para anular o ajustar documentos soporte previamente emitidos. **NO requiere resolución DIAN** (numeración libre).\n\n**Request Handler:** `ConfigurationController@storeResolution` \n**Request Validation:** `ConfigurationResolutionRequest` \n**Modelo:** `Resolution`\n\n---\n\n## 🔗 URL del Endpoint\n\n```\nPUT /api/ubl2.1/config/resolution\n```\n\n---\n\n## 📤 Cuerpo de la Solicitud (JSON)\n\n```json\n{\n \"type_document_id\": 13,\n \"prefix\": \"NDS\",\n \"from\": 1,\n \"to\": 99999999\n}\n```\n\n### Campos\n| Campo | Tipo | Validación | Descripción |\n|-------|------|------------|-------------|\n| `type_document_id` | integer | required | **13** = NC Documento Soporte |\n| `prefix` | string | nullable | Prefijo (\"NDS\", \"NCDS\", etc.) |\n| `from` | integer | required | Número inicial |\n| `to` | integer | required | Número final |\n\n---\n\n## 📊 Diferencias entre Tipos de Notas\n\n| Documento | type_document_id | Requiere DIAN | Uso |\n|-----------|------------------|---------------|-----|\n| NC Factura | 4 | ❌ No | Anula/ajusta facturas |\n| NC Documento Soporte | **13** | ❌ No | Anula/ajusta docs soporte |\n\n---\n\n## 🔍 ¿Cuándo usar NC de Documentos Soporte?\n\nEmite una NC de documento soporte cuando necesites:\n- ✅ **Anular** un documento soporte por error\n- ✅ **Corregir** valores en documento soporte\n- ✅ **Devolver** mercancía comprada sin factura\n\n---\n\n## 🗄️ Almacenamiento en Base de Datos\n\n**Tabla:** `resolutions`\n\n```sql\ntype_document_id = 13\nprefix = 'NDS'\nnext = 1 (from)\nfrom = 1\nto = 99999999\nresolution = NULL\nresolution_date = NULL\ntechnical_key = NULL\n```\n\n---\n\n## 📥 Respuesta Exitosa\n\n```json\n{\n \"success\": true,\n \"message\": \"Resolución creada con éxito\",\n \"resolution\": {\n \"id\": 7,\n \"type_document_id\": 13,\n \"prefix\": \"NDS\",\n \"from\": 1,\n \"to\": 99999999\n }\n}\n```\n\n---\n\n## ❌ Errores Comunes\n\n| Código | Descripción | Solución |\n|--------|-------------|----------|\n| 422 | `from required` | Incluir número inicial |\n| 422 | `to required` | Incluir número final |\n| 422 | `from must be less than to` | Verificar rango |\n\n---\n\n## 💡 Ejemplo cURL\n\n```bash\ncurl -X PUT \"http://apidian2026-8.oo/api/ubl2.1/config/resolution\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer {token}\" \\\n -d '{\n \"type_document_id\": 13,\n \"prefix\": \"NDS\",\n \"from\": 1,\n \"to\": 99999999\n }'\n```\n\n---\n\n## 🚀 Siguientes Pasos\n\n1. **Paso 12:** Configurar Documentos Contingencia (si aplica)\n2. Enviar documentos soporte y NC de prueba\n\n---\n\n## 📌 Nota Importante\nEste endpoint es **OPCIONAL**. Solo configúralo si tu empresa emite documentos soporte y necesita anularlos o corregirlos." }, "response": [] }, { "name": "Paso 12 - Config-Resolution Contingency", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"type_document_id\": 3,\r\n\t// Prefijo que entrega la resolución 1876 registrada en la DIAN\r\n\t\"prefix\": \"CN\",\r\n\t// Número de resolución asignado por la DIAN\r\n\t\"resolution\": \"18760000001\",\r\n\t// Fecha de la resolución emitida por la DIAN\r\n\t\"resolution_date\": \"2025-01-01\",\r\n\t// Resoluciones de contingencia no llevan clave técnica\r\n\t\"technical_key\": \"\",\r\n\t\"from\": 1,\r\n\t\"to\": 9999,\r\n\t\"generated_to_date\": 0,\r\n\t// Fecha inicial de vigencia de la resolución\r\n\t\"date_from\": \"2025-01-01\",\r\n\t// Fecha final de vigencia de la resolución = Fecha inicial + vigencia autorizada por la DIAN\r\n\t\"date_to\": \"2030-01-01\"\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/config/resolution", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "config", "resolution" ] }, "description": "# PASO 12 - CONFIGURAR RESOLUCIÓN DE CONTINGENCIA\n\n## 📋 Descripción General\nConfigura la resolución para emitir **Facturas Electrónicas de Contingencia** cuando hay problemas técnicos que impiden la facturación normal. **REQUIERE resolución DIAN específica para contingencia**, pero NO requiere clave técnica.\n\n**Request Handler:** `ConfigurationController@storeResolution` \n**Request Validation:** `ConfigurationResolutionRequest` \n**Modelo:** `Resolution`\n\n---\n\n## 🔗 URL del Endpoint\n\n```\nPUT /api/ubl2.1/config/resolution\n```\n\n---\n\n## 📤 Cuerpo de la Petición (JSON)\n\n```json\n{\n \"type_document_id\": 3,\n \"prefix\": \"FCD\",\n \"resolution\": \"18764019000123\",\n \"resolution_date\": \"2024-03-15\",\n \"from\": 1,\n \"to\": 5000,\n \"generated_to_date\": 0,\n \"date_from\": \"2024-03-15\",\n \"date_to\": \"2026-03-15\"\n}\n```\n\n### 📌 Campos del Body\n\n| Campo | Tipo | Requerido | Descripción |\n|-------|------|-----------|-------------|\n| `type_document_id` | integer | ✅ | **FIJO: 3** (Factura de Contingencia) |\n| `prefix` | string | ❌ | Prefijo para numeración (máx 5 caracteres). Ej: \"FCD\", \"CONT\" |\n| `resolution` | string | ✅ | Número de resolución DIAN para contingencia |\n| `resolution_date` | date | ✅ | Fecha de la resolución (formato: YYYY-MM-DD) |\n| `technical_key` | string | ❌ | **NO SE REQUIERE** para documentos de contingencia |\n| `from` | integer | ✅ | Número inicial del rango autorizado |\n| `to` | integer | ✅ | Número final del rango (debe ser mayor a `from`) |\n| `generated_to_date` | integer | ✅ | Consecutivo actual (inicia en 0, se auto-incrementa) |\n| `date_from` | date | ✅ | Fecha inicial de vigencia (formato: YYYY-MM-DD) |\n| `date_to` | date | ✅ | Fecha final de vigencia (debe ser posterior a `date_from`) |\n\n---\n\n## ⚙️ Comportamiento del Sistema\n\n### 🚨 Escenarios de Contingencia\n- **Fallo del sistema de facturación:** Hardware, software, red local\n- **Fallo de internet:** Sin conexión a DIAN\n- **Fallo de servicios DIAN:** Sistema de validación caído\n- **Fuerza mayor:** Desastres naturales, cortes de energía prolongados\n\n### ⏱️ Plazo de Transmisión\n- Los documentos de contingencia deben enviarse a la DIAN dentro de las **48 horas** siguientes a la restauración del servicio\n- El sistema registra fecha/hora de emisión local durante contingencia\n- Al restaurar servicio: transmisión automática o manual de documentos pendientes\n\n### 🔄 Diferencias con Factura Normal\n\n| Característica | Factura Normal | Factura Contingencia |\n|----------------|----------------|----------------------|\n| type_document_id | 1 | 3 |\n| Clave técnica | ✅ Requerida | ❌ NO requerida |\n| Resolución DIAN | ✅ Requerida | ✅ Requerida (específica) |\n| Numeración | Independiente | Independiente |\n| Transmisión | Inmediata | Diferida (48h) |\n\n---\n\n## 💾 Impacto en Base de Datos\n\n**Tabla:** `resolutions`\n\n```sql\nINSERT INTO resolutions (\n company_id,\n type_document_id, -- 3 (Contingencia)\n prefix,\n resolution,\n resolution_date,\n technical_key, -- NULL para contingencia\n `from`,\n `to`,\n generated_to_date,\n date_from,\n date_to\n) VALUES (...)\n```\n\n---\n\n## ✅ Respuesta Exitosa (200)\n\n```json\n{\n \"success\": true,\n \"message\": \"Resolución de contingencia creada exitosamente\",\n \"resolution_id\": 8\n}\n```\n\n---\n\n## ❌ Errores Comunes\n\n| Código | Escenario | Mensaje |\n|--------|-----------|----------|\n| 422 | type_document_id inválido | \"The type document id field is required\" |\n| 422 | Rango inválido | \"The to must be at least [from+1]\" |\n| 422 | Fechas inválidas | \"The date to must be a date after date from\" |\n| 422 | Resolución duplicada | \"Ya existe una resolución con este número\" |\n| 401 | Sin autenticación | \"Unauthenticated\" |\n\n---\n\n## 🔐 Autenticación\n\nBearer Token en header:\n\n```\nAuthorization: Bearer {api_token}\n```\n\nEl `api_token` se obtiene del **Paso 1 - Config Company**.\n\n---\n\n## 🧪 Ejemplo cURL\n\n```bash\ncurl -X PUT \"http://tu-dominio.com/api/ubl2.1/config/resolution\" \\\n -H \"Authorization: Bearer tu_token_aqui\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Accept: application/json\" \\\n -d '{\n \"type_document_id\": 3,\n \"prefix\": \"FCD\",\n \"resolution\": \"18764019000123\",\n \"resolution_date\": \"2024-03-15\",\n \"from\": 1,\n \"to\": 5000,\n \"generated_to_date\": 0,\n \"date_from\": \"2024-03-15\",\n \"date_to\": \"2026-03-15\"\n }'\n```\n\n---\n\n## 📌 Notas Importantes\n\n✅ **Resolución específica:** DIAN emite resolución separada para contingencia \n✅ **Sin clave técnica:** A diferencia de facturas normales \n✅ **Numeración independiente:** No afecta consecutivo de facturas normales \n✅ **Plazo 48 horas:** Para transmitir después de restaurar servicio \n✅ **Documentación obligatoria:** Justificar causa de contingencia" }, "response": [] }, { "name": "Paso 13 - Config-Resolution Export", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "type": "text", "value": "application/json" }, { "key": "accept", "type": "text", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"type_document_id\": 2,\r\n\t\"prefix\": \"SETP\",\r\n\t\"resolution\": \"18760000001\",\r\n\t\"resolution_date\": \"2019-01-19\",\r\n\t\"technical_key\": \"fc8eac422eba16e22ffd8c6f94b3f40a6e38162c\",\r\n\t\"from\": 990000000,\r\n\t\"to\": 995000000,\r\n\t\"generated_to_date\": 0,\r\n\t\"date_from\": \"2019-01-19\",\r\n\t\"date_to\": \"2030-01-19\"\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/config/resolution", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "config", "resolution" ] }, "description": "# PASO 13 - CONFIGURAR RESOLUCIÓN DE EXPORTACIÓN\n\n## 📋 Descripción General\nConfigura la resolución para emitir **Facturas de Exportación** (ventas internacionales). **REQUIERE resolución DIAN Y clave técnica**, similar a facturas nacionales pero con tipo de documento diferente.\n\n**Request Handler:** `ConfigurationController@storeResolution` \n**Request Validation:** `ConfigurationResolutionRequest` \n**Modelo:** `Resolution`\n\n---\n\n## 🔗 URL del Endpoint\n\n```\nPUT /api/ubl2.1/config/resolution\n```\n\n---\n\n## 📤 Cuerpo de la Petición (JSON)\n\n```json\n{\n \"type_document_id\": 2,\n \"prefix\": \"SETP\",\n \"resolution\": \"18760000001\",\n \"resolution_date\": \"2019-01-19\",\n \"technical_key\": \"fc8eac422eba16e22ffd8c6f94b3f40a6e38162c\",\n \"from\": 990000000,\n \"to\": 995000000,\n \"generated_to_date\": 0,\n \"date_from\": \"2019-01-19\",\n \"date_to\": \"2030-01-19\"\n}\n```\n\n### 📌 Campos del Body\n\n| Campo | Tipo | Requerido | Descripción |\n|-------|------|-----------|-------------|\n| `type_document_id` | integer | ✅ | **FIJO: 2** (Factura de Exportación) |\n| `prefix` | string | ❌ | Prefijo para numeración (máx 5 caracteres). Ej: \"SETP\", \"EXP\" |\n| `resolution` | string | ✅ | Número de resolución DIAN de habilitación |\n| `resolution_date` | date | ✅ | Fecha de la resolución (formato: YYYY-MM-DD) |\n| `technical_key` | string | ✅ | **REQUERIDA:** Clave técnica de habilitación (40 caracteres hexadecimales) |\n| `from` | integer | ✅ | Número inicial del rango autorizado |\n| `to` | integer | ✅ | Número final del rango (debe ser mayor a `from`) |\n| `generated_to_date` | integer | ✅ | Consecutivo actual (inicia en 0, se auto-incrementa) |\n| `date_from` | date | ✅ | Fecha inicial de vigencia (formato: YYYY-MM-DD) |\n| `date_to` | date | ✅ | Fecha final de vigencia (debe ser posterior a `date_from`) |\n\n---\n\n## 🌍 Contexto de Exportación\n\n### Diferencias con Factura Nacional\n\n| Característica | Factura Nacional | Factura Exportación |\n|----------------|------------------|---------------------|\n| type_document_id | 1 | 2 |\n| Tipo de cliente | Nacional (NIT) | Internacional (Tax ID extranjero) |\n| Moneda | COP (peso colombiano) | USD, EUR, etc. (moneda extranjera) |\n| IVA | Aplica tarifas nacionales | **0% (exenta)** |\n| Incoterms | No aplica | **Obligatorio** (FOB, CIF, EXW, etc.) |\n| Información adicional | Básica | Datos aduaneros, puerto embarque |\n| Resolución DIAN | ✅ Requerida | ✅ Requerida (habilitación) |\n| Clave técnica | ✅ Requerida | ✅ Requerida |\n\n### 📦 Campos Específicos en Facturas de Exportación\n- **Incoterms:** FOB, CIF, EXW, DDP, etc.\n- **Delivery terms:** Puerto/aeropuerto de embarque\n- **Moneda:** USD (dólar), EUR (euro), etc.\n- **Tasa de cambio:** TRM oficial del día\n- **Country code:** Código ISO del país destino\n\n---\n\n## ⚙️ Comportamiento del Sistema\n\n### 🔄 Proceso\n1. **Valida** que `type_document_id = 2`\n2. **Verifica** que existan `resolution` y `technical_key`\n3. **Crea** registro en tabla `resolutions`\n4. **Habilita** emisión de facturas de exportación\n5. **Retorna** ID de la resolución creada\n\n### 🚨 Validaciones Especiales\n- `technical_key` es **OBLIGATORIA** para type_document_id = 2\n- Formato: 40 caracteres hexadecimales (proporcionada por DIAN)\n- Rango numérico debe ser válido: `to > from`\n- Fechas de vigencia: `date_to > date_from`\n\n---\n\n## 💾 Impacto en Base de Datos\n\n**Tabla:** `resolutions`\n\n```sql\nINSERT INTO resolutions (\n company_id,\n type_document_id, -- 2 (Exportación)\n prefix,\n resolution,\n resolution_date,\n technical_key, -- REQUERIDA (40 chars hex)\n `from`,\n `to`,\n generated_to_date,\n date_from,\n date_to\n) VALUES (...)\n```\n\n---\n\n## ✅ Respuesta Exitosa (200)\n\n```json\n{\n \"success\": true,\n \"message\": \"Resolución de exportación creada exitosamente\",\n \"resolution_id\": 9\n}\n```\n\n---\n\n## ❌ Errores Comunes\n\n| Código | Escenario | Mensaje |\n|--------|-----------|----------|\n| 422 | Sin technical_key | \"The technical key field is required when type document id is 2\" |\n| 422 | technical_key inválida | \"The technical key format is invalid\" |\n| 422 | Sin resolución | \"The resolution field is required when type document id is 2\" |\n| 422 | Rango inválido | \"The to must be at least [from+1]\" |\n| 422 | Fechas inválidas | \"The date to must be a date after date from\" |\n| 401 | Sin autenticación | \"Unauthenticated\" |\n\n---\n\n## 🔐 Autenticación\n\nBearer Token en header:\n\n```\nAuthorization: Bearer {api_token}\n```\n\nEl `api_token` se obtiene del **Paso 1 - Config Company**.\n\n---\n\n## 🧪 Ejemplo cURL\n\n```bash\ncurl -X PUT \"http://tu-dominio.com/api/ubl2.1/config/resolution\" \\\n -H \"Authorization: Bearer tu_token_aqui\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Accept: application/json\" \\\n -d '{\n \"type_document_id\": 2,\n \"prefix\": \"SETP\",\n \"resolution\": \"18760000001\",\n \"resolution_date\": \"2019-01-19\",\n \"technical_key\": \"fc8eac422eba16e22ffd8c6f94b3f40a6e38162c\",\n \"from\": 990000000,\n \"to\": 995000000,\n \"generated_to_date\": 0,\n \"date_from\": \"2019-01-19\",\n \"date_to\": \"2030-01-19\"\n }'\n```\n\n---\n\n## 📌 Comparación: Type Document IDs\n\n| type_document_id | Tipo | Resolución | Clave Técnica | Numeración |\n|------------------|------|------------|---------------|------------|\n| 1 | Factura Nacional | ✅ Req. | ✅ Req. | Independiente |\n| 2 | Factura Exportación | ✅ Req. | ✅ Req. | Independiente |\n| 3 | Factura Contingencia | ✅ Req. | ❌ NO Req. | Independiente |\n| 4 | Nota Crédito | ❌ NO Req. | ❌ NO Req. | Libre |\n| 5 | Nota Débito | ❌ NO Req. | ❌ NO Req. | Libre |\n\n---\n\n## 📌 Notas Importantes\n\n✅ **Habilitación DIAN:** Proceso de habilitación previo para exportaciones \n✅ **Clave técnica obligatoria:** 40 caracteres hexadecimales \n✅ **IVA 0%:** Facturas de exportación exentas de IVA \n✅ **Incoterms obligatorios:** Definir términos de entrega internacional \n✅ **Moneda extranjera:** Usar códigos ISO (USD, EUR, etc.) \n✅ **TRM oficial:** Tasa representativa del mercado para conversión \n✅ **Numeración independiente:** No afecta consecutivo de facturas nacionales" }, "response": [] } ], "description": "Aqui podras encontrar los requests basicos para configurar la empresa y poder enviar el primer documento\r\nelectronico a la DIAN, ninguno de estos request realizan ningun envio DIAN aun.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "7692a20fec92af0aa5729d796b019d27c83c9955407994630a0cdd7702ca2329", "type": "string" } ] } }, { "name": "02 - Primeros Envios", "item": [ { "name": "Factura", "item": [ { "name": "Una Linea, Sin Descuentos, Una Tarifa de IVA", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "host", "value": "apidian2026-8.oo", "type": "text", "disabled": true } ], "body": { "mode": "raw", "raw": "{\r\n\t\"number\": 990000168,\r\n\t\"type_document_id\": 1,\r\n\t\"date\": \"2025-10-28\",\r\n\t\"time\": \"04:08:12\",\r\n\t\"resolution_number\": \"18760000001\",\r\n\t\"prefix\": \"SETP\",\r\n \"notes\": \"ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA\",\r\n \"disable_confirmation_text\": true,\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"establishment_email\": \"alternate_email@alternate.com\",\r\n\t\"sendmail\": true,\r\n \"sendmailtome\": true,\r\n \"send_customer_credentials\": false,\r\n \"seze\": \"2021-2017\",\r\n \"email_cc_list\": [\r\n {\r\n \"email\": \"alexanderobandolondono@gmail.com\"\r\n },\r\n {\r\n \"email\": \"alexander_obando@hotmail.com\"\r\n }\r\n ],\r\n \"annexes\": [\r\n {\r\n \"document\": \"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SW50cmJvb2wAAAAAAEJja2dPYmpjAAAAAQAAAAAAAFJHQkMAAAADAAAAAFJkICBkb3ViQG/gAAAAAAAAAAAAR3JuIGRvdWJAb+AAAAAAAAAAAABCbCAgZG91YkBv4AAAAAAAAAAAAEJyZFRVbnRGI1JsdAAAAAAAAAAAAAAAAEJsZCBVbnRGI1JsdAAAAAAAAAAAAAAAAFJzbHRVbnRGI1B4bEBSAAAAAAAAAAAACnZlY3RvckRhdGFib29sAQAAAABQZ1BzZW51bQAAAABQZ1BzAAAAAFBnUEMAAAAATGVmdFVudEYjUmx0AAAAAAAAAAAAAAAAVG9wIFVudEYjUmx0AAAAAAAAAAAAAAAAU2NsIFVudEYjUHJjQFkAAAAAAAAAAAAQY3JvcFdoZW5QcmludGluZ2Jvb2wAAAAADmNyb3BSZWN0Qm90dG9tbG9uZwAAAAAAAAAMY3JvcFJlY3RMZWZ0bG9uZwAAAAAAAAANY3JvcFJlY3RSaWdodGxvbmcAAAAAAAAAC2Nyb3BSZWN0VG9wbG9uZwAAAAAAOEJJTQPtAAAAAAAQAEgAAAABAAIASAAAAAEAAjhCSU0EJgAAAAAADgAAAAAAAAAAAAA/gAAAOEJJTQPyAAAAAAAKAAD///////8AADhCSU0EDQAAAAAABAAAAHg4QklNBBkAAAAAAAQAAAAeOEJJTQPzAAAAAAAJAAAAAAAAAAABADhCSU0nEAAAAAAACgABAAAAAAAAAAI4QklNA/UAAAAAAEgAL2ZmAAEAbGZmAAYAAAAAAAEAL2ZmAAEAoZmaAAYAAAAAAAEAMgAAAAEAWgAAAAYAAAAAAAEANQAAAAEALQAAAAYAAAAAAAE4QklNA/gAAAAAAHAAAP////////////////////////////8D6AAAAAD/////////////////////////////A+gAAAAA/////////////////////////////wPoAAAAAP////////////////////////////8D6AAAOEJJTQQAAAAAAAACAAM4QklNBAIAAAAAAAwAAAAAAAAAAAAAAAA4QklNBDAAAAAAAAYBAQEBAQE4QklNBC0AAAAAAAYAAQAAAA44QklNBAgAAAAAABAAAAABAAACQAAAAkAAAAAAOEJJTQQeAAAAAAAEAAAAADhCSU0EGgAA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cHRrPSJBZG9iZSBYTVAgQ29yZSA1LjMtYzAxMSA2Ni4xNDU2NjEsIDIwMTIvMDIvMDYtMTQ6NTY6MjcgICAgICAgICI+DQoJPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4NCgkJPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIiB4bWxuczpwaG90b3Nob3A9Imh0dHA6Ly9ucy5hZG9iZS5jb20vcGhvdG9zaG9wLzEuMC8iIHhtbG5zOmRjPSJodHRwOi8vcHVybC5vcmcvZGMvZWxlbWVudHMvMS4xLyIgeG1sbnM6eG1wTU09Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9tbS8iIHhtbG5zOnN0RXZ0PSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvc1R5cGUvUmVzb3VyY2VFdmVudCMiIHhtbG5zOnN0UmVmPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvc1R5cGUvUmVzb3VyY2VSZWYjIiB4bXA6Q3JlYXRvclRvb2w9IkFkb2JlIFBob3Rvc2hvcCBDUzYgKFdpbmRvd3MpIiB4bXA6Q3JlYXRlRGF0ZT0iMjAxOC0wNy0wOVQxMTo0NjozMC0wNTowMCIgeG1wOk1ldGFkYXRhRGF0ZT0iMjAxOC0wNy0wOVQxMjowNzo0OS0wNTowMCIgeG1wOk1vZGlmeURhdGU9IjIwMTgtMDctMDlUMTI6MDc6NDktMDU6MDAiIHBob3Rvc2hvcDpDb2xvck1vZGU9IjMiIGRjOmZvcm1hdD0iaW1hZ2UvanBlZyIgeG1wTU06SW5zdGFuY2VJRD0ieG1wLmlpZDpGNDRCQzlCNTk3ODNFODExODc5REY0N0ZEM0Y4RjM3NyIgeG1wTU06RG9jdW1lbnRJRD0ieG1wLmRpZDpGRTU2Q0EwNTk1ODNFODExODc5REY0N0ZEM0Y4RjM3NyIgeG1wTU06T3JpZ2luYWxEb2N1bWVudElEPSJ4bXAuZGlkOkZFNTZDQTA1OTU4M0U4MTE4NzlERjQ3RkQzRjhGMzc3Ij4NCgkJCTxwaG90b3Nob3A6RG9jdW1lbnRBbmNlc3RvcnM+DQoJCQkJPHJkZjpCYWc+DQoJCQkJCTxyZGY6bGk+eG1wLmRpZDpGNTU2Q0EwNTk1ODNFODExODc5REY0N0ZEM0Y4RjM3NzwvcmRmOmxpPg0KCQkJCTwvcmRmOkJhZz4NCgkJCTwvcGhvdG9zaG9wOkRvY3VtZW50QW5jZXN0b3JzPg0KCQkJPHhtcE1NOkhpc3Rvcnk+DQoJCQkJPHJkZjpTZXE+DQoJCQkJCTxyZGY6bGkgc3RFdnQ6YWN0aW9uPSJjcmVhdGVkIiBzdEV2dDppbnN0YW5jZUlEPSJ4bXAuaWlkOkZFNTZDQTA1OTU4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiBzdEV2dDp3aGVuPSIyMDE4LTA3LTA5VDExOjQ2OjMwLTA1OjAwIiBzdEV2dDpzb2Z0d2FyZUFnZW50PSJBZG9iZSBQaG90b3Nob3AgQ1M2IChXaW5kb3dzKSIvPg0KCQkJCQk8cmRmOmxpIHN0RXZ0OmFjdGlvbj0ic2F2ZWQiIHN0RXZ0Omluc3RhbmNlSUQ9InhtcC5paWQ6RjM0QkM5QjU5NzgzRTgxMTg3OURGNDdGRDNGOEYzNzciIHN0RXZ0OndoZW49IjIwMTgtMDctMDlUMTI6MDc6NDktMDU6MDAiIHN0RXZ0OnNvZnR3YXJlQWdlbnQ9IkFkb2JlIFBob3Rvc2hvcCBDUzYgKFdpbmRvd3MpIiBzdEV2dDpjaGFuZ2VkPSIvIi8+DQoJCQkJCTxyZGY6bGkgc3RFdnQ6YWN0aW9uPSJjb252ZXJ0ZWQiIHN0RXZ0OnBhcmFtZXRlcnM9ImZyb20gYXBwbGljYXRpb24vdm5kLmFkb2JlLnBob3Rvc2hvcCB0byBpbWFnZS9qcGVnIi8+DQoJCQkJCTxyZGY6bGkgc3RFdnQ6YWN0aW9uPSJkZXJpdmVkIiBzdEV2dDpwYXJhbWV0ZXJzPSJjb252ZXJ0ZWQgZnJvbSBhcHBsaWNhdGlvbi92bmQuYWRvYmUucGhvdG9zaG9wIHRvIGltYWdlL2pwZWciLz4NCgkJCQkJPHJkZjpsaSBzdEV2dDphY3Rpb249InNhdmVkIiBzdEV2dDppbnN0YW5jZUlEPSJ4bXAuaWlkOkY0NEJDOUI1OTc4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiBzdEV2dDp3aGVuPSIyMDE4LTA3LTA5VDEyOjA3OjQ5LTA1OjAwIiBzdEV2dDpzb2Z0d2FyZUFnZW50PSJBZG9iZSBQaG90b3Nob3AgQ1M2IChXaW5kb3dzKSIgc3RFdnQ6Y2hhbmdlZD0iLyIvPg0KCQkJCTwvcmRmOlNlcT4NCgkJCTwveG1wTU06SGlzdG9yeT4NCgkJCTx4bXBNTTpEZXJpdmVkRnJvbSBzdFJlZjppbnN0YW5jZUlEPSJ4bXAuaWlkOkYzNEJDOUI1OTc4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiBzdFJlZjpkb2N1bWVudElEPSJ4bXAuZGlkOkZFNTZDQTA1OTU4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiBzdFJlZjpvcmlnaW5hbERvY3VtZW50SUQ9InhtcC5kaWQ6RkU1NkNBMDU5NTgzRTgxMTg3OURGNDdGRDNGOEYzNzciLz4NCgkJPC9yZGY6RGVzY3JpcHRpb24+DQoJPC9yZGY6UkRGPg0KPC94OnhtcG1ldGE+DQogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICA8P3hwYWNrZXQgZW5kPSd3Jz8+/9sAQwACAQECAQECAgICAgICAgMFAwMDAwMGBAQDBQcGBwcHBgcHCAkLCQgICggHBwoNCgoLDAwMDAcJDg8NDA4LDAwM/9sAQwECAgIDAwMGAwMGDAgHCAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwM/8AAEQgBvwXrAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/aAAwDAQACEQMRAD8A/fyiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAoozRmgAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiqus63Z+HrB7q+uIbW3j+9JKwVfp9fbqaEm3ZAWqz/EXirT/CWn/atRu4bWHoC55c+ijqx9gCa8t8eftPcyW/h633dvtlwuB9UTr+LY/3a8m1jWrzxDftdX91NeXLdZJW3ED0HYD2GBXrYfKpz1qaL8f+Ac1TEJaR1PTfHn7Tt1fF7fw/CbWPp9qnUNK3uqchfqcn2BrjfDPxe8ReFr9p4tSnulkbdJFdOZo5D+JyPqpFc3RXs08HRhHkUVY5JVpt3ufQfgP9ojR/FOy3vj/ZN83G2Zswuf8AZfp+DY64Ga9BBzXx2RkV03gb4ua34BZY7a4+02K8fZJyWjA/2e6/gceoNediMpT1ov5P/M6KeK6TPp6iuH8B/HrRfGbRwSP/AGZfNwILhhtc/wCw/RvocH2ruK8WpSnTfLNWZ1RkpK6CiiisygooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAoops86W0LSSMsccYLMzHCqB1JNADqhv9Qg0u0kuLmaK3giGXkkcIqD1JPArznx5+0rpuhl7fR411S6Xjzc4t0P16v/AMB4P96vHfFnjjVvHN15up3klwFOUiHyxRf7qjgfXr6k16WHyypU1n7q/H7jnqYiMdFqerePP2nLaxL2+gQi9l6fapgVhX/dXhm/QfWvIfEXifUfF199o1K8mu5P4d5+WP2VRwo+gqjRXu4fCUqK9xa9+px1KspbhRRRXSZhRRRQAUUUUADKGHNdd4E+NmueBdkKy/2hYrx9muGJ2D0R+q/TkD0rkaKzqU4VFyzV0VGTi7o+lvAXxp0Xx2I4Y5vsd+3H2W4IVmP+yejfhz7CuuzXx0y7hXceBvj7rng/ZDcSf2tYrx5c7HzEH+zJyfwbI9MV42Iyl70X8n/mdVPFdJH0bRXM+Bvi3ovj8KlnceVdkZNrP8kw+g6N9VJrpgc1406coPlkrM64yTV0FFFFSMKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooozQAUE7RXE+PfjvovgoyQJIdS1BcjyLdhhD6O/RfpyR6V4v46+L2t+Py0dzcfZbFjxa2+VjI/2j1f8eM9AK78Pl1Wrq9F3ZjUrxj6nrvjz9ojR/CxeCw/4m14vGIm/cof9p+/0XPvivGvGnxK1nx9L/xMLo/Z85W2i+SFf+A/xH3Yk1ggYor3cPgaVHWKu+7OOpWlLcOlFFFdhiFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAA4ZWGVZTkEdQfW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0txcSHLySOXZz7k81HXuYfLKVPWfvP8AD7jjqYiUtFoLLI08zSSO0kkh3M7nczH1J6k+9JRRXpHOFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQBb0PXr7wzqC3Wn3U9ncLxvibG4dcMOjD2IIr1nwJ+09G4jt/EFv5LcD7XbrlT7snUfVc/QV43R1rnr4WlWXvr59TSFSUdj670nWLXXbCO6s7iG6t5PuyROGU/iP5VZr5L8N+KtS8H332jTLyazkJ+YIflk/wB5Tw34ivXfAv7TtrfbLfXofsMx4+0wgtCx915Zf1H0rw8RldSGsPeX4nZTxEXo9D1eiobG/h1K1jnt5oriGQZSSNwyuPUEcGpq8s6AooooAKKKKACiiigAooooAK/mC/4PVv8AlKZ4B/7JVp//AKd9Yr+n2v5gv+D1b/lKZ4B/7JVp/wD6d9YoA/ICv7qv2HP+TKfg/wD9iRov/pBDX8Ktf3VfsOf8mU/B/wD7EjRf/SCGgD1KiiigAooooA/iF/4Kwf8AKUz9pb/sqvij/wBO91XgNe/f8FYP+Upn7S3/AGVXxR/6d7qvAaACiiigAooooAKKKKACiiigAr7m/wCDav8A5Te/AX/sIal/6aL6vhmvub/g2r/5Te/AX/sIal/6aL6gD+xKiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKh1DUrfSbKS4upobe3iGXkkcKqD3J4ryrx3+09b22+38PwfapOn2qdSsS/wC6nBb6nA+tb0cPUqu0ETKpGO56frev2Xhuwa6v7qG0t06vI20Z9B6n2HJryXx3+0+0oe38PW+3t9suF5/4An9W/wC+a8t8QeI9Q8Wah9q1K7mvJuxc8IPRV6KPYACq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LW0s0yW2pGgCrliScDkkk5JJreoAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAqn4g/5AV7/wBcJP8A0E1cqpr3/IDvP+uD/wDoJqo7oGfjDY/8eUP+4v8AKpaisf8Ajyh/3F/lUtf0EfFhRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUEbhg0UUAdr8Ovj74g+HSR26zLqemRjaLO7JYRj/pm/3k9gMr/smvePh18dvD/xIeO3t7hrHUpOBZXZCyM3pG33ZPbGGP8AdFfKVI6B1wwBB7EV5mMymhX974Zd1+q6/n5m9PEThp0PuHocHg9we1FfMPw7/aS8QeCPLt7tv7c01cDybmQ+dEP9iXkj0wwZQOAB1r3X4efGPQfiWix6fdGO+xlrG5AjuB67Rkhx15QnA646V8vi8rr4fVq67r9e39anfTxEZ6dTqaKAc0V5xsFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQB2v7PX/JWNP/AOuc3/os19H184fs9f8AJWNP/wCuc3/os19H183m/wDGXp+rPQwvwBRRRXlnQFFFFABX8wX/AAerf8pTPAP/AGSrT/8A076xX9PtfzBf8Hq3/KUzwD/2SrT/AP076xQB+QFf3VfsOf8AJlPwf/7EjRf/AEghr+FWv7qv2HP+TKfg/wD9iRov/pBDQB6lRRRQAUUUUAFFFFABRjmiigAooooAKKKKACiiigAooooAKKKKACjHNFFAHm/xi/Y2+EP7Q96tz8QPhV8N/HNyows3iDwzZanIv0aaNjXhvij/AIIK/sc+MLlprv8AZ5+HMLMckWNi1iv4LAyAfgK+uqKAPj3Q/wDggF+xr4duRLb/ALPfgGRgc4uoZrpf++ZZGHb0r2H4W/8ABPP4B/A/VIb/AMG/BL4S+FtRt8eXeaV4RsLS5XHQ+akQfPuTmvYaKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKjubSK9tpIZo45oZVKPG6hldTwQQeCD6VJRQB4P8QP+CWv7NPxUuri48Qfs/wDwZ1S8ujmW7m8Haf8AanPvMIhJ/wCPV5fqX/Bvn+xlq1yZZf2ffA6se0P2iFf++UlA/SvsiigD5J8Lf8EH/wBjzwdOklp+zx8NZmj6C+037cp+onZwfxr2r4RfsXfB39n7UPtngP4T/DPwTd9fP0DwxZabJ/31DEpr0yigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKq67/yBLz/AK4P/wCgmrVVdc/5At5/1wf/ANBNVHdCex+MFj/x5Q/7i/yqWobD/jxh/wCua/yqav6CPjAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAox8wPRlOQR1BqO8vIdOs5ri4mht7e3QySzSuI44lHVmY8KB6nivD/AIrftv6P4cMln4Vt08QXgBBvJGMdhEexGPnmx6LtUg8SGtKVGdWXLTV2Z1KsIK83Y+uPCn7XeofDbS3m8TXVvqGiWigzXV7cCGa2X1M7cN9JMk8AMK9Q/Z//AGvvh3+06biLwd4ihvr+1LeZptzG1pfhF6yLBJhnj/203KMjJFfjV49+JOvfFDVPtmvancag6MTFETst7f8A65xLhF9NwG44GSayLK7m0y+t7q1mmtbq1kEsE8MhjlhcchlZcFWHYggiqrcG0a0XJy5Z+W3zXX5W+ZyRz6UJWirx89z9+Ac0V+Yf7M//AAWC8ZfDT7PpfxCtZPHWiphRfqyxaxbr05c4S5x/002uSeZe1foB8Bv2mPA/7TGgtf8AgvX7XVmhQSXVk37m/sQcD99A3zqMnG8AoT91m618PmmQ4zAu9WN4/wAy1X/A+dj3cLmFDEL3Hr2e/wDwfkd5RQDmivFO4KKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooA7X9nr/krGn/APXOb/0Wa+j6+b/2fG2/FnTv9pJgP+/bV9IV83m/8Zen6s9DC/AFFFFeWdAUUUUA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KACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACvmb9tL/gk18H/ANtlLnUNa0VvDvjCUZXxJogS2vnbHHnjBjuRwB+9VmAGFZOtfTNFdWDx2IwlVVsNNxkuqdv+HXk9DKtQp1o8lVJrzP59/wBtP/gi78Yv2PxdaraWH/CxPBkGX/tnQrZ2ntoxk7rmz+aSLABJZDLGo+9ICcV8l6TaTeINQtbTT4LjULy+kWG2t7WMzTXMjcKkaKCzsTwAoJNf1eEZrh/C37M3w78EfE/UvG2j+BvCel+LtXBF5rNrpUMV7cZzu3SqobLZ+Y5y2BnOBj9Oy7xRrQouONpc80tGna/qrO3qvuPl8TwrCU70Jcq6p6/d/wAH7z8ef2KP+Dfj4jfHP7HrnxSupvhn4Zk2yDTwiza9eJwceWcx2uQTgy73UggwjrX6zfsrfsQfDH9jDwx/Zvw/8K2OkTTRrHeak48/UtRxjma4fMjDI3BAQiknaqjivWAMUV8ZnnFmY5o3GvO0P5Y6R+fV/Nvyse3gcpw+FV6au+73/wCB8gooor5o9IKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigD//Z\",\r\n \"extension\": \"jpg\"\r\n },\r\n {\r\n \"document\": \"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l4AOMBlYyIRARrTBb8Zk8P/KHL+k++fXVF246Jor8fXA+wANbD9x9ed+fjTuBDgxdN4OWGjJ/+I4eBwLwPP9z73U6Wj8xua1Dvz4nxuDuP1gxWf+778/M+gEtiVmTWPhuP8GD0dNJQplbmRzdHJlYW0KZW5kb2JqCjMxIDAgb2JqCjw8L1R5cGUvTWV0YWRhdGEKL1N1YnR5cGUvWE1ML0xlbmd0aCAxNTM2Pj5zdHJlYW0KPD94cGFja2V0IGJlZ2luPSfvu78nIGlkPSdXNU0wTXBDZWhpSHpyZVN6TlRjemtjOWQnPz4KPD9hZG9iZS14YXAtZmlsdGVycyBlc2M9IkNSTEYiPz4KPHg6eG1wbWV0YSB4bWxuczp4PSdhZG9iZTpuczptZXRhLycgeDp4bXB0az0nWE1QIHRvb2xraXQgMi45LjEtMTMsIGZyYW1ld29yayAxLjYnPgo8cmRmOlJERiB4bWxuczpyZGY9J2h0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMnIHhtbG5zOmlYPSdodHRwOi8vbnMuYWRvYmUuY29tL2lYLzEuMC8nPgo8cmRmOkRlc2NyaXB0aW9uIHJkZjphYm91dD0ndXVpZDpkNDFjYzRhNi02YmQ0LTExZjAtMDAwMC0xMWFjNzUwODBiZTMnIHhtbG5zOnBkZj0naHR0cDovL25zLmFkb2JlLmNvbS9wZGYvMS4zLycgcGRmOlByb2R1Y2VyPSdQREYgV3JpdGVyIC0gYmlvUERGIC8gaHR0cDovL3d3dy5iaW9wZGYuY29tIC8gRlNHIC8gUGVyc29uYWwgRWRpdGlvbiAobm90IHJlZ2lzdGVyZWQpJy8+CjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSd1dWlkOmQ0MWNjNGE2LTZiZDQtMTFmMC0wMDAwLTExYWM3NTA4MGJlMycgeG1sbnM6eG1wPSdodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvJz48eG1wOk1vZGlmeURhdGU+MjAyNS0wNy0yNVQxMjowMzo0Ny0wNTowMDwveG1wOk1vZGlmeURhdGU+Cjx4bXA6Q3JlYXRlRGF0ZT4yMDI1LTA3LTI1VDEyOjAzOjQ3LTA1OjAwPC94bXA6Q3JlYXRlRGF0ZT4KPHhtcDpDcmVhdG9yVG9vbD5QREYgV3JpdGVyIC0gYmlvUERGICgxMS45LjAuMjczNSk8L3htcDpDcmVhdG9yVG9vbD48L3JkZjpEZXNjcmlwdGlvbj4KPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9J3V1aWQ6ZDQxY2M0YTYtNmJkNC0xMWYwLTAwMDAtMTFhYzc1MDgwYmUzJyB4bWxuczp4YXBNTT0naHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLycgeGFwTU06RG9jdW1lbnRJRD0ndXVpZDpkNDFjYzRhNi02YmQ0LTExZjAtMDAwMC0xMWFjNzUwODBiZTMnLz4KPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9J3V1aWQ6ZDQxY2M0YTYtNmJkNC0xMWYwLTAwMDAtMTFhYzc1MDgwYmUzJyB4bWxuczpkYz0naHR0cDovL3B1cmwub3JnL2RjL2VsZW1lbnRzLzEuMS8nIGRjOmZvcm1hdD0nYXBwbGljYXRpb24vcGRmJz48ZGM6dGl0bGU+PHJkZjpBbHQ+PHJkZjpsaSB4bWw6bGFuZz0neC1kZWZhdWx0Jz5NaWNyb3NvZnQgV29yZCAtIENvdGl6YWNpb24gRGllZ28gQWxlamFuZHJvIE5vcmXDsWEuZG9jPC9yZGY6bGk+PC9yZGY6QWx0PjwvZGM6dGl0bGU+PGRjOmNyZWF0b3I+PHJkZjpTZXE+PHJkZjpsaT5VU0VSPC9yZGY6bGk+PC9yZGY6U2VxPjwvZGM6Y3JlYXRvcj48L3JkZjpEZXNjcmlwdGlvbj4KPC9yZGY6UkRGPgo8L3g6eG1wbWV0YT4KICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAo8P3hwYWNrZXQgZW5kPSd3Jz8+CmVuZHN0cmVhbQplbmRvYmoKMiAwIG9iago8PC9Qcm9kdWNlcihcMzc2XDM3N1wwMDBQXDAwMERcMDAwRlwwMDAgXDAwMFdcMDAwclwwMDBpXDAwMHRcMDAwZVwwMDByXDAwMCBcMDAwLVwwMDAgXDAwMGJcMDAwaVwwMDBvXDAwMFBcMDAwRFwwMDBGXDAwMCBcMDAwL1wwMDAgXDAwMGhcMDAwdFwwMDB0XDAwMHBcMDAwOlwwMDAvXDAwMC9cMDAwd1wwMDB3XDAwMHdcMDAwLlwwMDBiXDAwMGlcMDAwb1wwMDBwXDAwMGRcMDAwZlwwMDAuXDAwMGNcMDAwb1wwMDBtXDAwMCBcMDAwL1wwMDAgXDAwMEZcMDAwU1wwMDBHXDAwMCBcMDAwL1wwMDAgXDAwMFBcMDAwZVwwMDByXDAwMHNcMDAwb1wwMDBuXDAwMGFcMDAwbFwwMDAgXDAwMEVcMDAwZFwwMDBpXDAwMHRcMDAwaVwwMDBvXDAwMG5cMDAwIFwwMDBcKFwwMDBuXDAwMG9cMDAwdFwwMDAgXDAwMHJcMDAwZVwwMDBnXDAwMGlcMDAwc1wwMDB0XDAwMGVcMDAwclwwMDBlXDAwMGRcMDAwXCkpCi9DcmVhdGlvbkRhdGUoRDoyMDI1MDcyNTEyMDM0Ny0wNScwMCcpCi9Nb2REYXRlKEQ6MjAyNTA3MjUxMjAzNDctMDUnMDAnKQovQ3JlYXRvcihcMzc2XDM3N1wwMDBQXDAwMERcMDAwRlwwMDAgXDAwMFdcMDAwclwwMDBpXDAwMHRcMDAwZVwwMDByXDAwMCBcMDAwLVwwMDAgXDAwMGJcMDAwaVwwMDBvXDAwMFBcMDAwRFwwMDBGXDAwMCBcMDAwXChcMDAwMVwwMDAxXDAwMC5cMDAwOVwwMDAuXDAwMDBcMDAwLlwwMDAyXDAwMDdcMDAwM1wwMDA1XDAwMFwpKQovVGl0bGUoXDM3NlwzNzdcMDAwTVwwMDBpXDAwMGNcMDAwclwwMDBvXDAwMHNcMDAwb1wwMDBmXDAwMHRcMDAwIFwwMDBXXDAwMG9cMDAwclwwMDBkXDAwMCBcMDAwLVwwMDAgXDAwMENcMDAwb1wwMDB0XDAwMGlcMDAwelwwMDBhXDAwMGNcMDAwaVwwMDBvXDAwMG5cMDAwIFwwMDBEXDAwMGlcMDAwZVwwMDBnXDAwMG9cMDAwIFwwMDBBXDAwMGxcMDAwZVwwMDBqXDAwMGFcMDAwblwwMDBkXDAwMHJcMDAwb1wwMDAgXDAwME5cMDAwb1wwMDByXDAwMGVcMDAwXDM2MVwwMDBhXDAwMC5cMDAwZFwwMDBvXDAwMGMpCi9BdXRob3IoXDM3NlwzNzdcMDAwVVwwMDBTXDAwMEVcMDAwUik+PmVuZG9iagp4cmVmCjAgMzIKMDAwMDAwMDAwMCA2NTUzNSBmIAowMDAwMDA1MjkyIDAwMDAwIG4gCjAwMDAwOTE3MzQgMDAwMDAgbiAKMDAwMDAwNTIzMyAwMDAwMCBuIAowMDAwMDA1MDIyIDAwMDAwIG4gCjAwMDAwMDAwMTUgMDAwMDAgbiAKMDAwMDAwNTAwMiAwMDAwMCBuIAowMDAwMDA1MzU3IDAwMDAwIG4gCjAwMDAwMDk2MzAgMDAwMDAgbiAKMDAwMDA1MTA1MSAwMDAwMCBuIAowMDAwMDA1OTQ1IDAwMDAwIG4gCjAwMDAwMDgxODkgMDAwMDAgbiAKMDAwMDAxMDYyMCAwMDAwMCBuIAowMDAwMDA5MDA3IDAwMDAwIG4gCjAwMDAwMTc2ODQgMDAwMDAgbiAKMDAwMDAwNTM5OCAwMDAwMCBuIAowMDAwMDA1NzM1IDAwMDAwIG4gCjAwMDAwMTAyODcgMDAwMDAgbiAKMDAwMDA2NTUzNSAwMDAwMCBuIAowMDAwMDA1NjMwIDAwMDAwIG4gCjAwMDAwMDU2NjIgMDAwMDAgbiAKMDAwMDAwNTY5MiAwMDAwMCBuIAowMDAwMDA3ODAzIDAwMDAwIG4gCjAwMDAwMTA4MjIgMDAwMDAgbiAKMDAwMDAxNzg4NSAwMDAwMCBuIAowMDAwMDUxMjUwIDAwMDAwIG4gCjAwMDAwNjU3NDAgMDAwMDAgbiAKMDAwMDAwNzg2NiAwMDAwMCBuIAowMDAwMDA4NDA3IDAwMDAwIG4gCjAwMDAwMDk0MDMgMDAwMDAgbiAKMDAwMDAwOTc4MyAwMDAwMCBuIAowMDAwMDkwMTIxIDAwMDAwIG4gCnRyYWlsZXIKPDwgL1NpemUgMzIgL1Jvb3QgMSAwIFIgL0luZm8gMiAwIFIKL0lEIFs8NTIyRjQwRkQ0NTM1NEU4NEE4MUREQjE5QzAwMjNBNjY+PDUyMkY0MEZENDUzNTRFODRBODFEREIxOUMwMDIzQTY2Pl0KPj4Kc3RhcnR4cmVmCjkyNzg2CiUlRU9GCg==\",\r\n \"extension\": \"pdf\"\r\n }\r\n ],\r\n \"html_header\": \"

Señor(es), XXXXXXXXXXXXXXXXXXX identificado con NIT 99999999-9

Le informamos que ha recibido un documento electronico de: YYYYYYYYYYYYYYYYYYYYYYYYY

\",\r\n \"html_buttons\": \"

Puede descargar su factura mediante el siguiente enlace:

Haga click aqui para descargar su factura.

\",\r\n \"html_footer\": \"

Previamente recibio un correo con las credenciales de ingreso a la plataforma.

Este es un sistema automático de aviso, por favor no responda este mensaje de correo.

\",\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 89008003,\r\n\t\t\"dv\": 2,\r\n\t\t\"name\": \"INVERSIONES DAVAL SAS\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexanderobandolondono@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 6,\r\n\t\t\"type_organization_id\": 1,\r\n \"type_liability_id\": 7,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1\r\n\t},\r\n\t\"payment_form\": [{\r\n\t\t\"payment_form_id\": 2,\r\n\t\t\"payment_method_id\": 30,\r\n\t\t\"payment_due_date\": \"2025-10-28\",\r\n\t\t\"duration_measure\": \"0\"\r\n\t}],\t\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\"tax_exclusive_amount\": \"840336.134\",\r\n\t\t\"tax_inclusive_amount\": \"1000000.00\",\r\n\t\t\"payable_amount\": \"1000000.00\"\r\n\t},\r\n\t\"tax_totals\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\"percent\": \"19.00\",\r\n\t\t\t\"taxable_amount\": \"840336.134\"\r\n\t\t}\r\n\t],\r\n\t\"invoice_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\t\t\"taxable_amount\": \"840336.134\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"COMISION POR SERVICIOS\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"COMISION\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"1000000.00\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "# 📄 ENVIAR FACTURA ELECTRÓNICA - CASO SIMPLE (SIN DESCUENTOS)\n\n## 📋 Descripción General\nEste es el **ejemplo más básico de factura electrónica**. Ideal para comenzar con la integración, muestra una factura con una sola línea de artículo, sin descuentos aplicados y una única tarifa de IVA del 19%.\n\n## 🔗 URL del Endpoint\n**Modo Síncrono (recomendado para pruebas):**\n```\nPOST http://apidian2026-8.oo/api/ubl2.1/invoice\n```\n\n**Modo Asíncrono (con testSetId):**\n```\nPOST http://apidian2026-8.oo/api/ubl2.1/invoice/{testSetId}\n```\n\n## 🔑 Autenticación\n- **Tipo:** Bearer Token\n- **Header:** `Authorization: Bearer {API_TOKEN}`\n- **Obtención:** El token se genera en el **Paso 1 - Config Company**\n- **Recuperación:** Consultar tabla `users`, campo `api_token` en la base de datos de la API\n\n## 📤 Diferencias entre Modo Síncrono y Asíncrono\n\n| Característica | Modo Síncrono | Modo Asíncrono |\n|----------------|---------------|----------------|\n| **URL** | `/api/ubl2.1/invoice` | `/api/ubl2.1/invoice/{testSetId}` |\n| **Afecta set de pruebas** | ❌ No | ✅ Sí |\n| **Respuesta inmediata** | ✅ Sí (incluye estado y errores) | ❌ No (solo ZIP_KEY) |\n| **Validación DIAN** | Incluida en respuesta | Consultar con `/api/ubl2.1/status/zip` |\n| **Uso recomendado** | Desarrollo y pruebas | Producción con alto volumen |\n\n## 🎯 Características de este Ejemplo\n\n### ✅ Lo que **SÍ** incluye:\n- ✓ **Una línea de factura** (\"COMISION POR SERVICIOS\")\n- ✓ **Una tarifa de IVA: 19%**\n- ✓ **payment_form como ARRAY** (importante: NO es objeto)\n- ✓ **Método de pago:** Crédito (payment_form_id: 2)\n- ✓ **Cliente:** INVERSIONES DAVAL SAS (NIT 89008003-2)\n- ✓ **Número de factura:** 990000168\n\n### ❌ Lo que **NO** incluye:\n- ✗ **Sin descuentos** (`allowance_charges: []` - array vacío)\n- ✗ Sin cargos adicionales\n- ✗ Sin múltiples tarifas de IVA\n- ✗ Sin retenciones\n\n## 📊 Estructura del JSON - Campos Principales\n\n### 🔢 Campos de Encabezado\n```json\n{\n \"number\": 990000168, // Número de factura\n \"type_document_id\": 1, // 1 = Factura de venta\n \"date\": \"2025-10-28\", // Fecha de emisión\n \"time\": \"04:08:12\", // Hora de emisión\n \"resolution_number\": \"18760000001\",\n \"prefix\": \"SETP\"\n}\n```\n\n### 👤 Cliente (customer)\n```json\n{\n \"identification_number\": 89008003,\n \"dv\": 2,\n \"name\": \"INVERSIONES DAVAL SAS\",\n \"phone\": \"3103891693\",\n \"address\": \"CLL 4 NRO 33-90\",\n \"email\": \"alexanderobandolondono@gmail.com\"\n}\n```\n\n### 📦 Línea de Factura (invoice_lines)\n```json\n[\n {\n \"unit_measure_id\": 70,\n \"invoiced_quantity\": \"1\",\n \"line_extension_amount\": \"840336.134\", // Base gravable\n \"price_amount\": \"1000000.00\", // Precio unitario\n \"code\": \"COMISION\",\n \"description\": \"COMISION POR SERVICIOS\",\n \"tax_totals\": [\n {\n \"tax_id\": 1, // IVA\n \"tax_amount\": \"159663.865\", // Valor IVA (19%)\n \"taxable_amount\": \"840336.134\",\n \"percent\": \"19.00\" // Tarifa 19%\n }\n ]\n }\n]\n```\n\n### 💰 Forma de Pago (payment_form) - ⚠️ ES UN ARRAY\n```json\n[\n {\n \"payment_form_id\": 2, // 2 = Crédito\n \"payment_method_id\": 30,\n \"payment_due_date\": \"2025-10-28\",\n \"duration_measure\": \"0\"\n }\n]\n```\n\n### 💸 Totales de Impuestos (tax_totals)\n```json\n[\n {\n \"tax_id\": 1, // IVA\n \"tax_amount\": \"159663.865\", // Total IVA\n \"taxable_amount\": \"840336.134\", // Base gravable\n \"percent\": \"19.00\" // Tarifa única: 19%\n }\n]\n```\n\n### 🚫 Descuentos (allowance_charges) - VACÍO\n```json\n[] // Array vacío = sin descuentos\n```\n\n## ⚡ Flujo de Uso\n\n### Modo Síncrono (Recomendado para este ejemplo):\n1. ✅ Enviar POST a `/api/ubl2.1/invoice`\n2. ✅ Recibir respuesta inmediata con:\n - Estado de validación DIAN\n - Errores de validación (si los hay)\n - UUID del documento\n - Indicación si la factura es válida\n\n### Modo Asíncrono:\n1. ✅ Enviar POST a `/api/ubl2.1/invoice/{testSetId}`\n2. ✅ Recibir `ZIP_KEY` en la respuesta\n3. ✅ Consultar estado con:\n ```\n GET /api/ubl2.1/status/zip\n ```\n (Ver sección **03 - Consultas de estado**)\n4. ✅ Obtener resultado de validación DIAN\n\n## 📝 Notas Importantes\n\n⚠️ **payment_form es ARRAY:** A diferencia de versiones antiguas de la API, `payment_form` es un **array de objetos**, no un objeto simple. Esto permite Especificar múltiples formas de pago.\n\n⚠️ **allowance_charges vacío:** Este ejemplo específicamente NO incluye descuentos. El array está explícitamente vacío `[]`. Para ejemplos con descuentos, consultar otros ejemplos de esta sección.\n\n⚠️ **testSetId:** El parámetro `{testSetId}` corresponde al ID del set de pruebas entregado por la DIAN al registrar el modo de operación \"Software Propio\".\n\n⚠️ **Dominio personalizado:** Si instaló un dominio personalizado, reemplazar `http://apidian2026-8.oo` por `http://midominio.com`\n\n## 🔍 Próximos Pasos\n\nDespués de dominar este ejemplo básico, puede explorar:\n- ✅ **Varios Métodos de Pago** - siguiente ejemplo en esta sección\n- ✅ **Facturas con Descuentos** - ejemplos con `allowance_charges`\n- ✅ **Múltiples Líneas** - facturas más complejas\n- ✅ **Múltiples Tarifas de IVA** - combinación de tarifas 19%, 5%, 0%" }, "response": [] }, { "name": "Varios Metodos de Pago, Una Linea, Descuento Global, Una Tarifa de IVA", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"number\": 990000195,\r\n\t\"type_document_id\": 1,\r\n\t\"date\": \"2025-10-31\",\r\n\t\"time\": \"04:08:12\",\r\n\t\"resolution_number\": \"18760000001\",\r\n\t\"prefix\": \"SETP\",\r\n \"actividadeconomica\": \"6201\",\r\n \"notes\": \"ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA\",\r\n \"disable_confirmation_text\": true,\r\n \"establishment_name\": \"TORRE SOFTWARE NRO 1\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"establishment_email\": \"alternate_email@alternate.com\",\r\n\t\"sendmail\": true,\r\n \"sendmailtome\": true,\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 41946692,\r\n\t\t\"dv\": 6,\r\n\t\t\"name\": \"ELIZABETH CARDONA VILLADA\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexander_obando@hotmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 3,\r\n\t\t\"type_organization_id\": 2,\r\n \"type_liability_id\": 7,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1,\r\n \"tax_id\": 1\r\n\t},\r\n\t\"payment_form\": [\r\n {\r\n \t\t\"payment_form_id\": 2,\r\n\t \t\"duration_measure\": \"30\",\r\n\t\t \"payment_due_date\": \"2025-11-30\",\r\n\t\t \"payment_method_id\": 30\r\n\t },\r\n {\r\n \t\t\"payment_form_id\": 2,\r\n\t \t\"duration_measure\": \"30\",\r\n\t\t \"payment_due_date\": \"2025-11-30\",\r\n\t\t \"payment_method_id\": 10\r\n\t }\r\n ],\t\r\n\t\"allowance_charges\": [\r\n\t\t{\r\n\t\t\t\"discount_id\": 1,\r\n\t\t\t\"charge_indicator\": false,\r\n\t\t\t\"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n\t\t\t\"amount\": \"50000.00\",\r\n\t\t\t\"base_amount\": \"1000000.00\"\r\n\t\t}\r\n\t],\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\"tax_exclusive_amount\": \"840336.134\",\r\n\t\t\"tax_inclusive_amount\": \"1000000.00\",\r\n\t\t\"allowance_total_amount\": \"50000.00\",\r\n\t\t\"payable_amount\": \"950000.00\"\r\n\t},\r\n\t\"tax_totals\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\"percent\": \"19\",\r\n\t\t\t\"taxable_amount\": \"840336.134\"\r\n\t\t}\r\n\t],\r\n\t\"invoice_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\t\t\"taxable_amount\": \"840336.134\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"COMISION POR SERVICIOS\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"COMISION\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"1000000.00\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t],\r\n \"logo_empresa_emisora\": \"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ZmYABgAAAAAAAQAvZmYAAQChmZoABgAAAAAAAQAyAAAAAQBaAAAABgAAAAAAAQA1AAAAAQAtAAAABgAAAAAAAThCSU0D+AAAAAAAcAAA/////////////////////////////wPoAAAAAP////////////////////////////8D6AAAAAD/////////////////////////////A+gAAAAA/////////////////////////////wPoAAA4QklNBAAAAAAAAAIAADhCSU0EAgAAAAAABAAAAAA4QklNBDAAAAAAAAIBAThCSU0ELQAAAAAABgABAAAABjhCSU0ECAAAAAAAEAAAAAEAAAJAAAACQAAAAAA4QklNBB4AAAAAAAQAAAAAOEJJTQQaAAAAAANbAAAABgAAAAAAAAAAAAAFiQAABYkAAAATAEwAbwBnAG8AIABUAG8AcgByAGUAIABTAG8AZgB0AHcAYQByAGUAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAABYkAAAWJAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAEAAAAAAABudWxsAAAAAgAAAAZib3VuZHNPYmpjAAAAAQAAAAAAAFJjdDEAAAAEAAAAAFRvcCBsb25nAAAAAAAAAABMZWZ0bG9uZwAAAAAAAAAAQnRvbWxvbmcAAAWJAAAAAFJnaHRsb25nAAAFiQAAAAZzbGljZXNWbExzAAAAAU9iamMAAAABAAAAAAAFc2xpY2UAAAASAAAAB3NsaWNlSURsb25nAAAAAAAAAAdncm91cElEbG9uZwAAAAAAAAAGb3JpZ2luZW51bQAAAAxFU2xpY2VPcmlnaW4AAAANYXV0b0dlbmVyYXRlZAAAAABUeXBlZW51bQAAAApFU2xpY2VUeXBlAAAAAEltZyAAAAAGYm91bmRzT2JqYwAAAAEAAAAAAABSY3QxAAAABAAAAABUb3AgbG9uZwAAAAAAAAAATGVmdGxvbmcAAAAAAAAAAEJ0b21sb25nAAAFiQAAAABSZ2h0bG9uZwAABYkAAAADdXJsVEVYVAAAAAEAAAAAAABudWxsVEVYVAAAAAEAAAAAAABNc2dlVEVYVAAAAAEAAAAAAAZhbHRUYWdURVhUAAAAAQAAAAAADmNlbGxUZXh0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eG1wTU09Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9tbS8iIHhtbG5zOnN0RXZ0PSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvc1R5cGUvUmVzb3VyY2VFdmVudCMiIHhtbG5zOnN0UmVmPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvc1R5cGUvUmVzb3VyY2VSZWYjIiB4bWxuczpwaG90b3Nob3A9Imh0dHA6Ly9ucy5hZG9iZS5jb20vcGhvdG9zaG9wLzEuMC8iIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIENTNiAoV2luZG93cykiIHhtcDpDcmVhdGVEYXRlPSIyMDE4LTA3LTA5VDExOjQ3OjA0LTA1OjAwIiB4bXA6TWV0YWRhdGFEYXRlPSIyMDE4LTA3LTA5VDExOjUyOjM5LTA1OjAwIiB4bXA6TW9kaWZ5RGF0ZT0iMjAxOC0wNy0wOVQxMTo1MjozOS0wNTowMCIgZGM6Zm9ybWF0PSJpbWFnZS9qcGVnIiB4bXBNTTpJbnN0YW5jZUlEPSJ4bXAuaWlkOkYyNEJDOUI1OTc4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiB4bXBNTTpEb2N1bWVudElEPSJ4bXAuZGlkOkY1NTZDQTA1OTU4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiB4bXBNTTpPcmlnaW5hbERvY3VtZW50SUQ9InhtcC5kaWQ6RUU0QkM5QjU5NzgzRTgxMTg3OURGNDdGRDNGOEYzNzciIHBob3Rvc2hvcDpDb2xvck1vZGU9IjMiPg0KCQkJPHhtcE1NOkhpc3Rvcnk+DQoJCQkJPHJkZjpTZXE+DQoJCQkJCTxyZGY6bGkgc3RFdnQ6YWN0aW9uPSJjcmVhdGVkIiBzdEV2dDppbnN0YW5jZUlEPSJ4bXAuaWlkOkVFNEJDOUI1OTc4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiBzdEV2dDp3aGVuPSIyMDE4LTA3LTA5VDExOjQ3OjA0LTA1OjAwIiBzdEV2dDpzb2Z0d2FyZUFnZW50PSJBZG9iZSBQaG90b3Nob3AgQ1M2IChXaW5kb3dzKSIvPg0KCQkJCQk8cmRmOmxpIHN0RXZ0OmFjdGlvbj0ic2F2ZWQiIHN0RXZ0Omluc3RhbmNlSUQ9InhtcC5paWQ6RjE0QkM5QjU5NzgzRTgxMTg3OURGNDdGRDNGOEYzNzciIHN0RXZ0OndoZW49IjIwMTgtMDctMDlUMTE6NTI6MzktMDU6MDAiIHN0RXZ0OnNvZnR3YXJlQWdlbnQ9IkFkb2JlIFBob3Rvc2hvcCBDUzYgKFdpbmRvd3MpIiBzdEV2dDpjaGFuZ2VkPSIvIi8+DQoJCQkJCTxyZGY6bGkgc3RFdnQ6YWN0aW9uPSJjb252ZXJ0ZWQiIHN0RXZ0OnBhcmFtZXRlcnM9ImZyb20gYXBwbGljYXRpb24vdm5kLmFkb2JlLnBob3Rvc2hvcCB0byBpbWFnZS9qcGVnIi8+DQoJCQkJCTxyZGY6bGkgc3RFdnQ6YWN0aW9uPSJkZXJpdmVkIiBzdEV2dDpwYXJhbWV0ZXJzPSJjb252ZXJ0ZWQgZnJvbSBhcHBsaWNhdGlvbi92bmQuYWRvYmUucGhvdG9zaG9wIHRvIGltYWdlL2pwZWciLz4NCgkJCQkJPHJkZjpsaSBzdEV2dDphY3Rpb249InNhdmVkIiBzdEV2dDppbnN0YW5jZUlEPSJ4bXAuaWlkOkYyNEJDOUI1OTc4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiBzdEV2dDp3aGVuPSIyMDE4LTA3LTA5VDExOjUyOjM5LTA1OjAwIiBzdEV2dDpzb2Z0d2FyZUFnZW50PSJBZG9iZSBQaG90b3Nob3AgQ1M2IChXaW5kb3dzKSIgc3RFdnQ6Y2hhbmdlZD0iLyIvPg0KCQkJCTwvcmRmOlNlcT4NCgkJCTwveG1wTU06SGlzdG9yeT4NCgkJCTx4bXBNTTpEZXJpdmVkRnJvbSBzdFJlZjppbnN0YW5jZUlEPSJ4bXAuaWlkOkYxNEJDOUI1OTc4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiBzdFJlZjpkb2N1bWVudElEPSJ4bXAuZGlkOkY1NTZDQTA1OTU4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiBzdFJlZjpvcmlnaW5hbERvY3VtZW50SUQ9InhtcC5kaWQ6RUU0QkM5QjU5NzgzRTgxMTg3OURGNDdGRDNGOEYzNzciLz4NCgkJPC9yZGY6RGVzY3JpcHRpb24+DQoJPC9yZGY6UkRGPg0KPC94OnhtcG1ldGE+DQogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICA8P3hwYWNrZXQgZW5kPSd3Jz8+/9sAQwACAQECAQECAgICAgICAgMFAwMDAwMGBAQDBQcGBwcHBgcHCAkLCQgICggHBwoNCgoLDAwMDAcJDg8NDA4LDAwM/9sAQwECAgIDAwMGAwMGDAgHCAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwM/8AAEQgAawBrAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/aAAwDAQACEQMRAD8A/fyiiigAooqnrviKx8Mae11qF1DZ26/xyNjJ9B3J9hyaaTbsgLlZnijxjpngyx+0aneQ2sf8Ibl3PoqjLMfYA15V46/afknMlv4ft/LXp9suF+Y/7kf9W/75ryrU9Uut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\"\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "# 📄 ENVIAR FACTURA ELECTRÓNICA - MÚLTIPLES MÉTODOS DE PAGO Y DESCUENTO GLOBAL\n\n## 📋 Descripción General\nEjemplo de factura electrónica con **múltiples métodos de pago** y **descuento global**. Muestra cómo configurar dos formas de pago diferentes (crédito con diferentes métodos) y aplicar un descuento sobre el total de la factura.\n\n## 🔗 URL del Endpoint\n**Modo Síncrono (recomendado para pruebas):**\n```\nPOST http://apidian2026-8.oo/api/ubl2.1/invoice\n```\n\n**Modo Asíncrono (con testSetId):**\n```\nPOST http://apidian2026-8.oo/api/ubl2.1/invoice/{testSetId}\n```\n\n## 🔑 Autenticación\n- **Tipo:** Bearer Token\n- **Header:** `Authorization: Bearer {API_TOKEN}`\n- **Obtención:** El token se genera en el **Paso 1 - Config Company**\n- **Recuperación:** Consultar tabla `users`, campo `api_token` en la base de datos de la API\n\n## 📤 Diferencias entre Modo Síncrono y Asíncrono\n\n| Característica | Modo Síncrono | Modo Asíncrono |\n|----------------|---------------|----------------|\n| **URL** | `/api/ubl2.1/invoice` | `/api/ubl2.1/invoice/{testSetId}` |\n| **Afecta set de pruebas** | ❌ No | ✅ Sí |\n| **Respuesta inmediata** | ✅ Sí (incluye estado y errores) | ❌ No (solo ZIP_KEY) |\n| **Validación DIAN** | Incluida en respuesta | Consultar con `/api/ubl2.1/status/zip` |\n| **Uso recomendado** | Desarrollo y pruebas | Producción con alto volumen |\n\n## 🎯 Características de este Ejemplo\n\n### ✅ Lo que **SÍ** incluye:\n- ✓ **Una línea de factura** (\"COMISION POR SERVICIOS\")\n- ✓ **Múltiples formas de pago:** 2 métodos (payment_form_id: 2 con payment_method_id 30 y 10)\n- ✓ **Descuento global:** $50,000 sobre base de $1,000,000\n- ✓ **Una tarifa de IVA: 19%**\n- ✓ **payment_form como ARRAY** con 2 elementos\n- ✓ **Cliente:** ELIZABETH CARDONA VILLADA (CC 41946692-6)\n- ✓ **Número de factura:** 990000195\n- ✓ **Campos adicionales:** establishment (nombre, dirección, teléfono, municipio, email), logo empresa\n\n### ❌ Lo que **NO** incluye:\n- ✗ Sin múltiples líneas de factura\n- ✗ Sin múltiples tarifas de IVA\n- ✗ Sin retenciones\n- ✗ Sin descuentos por línea (solo descuento global)\n\n## 📊 Estructura del JSON - Campos Principales\n\n### 🔢 Campos de Encabezado\n```json\n{\n \"number\": 990000195,\n \"type_document_id\": 1,\n \"date\": \"2025-10-31\",\n \"time\": \"04:08:12\",\n \"resolution_number\": \"18760000001\",\n \"prefix\": \"SETP\",\n \"actividadeconomica\": \"6201\",\n \"establishment_name\": \"TORRE SOFTWARE NRO 1\",\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\n \"establishment_phone\": \"3226563672\",\n \"establishment_municipality\": 600,\n \"establishment_email\": \"alternate_email@alternate.com\"\n}\n```\n\n### 👤 Cliente (customer)\n```json\n{\n \"identification_number\": 41946692,\n \"dv\": 6,\n \"name\": \"ELIZABETH CARDONA VILLADA\",\n \"phone\": \"3103891693\",\n \"address\": \"CLL 4 NRO 33-90\",\n \"email\": \"alexander_obando@hotmail.com\",\n \"type_document_identification_id\": 3, // 3 = Cédula de ciudadanía\n \"type_organization_id\": 2, // 2 = Persona natural\n \"type_liability_id\": 7,\n \"municipality_id\": 822,\n \"type_regime_id\": 1,\n \"tax_id\": 1\n}\n```\n\n### 💰 Formas de Pago (payment_form) - ⚠️ ARRAY CON 2 MÉTODOS\n```json\n[\n {\n \"payment_form_id\": 2, // 2 = Crédito\n \"duration_measure\": \"30\", // 30 días\n \"payment_due_date\": \"2025-11-30\",\n \"payment_method_id\": 30 // Método 30\n },\n {\n \"payment_form_id\": 2, // 2 = Crédito\n \"duration_measure\": \"30\",\n \"payment_due_date\": \"2025-11-30\",\n \"payment_method_id\": 10 // Método 10 (diferente)\n }\n]\n```\n\n### 💸 Descuento Global (allowance_charges)\n```json\n[\n {\n \"discount_id\": 1,\n \"charge_indicator\": false, // false = descuento\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\n \"amount\": \"50000.00\", // Valor del descuento\n \"base_amount\": \"1000000.00\" // Base sobre la que se aplica\n }\n]\n```\n\n### 📦 Línea de Factura (invoice_lines)\n```json\n[\n {\n \"unit_measure_id\": 70,\n \"invoiced_quantity\": \"1\",\n \"line_extension_amount\": \"840336.134\", // Base gravable\n \"price_amount\": \"1000000.00\", // Precio unitario\n \"code\": \"COMISION\",\n \"description\": \"COMISION POR SERVICIOS\",\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\n \"type_item_identification_id\": 4,\n \"tax_totals\": [\n {\n \"tax_id\": 1,\n \"tax_amount\": \"159663.865\",\n \"taxable_amount\": \"840336.134\",\n \"percent\": \"19.00\"\n }\n ]\n }\n]\n```\n\n### 💵 Totales Legales (legal_monetary_totals)\n```json\n{\n \"line_extension_amount\": \"840336.134\", // Subtotal sin IVA\n \"tax_exclusive_amount\": \"840336.134\", // Total antes de impuestos\n \"tax_inclusive_amount\": \"1000000.00\", // Total con impuestos\n \"allowance_total_amount\": \"50000.00\", // Total descuentos\n \"payable_amount\": \"950000.00\" // Total a pagar final\n}\n```\n\n### 🧾 Totales de Impuestos (tax_totals)\n```json\n[\n {\n \"tax_id\": 1,\n \"tax_amount\": \"159663.865\",\n \"percent\": \"19\",\n \"taxable_amount\": \"840336.134\"\n }\n]\n```\n\n## ⚡ Flujo de Uso\n\n### Modo Síncrono (Recomendado):\n1. ✅ Enviar POST a `/api/ubl2.1/invoice`\n2. ✅ Recibir respuesta inmediata con:\n - Estado de validación DIAN\n - Errores de validación (si los hay)\n - UUID del documento\n - Indicación si la factura es válida\n\n### Modo Asíncrono:\n1. ✅ Enviar POST a `/api/ubl2.1/invoice/{testSetId}`\n2. ✅ Recibir `ZIP_KEY` en la respuesta\n3. ✅ Consultar estado con `/api/ubl2.1/status/zip` (Ver sección **03 - Consultas de estado**)\n4. ✅ Obtener resultado de validación DIAN\n\n## 📝 Notas Importantes\n\n⚠️ **Múltiples métodos de pago:** Este ejemplo muestra cómo configurar `payment_form` como un **array con 2 elementos**, permitiendo Especificar diferentes métodos de pago para una misma forma (ambos son crédito a 30 días pero con diferentes `payment_method_id`).\n\n⚠️ **Descuento global:** El `allowance_charges` contiene un descuento que se aplica sobre el total de la factura. El `charge_indicator: false` indica que es un descuento (no un cargo).\n\n⚠️ **Cálculo de totales:**\n- Base gravable: $840,336.134\n- IVA 19%: $159,663.865\n- Subtotal con IVA: $1,000,000.00\n- Descuento global: -$50,000.00\n- **Total a pagar: $950,000.00**\n\n⚠️ **Campos establishment:** Este ejemplo incluye campos adicionales para Especificar el establecimiento físico donde se genera la factura (útil cuando hay múltiples puntos de venta).\n\n⚠️ **Logo empresa:** Se puede incluir el logo en formato Base64 en el campo `logo_empresa_emisora`.\n\n## 🔍 Próximos Pasos\n\nDespués de dominar este ejemplo, puede explorar:\n- ✅ **Facturas con Múltiples Líneas** - varios productos/servicios en una factura\n- ✅ **Múltiples Tarifas de IVA** - combinación de tarifas 19%, 5%, 0%\n- ✅ **Descuentos por Línea** - descuentos específicos en cada producto\n- ✅ **Retenciones** - aplicación de retención en la fuente" }, "response": [] }, { "name": "Customer Resolucion 202 2025", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"number\": 990000214,\r\n\t\"type_document_id\": 1,\r\n\t\"date\": \"2025-11-07\",\r\n\t\"time\": \"04:08:12\",\r\n \"query_uuid\": false,\r\n \"dont_send_yet\": false,\r\n\t\"resolution_number\": \"18760000001\",\r\n\t\"prefix\": \"SETP\",\r\n \"actividadeconomica\": \"6201\",\r\n \"notes\": \"ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA\",\r\n \"disable_confirmation_text\": true,\r\n \"establishment_name\": \"TORRE SOFTWARE NRO 1\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"establishment_email\": \"alternate_email@alternate.com\",\r\n\t\"sendmail\": false,\r\n \"sendmailtome\": false,\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n\t\"customer\": {\r\n\t\t\"identification_number\": \"41946692\",\r\n\t\t\"name\": \"ELIZABETH CARDONA VILLADA\"\r\n\t},\r\n\t\"payment_form\": [\r\n {\r\n \t\t\"payment_form_id\": 2,\r\n\t \t\"duration_measure\": \"30\",\r\n\t\t \"payment_due_date\": \"2025-12-07\",\r\n\t\t \"payment_method_id\": 30\r\n\t },\r\n {\r\n \t\t\"payment_form_id\": 2,\r\n\t \t\"duration_measure\": \"30\",\r\n\t\t \"payment_due_date\": \"2025-12-07\",\r\n\t\t \"payment_method_id\": 10\r\n\t }\r\n ],\t\r\n\t\"allowance_charges\": [\r\n\t\t{\r\n\t\t\t\"discount_id\": 1,\r\n\t\t\t\"charge_indicator\": false,\r\n\t\t\t\"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n\t\t\t\"amount\": \"50000.00\",\r\n\t\t\t\"base_amount\": \"1000000.00\"\r\n\t\t}\r\n\t],\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\"tax_exclusive_amount\": \"840336.134\",\r\n\t\t\"tax_inclusive_amount\": \"1000000.00\",\r\n\t\t\"allowance_total_amount\": \"50000.00\",\r\n\t\t\"payable_amount\": \"950000.00\"\r\n\t},\r\n\t\"tax_totals\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\"percent\": \"19\",\r\n\t\t\t\"taxable_amount\": \"840336.134\"\r\n\t\t}\r\n\t],\r\n\t\"invoice_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\t\t\"taxable_amount\": \"840336.134\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"COMISION POR SERVICIOS\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"COMISION\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"1000000.00\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "# 📄 ENVIAR FACTURA ELECTRÓNICA - CASO SIMPLE (SIN DESCUENTOS)\n\n## 📋 Descripción General\nEste es el **ejemplo más básico de factura electrónica**. Ideal para comenzar con la integración, muestra una factura con una sola línea de artículo, sin descuentos aplicados y una única tarifa de IVA del 19%.\n\n## 🔗 URL del Endpoint\n**Modo Síncrono (recomendado para pruebas):**\n```\nPOST http://apidian2026-8.oo/api/ubl2.1/invoice\n```\n\n**Modo Asíncrono (con testSetId):**\n```\nPOST http://apidian2026-8.oo/api/ubl2.1/invoice/{testSetId}\n```\n\n## 🔑 Autenticación\n- **Tipo:** Bearer Token\n- **Header:** `Authorization: Bearer {API_TOKEN}`\n- **Obtención:** El token se genera en el **Paso 1 - Config Company**\n- **Recuperación:** Consultar tabla `users`, campo `api_token` en la base de datos de la API\n\n## 📤 Diferencias entre Modo Síncrono y Asíncrono\n\n| Característica | Modo Síncrono | Modo Asíncrono |\n|----------------|---------------|----------------|\n| **URL** | `/api/ubl2.1/invoice` | `/api/ubl2.1/invoice/{testSetId}` |\n| **Afecta set de pruebas** | ❌ No | ✅ Sí |\n| **Respuesta inmediata** | ✅ Sí (incluye estado y errores) | ❌ No (solo ZIP_KEY) |\n| **Validación DIAN** | Incluida en respuesta | Consultar con `/api/ubl2.1/status/zip` |\n| **Uso recomendado** | Desarrollo y pruebas | Producción con alto volumen |\n\n## 🎯 Características de este Ejemplo\n\n### ✅ Lo que **SÍ** incluye:\n- ✓ **Una línea de factura** (\"COMISION POR SERVICIOS\")\n- ✓ **Una tarifa de IVA: 19%**\n- ✓ **payment_form como ARRAY** (importante: NO es objeto)\n- ✓ **Método de pago:** Crédito (payment_form_id: 2)\n- ✓ **Cliente:** INVERSIONES DAVAL SAS (NIT 89008003-2)\n- ✓ **Número de factura:** 990000168\n\n### ❌ Lo que **NO** incluye:\n- ✗ **Sin descuentos** (`allowance_charges: []` - array vacío)\n- ✗ Sin cargos adicionales\n- ✗ Sin múltiples tarifas de IVA\n- ✗ Sin retenciones\n\n## 📊 Estructura del JSON - Campos Principales\n\n### 🔢 Campos de Encabezado\n```json\n{\n \"number\": 990000168, // Número de factura\n \"type_document_id\": 1, // 1 = Factura de venta\n \"date\": \"2025-10-28\", // Fecha de emisión\n \"time\": \"04:08:12\", // Hora de emisión\n \"resolution_number\": \"18760000001\",\n \"prefix\": \"SETP\"\n}\n```\n\n### 👤 Cliente (customer)\n```json\n{\n \"identification_number\": 89008003,\n \"dv\": 2,\n \"name\": \"INVERSIONES DAVAL SAS\",\n \"phone\": \"3103891693\",\n \"address\": \"CLL 4 NRO 33-90\",\n \"email\": \"alexanderobandolondono@gmail.com\"\n}\n```\n\n### 📦 Línea de Factura (invoice_lines)\n```json\n[\n {\n \"unit_measure_id\": 70,\n \"invoiced_quantity\": \"1\",\n \"line_extension_amount\": \"840336.134\", // Base gravable\n \"price_amount\": \"1000000.00\", // Precio unitario\n \"code\": \"COMISION\",\n \"description\": \"COMISION POR SERVICIOS\",\n \"tax_totals\": [\n {\n \"tax_id\": 1, // IVA\n \"tax_amount\": \"159663.865\", // Valor IVA (19%)\n \"taxable_amount\": \"840336.134\",\n \"percent\": \"19.00\" // Tarifa 19%\n }\n ]\n }\n]\n```\n\n### 💰 Forma de Pago (payment_form) - ⚠️ ES UN ARRAY\n```json\n[\n {\n \"payment_form_id\": 2, // 2 = Crédito\n \"payment_method_id\": 30,\n \"payment_due_date\": \"2025-10-28\",\n \"duration_measure\": \"0\"\n }\n]\n```\n\n### 💸 Totales de Impuestos (tax_totals)\n```json\n[\n {\n \"tax_id\": 1, // IVA\n \"tax_amount\": \"159663.865\", // Total IVA\n \"taxable_amount\": \"840336.134\", // Base gravable\n \"percent\": \"19.00\" // Tarifa única: 19%\n }\n]\n```\n\n### 🚫 Descuentos (allowance_charges) - VACÍO\n```json\n[] // Array vacío = sin descuentos\n```\n\n## ⚡ Flujo de Uso\n\n### Modo Síncrono (Recomendado para este ejemplo):\n1. ✅ Enviar POST a `/api/ubl2.1/invoice`\n2. ✅ Recibir respuesta inmediata con:\n - Estado de validación DIAN\n - Errores de validación (si los hay)\n - UUID del documento\n - Indicación si la factura es válida\n\n### Modo Asíncrono:\n1. ✅ Enviar POST a `/api/ubl2.1/invoice/{testSetId}`\n2. ✅ Recibir `ZIP_KEY` en la respuesta\n3. ✅ Consultar estado con:\n ```\n GET /api/ubl2.1/status/zip\n ```\n (Ver sección **03 - Consultas de estado**)\n4. ✅ Obtener resultado de validación DIAN\n\n## 📝 Notas Importantes\n\n⚠️ **payment_form es ARRAY:** A diferencia de versiones antiguas de la API, `payment_form` es un **array de objetos**, no un objeto simple. Esto permite Especificar múltiples formas de pago.\n\n⚠️ **allowance_charges vacío:** Este ejemplo específicamente NO incluye descuentos. El array está explícitamente vacío `[]`. Para ejemplos con descuentos, consultar otros ejemplos de esta sección.\n\n⚠️ **testSetId:** El parámetro `{testSetId}` corresponde al ID del set de pruebas entregado por la DIAN al registrar el modo de operación \"Software Propio\".\n\n⚠️ **Dominio personalizado:** Si instaló un dominio personalizado, reemplazar `http://apidian2026-8.oo` por `http://midominio.com`\n\n## 🔍 Próximos Pasos\n\nDespués de dominar este ejemplo básico, puede explorar:\n- ✅ **Varios Métodos de Pago** - siguiente ejemplo en esta sección\n- ✅ **Facturas con Descuentos** - ejemplos con `allowance_charges`\n- ✅ **Múltiples Líneas** - facturas más complejas\n- ✅ **Múltiples Tarifas de IVA** - combinación de tarifas 19%, 5%, 0%" }, "response": [] }, { "name": "Factura Nacional Suplemento K, Moneda extranjera", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": 990000171,\r\n \"type_document_id\": 1,\r\n \"date\": \"2025-10-28\",\r\n \"time\": \"04:25:44\",\r\n \"notes\": \"SIN OBSERVACIONES\",\r\n \"sendmail\": false,\r\n \"resolution_number\": \"18760000001\",\r\n \"prefix\": \"SETP\",\r\n \"k_supplement_national\": {\r\n \"FctConvCop\": \"3890\",\r\n \"MonedaCop\": \"USD\",\r\n \"SubTotalCop\": \"200.00\",\r\n \"DescuentoDetalleCop\": \"0.00\",\r\n \"RecargoDetalleCop\": \"0.00\",\r\n \"TotalBrutoFacturaCop\": \"200.00\",\r\n \"TotIvaCop\": \"38.00\",\r\n \"TotIncCop\": \"0.00\",\r\n \"TotBolCop\": \"0.00\",\r\n \"TotICLCop\": \"0.00\",\r\n \"TotINPPCop\": \"0.00\",\r\n \"TotIBUACop\": \"0.00\",\r\n \"TotICUICop\": \"0.00\",\r\n \"TotADVCop\": \"0.00\",\r\n \"ImpOtroCop\": \"0.00\",\r\n \"MntImpCop\": \"38.00\",\r\n \"TotalNetoFacturaCop\": \"238.00\",\r\n \"MntDctoCop\": \"0.00\",\r\n \"MntRcgoCop\": \"0.00\",\r\n \"VlrPagarCop\": \"238.00\",\r\n \"ReteFueCop\": \"0.00\",\r\n \"ReteIvaCop\": \"0.00\",\r\n \"ReteIcaCop\": \"0.00\",\r\n \"TotAnticiposCop\": \"0.00\"\r\n },\r\n \"customer\": {\r\n \"identification_number\": \"FR42128XD090\",\r\n \"name\": \"BLANCA NUBIA ALVAREZ ALZATE \",\r\n \"phone\": \"3148931130\",\r\n \"address\": \"CR 14 BIS 31 B 37 BRR SAN NICOLAS\",\r\n \"email\": \"blancanubiaa@hotmail.com\",\r\n \"merchant_registration\": \"0000-00\",\r\n \"type_document_identification_id\": 8,\r\n \"type_organization_id\": 2,\r\n \"country_id\": 65,\r\n \"municipality_name\": \"MIAMI\",\r\n \"state_name\": \"FLORIDA\",\r\n \"type_liability_id\": 117,\r\n \"type_regime_id\": 2\r\n },\r\n \"payment_form\": {\r\n \"payment_form_id\": 2,\r\n \"payment_method_id\": 10,\r\n \"payment_due_date\": \"2025-11-28\",\r\n \"duration_measure\": \"30\"\r\n },\r\n \"allowance_charges\": [\r\n {\r\n \"discount_id\": 10,\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"15840.00\"\r\n },\r\n {\r\n \"charge_indicator\": true,\r\n \"allowance_charge_reason\": \"CARGO POR FLETES/FREIGHT CHARGE\",\r\n \"amount\": \"200.00\",\r\n \"base_amount\": \"15840.00\"\r\n }\r\n ],\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"15840.00\",\r\n \"tax_exclusive_amount\": \"15840.00\",\r\n \"tax_inclusive_amount\": \"15840.00\",\r\n \"allowance_total_amount\": \"0.00\",\r\n \"charge_total_amount\": \"200.00\",\r\n \"payable_amount\": \"16040.00\"\r\n },\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"0.00\",\r\n \"percent\": \"0\",\r\n \"taxable_amount\": \"15840.00\"\r\n }\r\n ],\r\n \"invoice_lines\": [\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"5.00\",\r\n \"line_extension_amount\": \"4950.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"4950.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"0.00\",\r\n \"taxable_amount\": \"4950.00\",\r\n \"percent\": \"0.00\"\r\n }\r\n ],\r\n \"description\": \"LEGGINS DE DAMA REF 1032\",\r\n \"brandname\": \"FULLFIT\",\r\n \"modelname\": \"1032\",\r\n \"code\": \"1032\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"990.00\",\r\n \"base_quantity\": \"5.00\"\r\n },\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"6.00\",\r\n \"line_extension_amount\": \"5940.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"5940.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"0.00\",\r\n \"taxable_amount\": \"5940.00\",\r\n \"percent\": \"0.00\"\r\n }\r\n ],\r\n \"description\": \"LEGGINS DE DAMA REF 1087\",\r\n \"brandname\": \"FULLFIT\",\r\n \"modelname\": \"1087\",\r\n \"code\": \"1087\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"990.00\",\r\n \"base_quantity\": \"6.00\"\r\n },\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"5.00\",\r\n \"line_extension_amount\": \"4950.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"4950.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"0.00\",\r\n \"taxable_amount\": \"4950.00\",\r\n \"percent\": \"0.00\"\r\n }\r\n ],\r\n \"description\": \"LEGGINS DE DAMA REF 1088\",\r\n \"brandname\": \"FULLFIT\",\r\n \"modelname\": \"1088\",\r\n \"code\": \"1088\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"990.00\",\r\n \"base_quantity\": \"5.00\"\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "# FACTURA CON SUPLEMENTO K - MONEDA EXTRANJERA\n\n## 📋 Descripción General\nFactura Nacional con **Suplemento K** que permite facturar en moneda extranjera (USD, EUR, etc.) con equivalencia en pesos colombianos. El Suplemento K es un anexo especial que muestra los totales tanto en moneda extranjera como en COP según la TRM del día.\n\n**Request Handler:** `InvoiceController@store` \n**Request Validation:** `InvoiceRequest`\n\n---\n\n## 🔗 URL\n```\nPOST /api/ubl2.1/invoice\n```\n\n---\n\n## 📤 Campo Especial: k_supplement_national\n\nEste campo adicional convierte todos los valores a pesos colombianos según el factor de conversión.\n\n```json\n{\n \"k_supplement_national\": {\n \"FctConvCop\": \"3890\",\n \"MonedaCop\": \"USD\",\n \"SubTotalCop\": \"200.00\",\n \"TotIvaCop\": \"38.00\",\n \"TotalNetoFacturaCop\": \"238.00\",\n \"VlrPagarCop\": \"238.00\"\n }\n}\n```\n\n### Campos del Suplemento K\n\n| Campo | Descripción |\n|-------|-------------|\n| `FctConvCop` | Factor de conversión (TRM) - Ej: 3890 (1 USD = 3890 COP) |\n| `MonedaCop` | Código de moneda extranjera (USD, EUR, GBP, etc.) |\n| `SubTotalCop` | Subtotal en moneda extranjera |\n| `DescuentoDetalleCop` | Descuentos en moneda extranjera |\n| `RecargoDetalleCop` | Recargos en moneda extranjera |\n| `TotalBrutoFacturaCop` | Total bruto en moneda extranjera |\n| `TotIvaCop` | Total IVA en moneda extranjera |\n| `TotIncCop` | Total Impuesto al Consumo en moneda extranjera |\n| `TotBolCop` | Total Impuesto Bolsas en moneda extranjera |\n| `MntImpCop` | Monto total impuestos en moneda extranjera |\n| `TotalNetoFacturaCop` | Total neto en moneda extranjera |\n| `VlrPagarCop` | **Valor total a pagar en moneda extranjera** |\n| `ReteFueCop` | Retención en la fuente en moneda extranjera |\n| `ReteIvaCop` | Retención IVA en moneda extranjera |\n| `ReteIcaCop` | Retención ICA en moneda extranjera |\n\n---\n\n## 💡 Funcionamiento\n\n1. **Factura en moneda extranjera:** Los valores en `invoice_lines`, `legal_monetary_totals` y `tax_totals` van en la moneda extranjera\n2. **Conversión automática:** El sistema calcula equivalencia en COP usando `FctConvCop`\n3. **PDF dual:** La representación gráfica muestra ambos valores (extranjera y COP)\n4. **Transmisión DIAN:** Se envía con ambas representaciones\n\n---\n\n## 📌 Cliente Internacional\n\nEl cliente puede ser extranjero con datos internacionales:\n\n```json\n{\n \"customer\": {\n \"identification_number\": \"FR42128XD090\",\n \"name\": \"CLIENTE INTERNACIONAL\",\n \"type_document_identification_id\": 8,\n \"country_id\": 65,\n \"municipality_name\": \"MIAMI\",\n \"state_name\": \"FLORIDA\"\n }\n}\n```\n\n**Campos especiales:**\n- `municipality_name`: Nombre de ciudad (si country_id != 46)\n- `state_name`: Nombre de estado/provincia\n\n---\n\n## 📌 Notas Importantes\n\n✅ **TRM Oficial:** Usar tasa representativa del mercado del día \n✅ **Monedas soportadas:** USD, EUR, GBP, y otras según ISO 4217 \n✅ **Dual display:** PDF muestra valores en ambas monedas \n✅ **Cliente extranjero:** Usar `type_document_identification_id` = 8 (Pasaporte/extranjero) \n✅ **País destino:** Usar `country_id` correspondiente (tabla: countries)\n\n**Ver documentación completa del endpoint en:** \"Una Linea, Sin Descuentos, Una Tarifa de IVA\"" }, "response": [] }, { "name": "Una Linea, Descuento Global, Una Tarifa de IVA Copy 2", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"number\": 990000172,\r\n\t\"type_document_id\": 1,\r\n\t\"date\": \"2025-10-28\",\r\n\t\"time\": \"04:08:12\",\r\n \"query_uuid\": false,\r\n \"dont_send_yet\": false,\r\n\t\"resolution_number\": \"18760000001\",\r\n\t\"prefix\": \"SETP\",\r\n \"actividadeconomica\": \"6201\",\r\n \"notes\": \"ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA\",\r\n \"disable_confirmation_text\": true,\r\n \"establishment_name\": \"TORRE SOFTWARE NRO 1\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"establishment_email\": \"alternate_email@alternate.com\",\r\n\t\"sendmail\": false,\r\n \"sendmailtome\": false,\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 41946692,\r\n\t\t\"dv\": 6,\r\n\t\t\"name\": \"ELIZABETH CARDONA VILLADA\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexanderobandolondono@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 3,\r\n\t\t\"type_organization_id\": 2,\r\n \"type_liability_id\": 7,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1,\r\n \"tax_id\": 1\r\n\t},\r\n\t\"payment_form\": [\r\n {\r\n \t\t\"payment_form_id\": 2,\r\n\t \t\"duration_measure\": \"30\",\r\n\t\t \"payment_due_date\": \"2025-11-28\",\r\n\t\t \"payment_method_id\": 30\r\n\t },\r\n {\r\n \t\t\"payment_form_id\": 2,\r\n\t \t\"duration_measure\": \"30\",\r\n\t\t \"payment_due_date\": \"2025-11-28\",\r\n\t\t \"payment_method_id\": 10\r\n\t }\r\n ],\t\r\n\t\"allowance_charges\": [\r\n\t\t{\r\n\t\t\t\"discount_id\": 1,\r\n\t\t\t\"charge_indicator\": false,\r\n\t\t\t\"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n\t\t\t\"amount\": \"50000.00\",\r\n\t\t\t\"base_amount\": \"1000000.00\"\r\n\t\t}\r\n\t],\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\"tax_exclusive_amount\": \"840336.134\",\r\n\t\t\"tax_inclusive_amount\": \"1000000.00\",\r\n\t\t\"allowance_total_amount\": \"50000.00\",\r\n\t\t\"payable_amount\": \"950000.00\"\r\n\t},\r\n\t\"tax_totals\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\"percent\": \"19\",\r\n\t\t\t\"taxable_amount\": \"840336.134\"\r\n\t\t}\r\n\t],\r\n\t\"invoice_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\t\t\"taxable_amount\": \"840336.134\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"COMISION POR SERVICIOS\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"COMISION\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"1000000.00\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "## 💰 FACTURA CON DESCUENTO GLOBAL Y MÚLTIPLES FORMAS DE PAGO\n\n### 📋 **Descripción**\nFactura con descuento aplicado a nivel de documento (no por línea) y con múltiples formas de pago en un mismo documento. Útil para empresas que permiten pagos mixtos (ej: parte efectivo, parte transferencia).\n\n### 🔑 **Campos Especiales**\n- **allowance_charges (nivel documento)**: Descuento global que se aplica al total\n - `charge_indicator`: false = descuento, true = cargo\n - `discount_id`: ID del tipo de descuento (tabla `discounts`)\n - `allowance_charge_reason`: Motivo del descuento/cargo\n - `amount`: Valor del descuento\n - `base_amount`: Base sobre la que se calcula\n\n- **payment_form (array)**: Múltiples formas de pago\n - Permite combinar varios métodos de pago en una factura\n - Cada elemento debe tener payment_form_id, payment_method_id, etc.\n\n### 🆚 **Diferencias con Descuento por Línea**\n- **Descuento Global**: Se aplica al total del documento (campo `allowance_charges` a nivel raíz)\n- **Descuento por Línea**: Se aplica a cada producto individualmente (campo `allowance_charges` dentro de `invoice_lines`)\n- Ambos pueden coexistir en el mismo documento\n\n### 💡 **Ejemplo de Uso**\n```json\n{\n \"allowance_charges\": [\n {\n \"charge_indicator\": false,\n \"discount_id\": 1,\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\n \"amount\": \"50000.00\",\n \"base_amount\": \"1000000.00\"\n }\n ],\n \"payment_form\": [\n {\n \"payment_form_id\": 2,\n \"payment_method_id\": 30,\n \"duration_measure\": \"30\"\n },\n {\n \"payment_form_id\": 2,\n \"payment_method_id\": 10,\n \"duration_measure\": \"30\"\n }\n ]\n}\n```\n\n### 📌 **Notas**\n- El descuento global reduce el `line_extension_amount` total\n- Los impuestos se calculan sobre el valor **después** del descuento\n- `allowance_total_amount` debe reflejarse en `legal_monetary_totals`\n- Puede tener múltiples descuentos/cargos globales\n- El array `payment_form` soporta múltiples métodos de pago\n- payment_method_id: 10=Efectivo, 30=Transferencia, 42=Consignación, etc. (tabla: payment_methods)\n\n_Ver primer endpoint de Factura para documentación completa de campos base._" }, "response": [] }, { "name": "Additional Document Reference, Una Linea, Descuento Global, Una Tarifa de IVA", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"number\": 990000173,\r\n\t\"type_document_id\": 1,\r\n\t\"date\": \"2025-10-28\",\r\n\t\"time\": \"04:08:12\",\r\n \"query_uuid\": false,\r\n\t\"resolution_number\": \"18760000001\",\r\n\t\"prefix\": \"SETP\",\r\n \"actividadeconomica\": \"6201\",\r\n \"notes\": \"ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA\",\r\n \"disable_confirmation_text\": true,\r\n \"establishment_name\": \"TORRE SOFTWARE NRO 1\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"establishment_email\": \"alternate_email@alternate.com\",\r\n\t\"sendmail\": true,\r\n \"sendmailtome\": false,\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 41946692,\r\n\t\t\"dv\": 6,\r\n\t\t\"name\": \"ELIZABETH CARDONA VILLADA\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexander_obando@hotmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 3,\r\n\t\t\"type_organization_id\": 2,\r\n \"type_liability_id\": 7,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1,\r\n \"tax_id\": 1\r\n\t},\r\n \"additional_document_reference\": {\r\n \"id\": \"A23061977FBC\",\r\n \"date\": \"2020-10-01\",\r\n \"type_document_id\": 1\r\n },\r\n\t\"payment_form\": [\r\n {\r\n \t\t\"payment_form_id\": 2,\r\n\t \t\"duration_measure\": \"30\",\r\n\t\t \"payment_due_date\": \"2025-11-28\",\r\n\t\t \"payment_method_id\": 30\r\n\t },\r\n {\r\n \t\t\"payment_form_id\": 2,\r\n\t \t\"duration_measure\": \"30\",\r\n\t\t \"payment_due_date\": \"2025-11-28\",\r\n\t\t \"payment_method_id\": 10\r\n\t }\r\n ],\t\r\n\t\"allowance_charges\": [\r\n\t\t{\r\n\t\t\t\"discount_id\": 1,\r\n\t\t\t\"charge_indicator\": false,\r\n\t\t\t\"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n\t\t\t\"amount\": \"50000.00\",\r\n\t\t\t\"base_amount\": \"1000000.00\"\r\n\t\t}\r\n\t],\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\"tax_exclusive_amount\": \"840336.134\",\r\n\t\t\"tax_inclusive_amount\": \"1000000.00\",\r\n\t\t\"allowance_total_amount\": \"50000.00\",\r\n\t\t\"payable_amount\": \"950000.00\"\r\n\t},\r\n\t\"tax_totals\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\"percent\": \"19\",\r\n\t\t\t\"taxable_amount\": \"840336.134\"\r\n\t\t}\r\n\t],\r\n\t\"invoice_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\t\t\"taxable_amount\": \"840336.134\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"COMISION POR SERVICIOS\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"COMISION\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"1000000.00\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t],\r\n \"logo_empresa_emisora\": \"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ZmYABgAAAAAAAQAvZmYAAQChmZoABgAAAAAAAQAyAAAAAQBaAAAABgAAAAAAAQA1AAAAAQAtAAAABgAAAAAAAThCSU0D+AAAAAAAcAAA/////////////////////////////wPoAAAAAP////////////////////////////8D6AAAAAD/////////////////////////////A+gAAAAA/////////////////////////////wPoAAA4QklNBAAAAAAAAAIAADhCSU0EAgAAAAAABAAAAAA4QklNBDAAAAAAAAIBAThCSU0ELQAAAAAABgABAAAABjhCSU0ECAAAAAAAEAAAAAEAAAJAAAACQAAAAAA4QklNBB4AAAAAAAQAAAAAOEJJTQQaAAAAAANbAAAABgAAAAAAAAAAAAAFiQAABYkAAAATAEwAbwBnAG8AIABUAG8AcgByAGUAIABTAG8AZgB0AHcAYQByAGUAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAABYkAAAWJAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAEAAAAAAABudWxsAAAAAgAAAAZib3VuZHNPYmpjAAAAAQAAAAAAAFJjdDEAAAAEAAAAAFRvcCBsb25nAAAAAAAAAABMZWZ0bG9uZwAAAAAAAAAAQnRvbWxvbmcAAAWJAAAAAFJnaHRsb25nAAAFiQAAAAZzbGljZXNWbExzAAAAAU9iamMAAAABAAAAAAAFc2xpY2UAAAASAAAAB3NsaWNlSURsb25nAAAAAAAAAAdncm91cElEbG9uZwAAAAAAAAAGb3JpZ2luZW51bQAAAAxFU2xpY2VPcmlnaW4AAAANYXV0b0dlbmVyYXRlZAAAAABUeXBlZW51bQAAAApFU2xpY2VUeXBlAAAAAEltZyAAAAAGYm91bmRzT2JqYwAAAAEAAAAAAABSY3QxAAAABAAAAABUb3AgbG9uZwAAAAAAAAAATGVmdGxvbmcAAAAAAAAAAEJ0b21sb25nAAAFiQAAAABSZ2h0bG9uZwAABYkAAAADdXJsVEVYVAAAAAEAAAAAAABudWxsVEVYVAAAAAEAAAAAAABNc2dlVEVYVAAAAAEAAAAAAAZhbHRUYWdURVhUAAAAAQAAAAAADmNlbGxUZXh0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eG1wTU09Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9tbS8iIHhtbG5zOnN0RXZ0PSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvc1R5cGUvUmVzb3VyY2VFdmVudCMiIHhtbG5zOnN0UmVmPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvc1R5cGUvUmVzb3VyY2VSZWYjIiB4bWxuczpwaG90b3Nob3A9Imh0dHA6Ly9ucy5hZG9iZS5jb20vcGhvdG9zaG9wLzEuMC8iIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIENTNiAoV2luZG93cykiIHhtcDpDcmVhdGVEYXRlPSIyMDE4LTA3LTA5VDExOjQ3OjA0LTA1OjAwIiB4bXA6TWV0YWRhdGFEYXRlPSIyMDE4LTA3LTA5VDExOjUyOjM5LTA1OjAwIiB4bXA6TW9kaWZ5RGF0ZT0iMjAxOC0wNy0wOVQxMTo1MjozOS0wNTowMCIgZGM6Zm9ybWF0PSJpbWFnZS9qcGVnIiB4bXBNTTpJbnN0YW5jZUlEPSJ4bXAuaWlkOkYyNEJDOUI1OTc4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiB4bXBNTTpEb2N1bWVudElEPSJ4bXAuZGlkOkY1NTZDQTA1OTU4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiB4bXBNTTpPcmlnaW5hbERvY3VtZW50SUQ9InhtcC5kaWQ6RUU0QkM5QjU5NzgzRTgxMTg3OURGNDdGRDNGOEYzNzciIHBob3Rvc2hvcDpDb2xvck1vZGU9IjMiPg0KCQkJPHhtcE1NOkhpc3Rvcnk+DQoJCQkJPHJkZjpTZXE+DQoJCQkJCTxyZGY6bGkgc3RFdnQ6YWN0aW9uPSJjcmVhdGVkIiBzdEV2dDppbnN0YW5jZUlEPSJ4bXAuaWlkOkVFNEJDOUI1OTc4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiBzdEV2dDp3aGVuPSIyMDE4LTA3LTA5VDExOjQ3OjA0LTA1OjAwIiBzdEV2dDpzb2Z0d2FyZUFnZW50PSJBZG9iZSBQaG90b3Nob3AgQ1M2IChXaW5kb3dzKSIvPg0KCQkJCQk8cmRmOmxpIHN0RXZ0OmFjdGlvbj0ic2F2ZWQiIHN0RXZ0Omluc3RhbmNlSUQ9InhtcC5paWQ6RjE0QkM5QjU5NzgzRTgxMTg3OURGNDdGRDNGOEYzNzciIHN0RXZ0OndoZW49IjIwMTgtMDctMDlUMTE6NTI6MzktMDU6MDAiIHN0RXZ0OnNvZnR3YXJlQWdlbnQ9IkFkb2JlIFBob3Rvc2hvcCBDUzYgKFdpbmRvd3MpIiBzdEV2dDpjaGFuZ2VkPSIvIi8+DQoJCQkJCTxyZGY6bGkgc3RFdnQ6YWN0aW9uPSJjb252ZXJ0ZWQiIHN0RXZ0OnBhcmFtZXRlcnM9ImZyb20gYXBwbGljYXRpb24vdm5kLmFkb2JlLnBob3Rvc2hvcCB0byBpbWFnZS9qcGVnIi8+DQoJCQkJCTxyZGY6bGkgc3RFdnQ6YWN0aW9uPSJkZXJpdmVkIiBzdEV2dDpwYXJhbWV0ZXJzPSJjb252ZXJ0ZWQgZnJvbSBhcHBsaWNhdGlvbi92bmQuYWRvYmUucGhvdG9zaG9wIHRvIGltYWdlL2pwZWciLz4NCgkJCQkJPHJkZjpsaSBzdEV2dDphY3Rpb249InNhdmVkIiBzdEV2dDppbnN0YW5jZUlEPSJ4bXAuaWlkOkYyNEJDOUI1OTc4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiBzdEV2dDp3aGVuPSIyMDE4LTA3LTA5VDExOjUyOjM5LTA1OjAwIiBzdEV2dDpzb2Z0d2FyZUFnZW50PSJBZG9iZSBQaG90b3Nob3AgQ1M2IChXaW5kb3dzKSIgc3RFdnQ6Y2hhbmdlZD0iLyIvPg0KCQkJCTwvcmRmOlNlcT4NCgkJCTwveG1wTU06SGlzdG9yeT4NCgkJCTx4bXBNTTpEZXJpdmVkRnJvbSBzdFJlZjppbnN0YW5jZUlEPSJ4bXAuaWlkOkYxNEJDOUI1OTc4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiBzdFJlZjpkb2N1bWVudElEPSJ4bXAuZGlkOkY1NTZDQTA1OTU4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiBzdFJlZjpvcmlnaW5hbERvY3VtZW50SUQ9InhtcC5kaWQ6RUU0QkM5QjU5NzgzRTgxMTg3OURGNDdGRDNGOEYzNzciLz4NCgkJPC9yZGY6RGVzY3JpcHRpb24+DQoJPC9yZGY6UkRGPg0KPC94OnhtcG1ldGE+DQogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICA8P3hwYWNrZXQgZW5kPSd3Jz8+/9sAQwACAQECAQECAgICAgICAgMFAwMDAwMGBAQDBQcGBwcHBgcHCAkLCQgICggHBwoNCgoLDAwMDAcJDg8NDA4LDAwM/9sAQwECAgIDAwMGAwMGDAgHCAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwM/8AAEQgAawBrAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/aAAwDAQACEQMRAD8A/fyiiigAooqnrviKx8Mae11qF1DZ26/xyNjJ9B3J9hyaaTbsgLlZnijxjpngyx+0aneQ2sf8Ibl3PoqjLMfYA15V46/afknMlv4ft/LXp9suF+Y/7kf9W/75ryrU9Uut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\"\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "# 📄 ENVIAR FACTURA ELECTRÓNICA - REFERENCIA A DOCUMENTO ADICIONAL\n\n## 📋 Descripción General\nEndpoint para el envío de facturas electrónicas que referencian documentos adicionales mediante el campo `additional_document_reference`. Permite vincular la factura con documentos previos como órdenes de compra, contratos, remisiones u otros documentos relacionados.\n\n## 🔗 URL del Endpoint\n**Síncrono (recomendado):** `POST /api/ubl2.1/invoice`\n**Asíncrono:** `POST /api/ubl2.1/invoice/{testSetId}`\n\n## 🔑 Campo Principal Específico: additional_document_reference\n| Campo | Tipo | Obligatorio | Descripción |\n|-------|------|-------------|-------------|\n| `additional_document_reference` | object | No | Objeto para referenciar documento adicional |\n| `additional_document_reference.id` | string | Sí | Identificador único del documento referenciado |\n| `additional_document_reference.date` | date | Sí | Fecha del documento referenciado (formato: YYYY-MM-DD) |\n| `additional_document_reference.type_document_id` | integer | Sí | Tipo de documento referenciado según catálogo DIAN |\n\n## 📑 Tipos de Documentos Referenciables (type_document_id)\n| ID | Tipo de Documento | Descripción |\n|----|-------------------|-------------|\n| 1 | Factura | Referencia a otra factura |\n| 2 | Nota Débito | Referencia a nota débito |\n| 3 | Nota Crédito | Referencia a nota crédito |\n| 4 | Orden de Compra | Orden de compra del cliente |\n| 5 | Contrato | Contrato comercial |\n| 6 | Remisión | Guía de despacho o remisión |\n| 7 | Documento Soporte | Documento de soporte de pago |\n| 8 | Otro | Otros tipos de documentos |\n\n## 💡 Casos de Uso Comunes\n1. **Factura por Orden de Compra:** Vincular factura con orden de compra del cliente\n2. **Factura por Contrato:** Referenciar contrato marco que ampara la facturación\n3. **Factura con Remisión:** Asociar factura con guía de despacho previa\n4. **Factura Complementaria:** Referenciar factura o documento anterior\n5. **Factura de Proyecto:** Vincular con documento de autorización del proyecto\n\n## 🔍 Ejemplo de Estructura\n```json\n\"additional_document_reference\": {\n \"id\": \"A23061977FBC\",\n \"date\": \"2020-10-01\",\n \"type_document_id\": 4\n}\n```\n\n## 💳 Forma de Pago\nEste ejemplo también demuestra múltiples formas de pago:\n```json\n\"payment_form\": [\n {\n \"payment_form_id\": 2,\n \"duration_measure\": \"30\",\n \"payment_due_date\": \"2025-11-28\",\n \"payment_method_id\": 30\n },\n {\n \"payment_form_id\": 2,\n \"duration_measure\": \"30\",\n \"payment_due_date\": \"2025-11-28\",\n \"payment_method_id\": 10\n }\n]\n```\n\n## ⚙️ Comportamiento del Sistema\n- **Modo Síncrono:** Respuesta inmediata con validación DIAN\n- **Modo Asíncrono:** Procesamiento diferido con ZIP_KEY\n- **Validación de Referencia:** El sistema NO valida la existencia del documento referenciado\n- **XML UBL:** La referencia se incluye en el elemento ``\n- **Trazabilidad:** Permite seguimiento de relaciones entre documentos\n\n## ✅ Validaciones Críticas\n- Validación de formato de `id` (alfanumérico)\n- Validación de formato de fecha ISO 8601 (YYYY-MM-DD)\n- Validación de `type_document_id` contra catálogo DIAN\n- La fecha del documento referenciado debe ser anterior o igual a la fecha de la factura\n- El campo `id` no puede estar vacío\n\n## 💾 Impacto en Base de Datos\n- Almacenamiento de la referencia en tabla `documents`\n- Campo JSON: `additional_document_reference`\n- Indexación para búsquedas por documento referenciado\n- No se valida existencia del documento en base de datos\n\n## 📤 Respuesta Exitosa (200 - Síncrono)\n```json\n{\n \"success\": true,\n \"message\": \"Factura procesada exitosamente\",\n \"ResponseDian\": {\n \"Envelope\": {\n \"Body\": {\n \"SendBillSyncResponse\": {\n \"SendBillSyncResult\": {\n \"IsValid\": \"true\",\n \"StatusCode\": \"00\",\n \"StatusDescription\": \"Procesado Correctamente\"\n }\n }\n }\n }\n },\n \"cufe\": \"...\",\n \"additional_document_reference\": {\n \"id\": \"A23061977FBC\",\n \"date\": \"2020-10-01\",\n \"type_document_id\": 4\n },\n \"pdf_url\": \"storage/pdf/SETP990000173.pdf\"\n}\n```\n\n## 📤 Respuesta Exitosa (200 - Asíncrono)\n```json\n{\n \"success\": true,\n \"message\": \"Factura enviada al set de pruebas\",\n \"zip_key\": \"...\",\n \"document_reference_included\": true\n}\n```\n\n## ⚠️ Errores Comunes\n- **400:** Formato de fecha inválido en `additional_document_reference.date`\n- **401:** Token de autorización inválido (API_TOKEN)\n- **422:** `type_document_id` no existe en catálogo, campo `id` vacío, o fecha futura\n- **500:** Error interno del servidor al procesar la referencia\n\n## 🔐 Autenticación\n```\nAuthorization: Bearer {API_TOKEN}\nContent-Type: application/json\n```\nEl API_TOKEN se obtiene del Paso 1 - Config Company\n\n## 💻 Ejemplo cURL\n```bash\ncurl -X POST \"http://midominio.com/api/ubl2.1/invoice\" \\\n -H \"Authorization: Bearer 4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"number\": 990000173,\n \"type_document_id\": 1,\n \"date\": \"2025-10-28\",\n \"additional_document_reference\": {\n \"id\": \"OC-2020-12345\",\n \"date\": \"2020-10-01\",\n \"type_document_id\": 4\n },\n \"customer\": {...},\n \"invoice_lines\": [...]\n }'\n```\n\n## 📝 Campos Relacionados\n- **notes:** Notas adicionales sobre el documento referenciado\n- **head_note:** Puede incluir referencia al documento en el encabezado del PDF\n- **establishment_name:** Nombre del establecimiento emisor\n- **allowance_charges:** Descuentos globales aplicados a la factura\n\n## 🔗 XML UBL Generado\n```xml\n\n A23061977FBC\n 2020-10-01\n 4\n\n```\n\n## 📌 Notas Importantes\n1. El campo `additional_document_reference` es OPCIONAL\n2. Solo se puede referenciar UN documento adicional por factura\n3. El sistema NO verifica la existencia del documento referenciado\n4. La fecha debe estar en formato ISO 8601 (YYYY-MM-DD)\n5. Para múltiples referencias, usar notas o campos personalizados\n6. El `id` puede ser alfanumérico y admite guiones y espacios\n7. Consultar catálogo completo de `type_document_id` en documentación DIAN\n8. La referencia aparece en el PDF de la representación gráfica\n9. Útil para auditorías y trazabilidad de documentos comerciales\n10. El modo síncrono es recomendado para validación inmediata" }, "response": [] }, { "name": "Formato tirilla, Una Linea, Descuento Global, Una Tarifa de IVA", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"number\": 990000174,\r\n\t\"type_document_id\": 1,\r\n\t\"date\": \"2025-10-28\",\r\n\t\"time\": \"04:08:12\",\r\n \"invoice_template\": \"3\",\r\n \"template_token\": \"$2y$10$GEtWBadfR3aRNfwDyKxnc.TM0tU6hDZ3cmQF7VoiPFTAwUhci2Ehq\",\r\n\t\"resolution_number\": \"18760000001\",\r\n\t\"prefix\": \"SETP\",\r\n \"actividadeconomica\": \"6201\",\r\n \"disable_confirmation_text\": true,\r\n \"establishment_name\": \"TORRE SOFTWARE NRO 1\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"establishment_email\": \"alternate_email@alternate.com\",\r\n\t\"sendmail\": true,\r\n \"sendmailtome\": false,\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 41946692,\r\n\t\t\"dv\": 6,\r\n\t\t\"name\": \"ELIZABETH CARDONA VILLADA\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexander_obando@hotmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 3,\r\n\t\t\"type_organization_id\": 2,\r\n \"type_liability_id\": 7,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1,\r\n \"tax_id\": 1\r\n\t},\r\n\t\"payment_form\": [\r\n {\r\n \t\t\"payment_form_id\": 2,\r\n\t \t\"duration_measure\": \"30\",\r\n\t\t \"payment_due_date\": \"2025-11-28\",\r\n\t\t \"payment_method_id\": 30\r\n\t },\r\n {\r\n \t\t\"payment_form_id\": 2,\r\n\t \t\"duration_measure\": \"30\",\r\n\t\t \"payment_due_date\": \"2025-11-28\",\r\n\t\t \"payment_method_id\": 10\r\n\t }\r\n ],\t\r\n\t\"allowance_charges\": [\r\n\t\t{\r\n\t\t\t\"discount_id\": 1,\r\n\t\t\t\"charge_indicator\": false,\r\n\t\t\t\"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n\t\t\t\"amount\": \"50000.00\",\r\n\t\t\t\"base_amount\": \"1000000.00\"\r\n\t\t}\r\n\t],\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\"tax_exclusive_amount\": \"840336.134\",\r\n\t\t\"tax_inclusive_amount\": \"1000000.00\",\r\n\t\t\"allowance_total_amount\": \"50000.00\",\r\n\t\t\"payable_amount\": \"950000.00\"\r\n\t},\r\n\t\"tax_totals\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\"percent\": \"19\",\r\n\t\t\t\"taxable_amount\": \"840336.134\"\r\n\t\t}\r\n\t],\r\n\t\"invoice_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\t\t\"taxable_amount\": \"840336.134\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"COMISION POR SERVICIOS\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"COMISION\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"1000000.00\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t],\r\n \"logo_empresa_emisora\": \"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ZmYABgAAAAAAAQAvZmYAAQChmZoABgAAAAAAAQAyAAAAAQBaAAAABgAAAAAAAQA1AAAAAQAtAAAABgAAAAAAAThCSU0D+AAAAAAAcAAA/////////////////////////////wPoAAAAAP////////////////////////////8D6AAAAAD/////////////////////////////A+gAAAAA/////////////////////////////wPoAAA4QklNBAAAAAAAAAIAADhCSU0EAgAAAAAABAAAAAA4QklNBDAAAAAAAAIBAThCSU0ELQAAAAAABgABAAAABjhCSU0ECAAAAAAAEAAAAAEAAAJAAAACQAAAAAA4QklNBB4AAAAAAAQAAAAAOEJJTQQaAAAAAANbAAAABgAAAAAAAAAAAAAFiQAABYkAAAATAEwAbwBnAG8AIABUAG8AcgByAGUAIABTAG8AZgB0AHcAYQByAGUAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAABYkAAAWJAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAEAAAAAAABudWxsAAAAAgAAAAZib3VuZHNPYmpjAAAAAQAAAAAAAFJjdDEAAAAEAAAAAFRvcCBsb25nAAAAAAAAAABMZWZ0bG9uZwAAAAAAAAAAQnRvbWxvbmcAAAWJAAAAAFJnaHRsb25nAAAFiQAAAAZzbGljZXNWbExzAAAAAU9iamMAAAABAAAAAAAFc2xpY2UAAAASAAAAB3NsaWNlSURsb25nAAAAAAAAAAdncm91cElEbG9uZwAAAAAAAAAGb3JpZ2luZW51bQAAAAxFU2xpY2VPcmlnaW4AAAANYXV0b0dlbmVyYXRlZAAAAABUeXBlZW51bQAAAApFU2xpY2VUeXBlAAAAAEltZyAAAAAGYm91bmRzT2JqYwAAAAEAAAAAAABSY3QxAAAABAAAAABUb3AgbG9uZwAAAAAAAAAATGVmdGxvbmcAAAAAAAAAAEJ0b21sb25nAAAFiQAAAABSZ2h0bG9uZwAABYkAAAADdXJsVEVYVAAAAAEAAAAAAABudWxsVEVYVAAAAAEAAAAAAABNc2dlVEVYVAAAAAEAAAAAAAZhbHRUYWdURVhUAAAAAQAAAAAADmNlbGxUZXh0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eG1wTU09Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9tbS8iIHhtbG5zOnN0RXZ0PSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvc1R5cGUvUmVzb3VyY2VFdmVudCMiIHhtbG5zOnN0UmVmPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvc1R5cGUvUmVzb3VyY2VSZWYjIiB4bWxuczpwaG90b3Nob3A9Imh0dHA6Ly9ucy5hZG9iZS5jb20vcGhvdG9zaG9wLzEuMC8iIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIENTNiAoV2luZG93cykiIHhtcDpDcmVhdGVEYXRlPSIyMDE4LTA3LTA5VDExOjQ3OjA0LTA1OjAwIiB4bXA6TWV0YWRhdGFEYXRlPSIyMDE4LTA3LTA5VDExOjUyOjM5LTA1OjAwIiB4bXA6TW9kaWZ5RGF0ZT0iMjAxOC0wNy0wOVQxMTo1MjozOS0wNTowMCIgZGM6Zm9ybWF0PSJpbWFnZS9qcGVnIiB4bXBNTTpJbnN0YW5jZUlEPSJ4bXAuaWlkOkYyNEJDOUI1OTc4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiB4bXBNTTpEb2N1bWVudElEPSJ4bXAuZGlkOkY1NTZDQTA1OTU4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiB4bXBNTTpPcmlnaW5hbERvY3VtZW50SUQ9InhtcC5kaWQ6RUU0QkM5QjU5NzgzRTgxMTg3OURGNDdGRDNGOEYzNzciIHBob3Rvc2hvcDpDb2xvck1vZGU9IjMiPg0KCQkJPHhtcE1NOkhpc3Rvcnk+DQoJCQkJPHJkZjpTZXE+DQoJCQkJCTxyZGY6bGkgc3RFdnQ6YWN0aW9uPSJjcmVhdGVkIiBzdEV2dDppbnN0YW5jZUlEPSJ4bXAuaWlkOkVFNEJDOUI1OTc4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiBzdEV2dDp3aGVuPSIyMDE4LTA3LTA5VDExOjQ3OjA0LTA1OjAwIiBzdEV2dDpzb2Z0d2FyZUFnZW50PSJBZG9iZSBQaG90b3Nob3AgQ1M2IChXaW5kb3dzKSIvPg0KCQkJCQk8cmRmOmxpIHN0RXZ0OmFjdGlvbj0ic2F2ZWQiIHN0RXZ0Omluc3RhbmNlSUQ9InhtcC5paWQ6RjE0QkM5QjU5NzgzRTgxMTg3OURGNDdGRDNGOEYzNzciIHN0RXZ0OndoZW49IjIwMTgtMDctMDlUMTE6NTI6MzktMDU6MDAiIHN0RXZ0OnNvZnR3YXJlQWdlbnQ9IkFkb2JlIFBob3Rvc2hvcCBDUzYgKFdpbmRvd3MpIiBzdEV2dDpjaGFuZ2VkPSIvIi8+DQoJCQkJCTxyZGY6bGkgc3RFdnQ6YWN0aW9uPSJjb252ZXJ0ZWQiIHN0RXZ0OnBhcmFtZXRlcnM9ImZyb20gYXBwbGljYXRpb24vdm5kLmFkb2JlLnBob3Rvc2hvcCB0byBpbWFnZS9qcGVnIi8+DQoJCQkJCTxyZGY6bGkgc3RFdnQ6YWN0aW9uPSJkZXJpdmVkIiBzdEV2dDpwYXJhbWV0ZXJzPSJjb252ZXJ0ZWQgZnJvbSBhcHBsaWNhdGlvbi92bmQuYWRvYmUucGhvdG9zaG9wIHRvIGltYWdlL2pwZWciLz4NCgkJCQkJPHJkZjpsaSBzdEV2dDphY3Rpb249InNhdmVkIiBzdEV2dDppbnN0YW5jZUlEPSJ4bXAuaWlkOkYyNEJDOUI1OTc4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiBzdEV2dDp3aGVuPSIyMDE4LTA3LTA5VDExOjUyOjM5LTA1OjAwIiBzdEV2dDpzb2Z0d2FyZUFnZW50PSJBZG9iZSBQaG90b3Nob3AgQ1M2IChXaW5kb3dzKSIgc3RFdnQ6Y2hhbmdlZD0iLyIvPg0KCQkJCTwvcmRmOlNlcT4NCgkJCTwveG1wTU06SGlzdG9yeT4NCgkJCTx4bXBNTTpEZXJpdmVkRnJvbSBzdFJlZjppbnN0YW5jZUlEPSJ4bXAuaWlkOkYxNEJDOUI1OTc4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiBzdFJlZjpkb2N1bWVudElEPSJ4bXAuZGlkOkY1NTZDQTA1OTU4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiBzdFJlZjpvcmlnaW5hbERvY3VtZW50SUQ9InhtcC5kaWQ6RUU0QkM5QjU5NzgzRTgxMTg3OURGNDdGRDNGOEYzNzciLz4NCgkJPC9yZGY6RGVzY3JpcHRpb24+DQoJPC9yZGY6UkRGPg0KPC94OnhtcG1ldGE+DQogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICA8P3hwYWNrZXQgZW5kPSd3Jz8+/9sAQwACAQECAQECAgICAgICAgMFAwMDAwMGBAQDBQcGBwcHBgcHCAkLCQgICggHBwoNCgoLDAwMDAcJDg8NDA4LDAwM/9sAQwECAgIDAwMGAwMGDAgHCAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwM/8AAEQgAawBrAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/aAAwDAQACEQMRAD8A/fyiiigAooqnrviKx8Mae11qF1DZ26/xyNjJ9B3J9hyaaTbsgLlZnijxjpngyx+0aneQ2sf8Ibl3PoqjLMfYA15V46/afknMlv4ft/LXp9suF+Y/7kf9W/75ryrU9Uut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\"\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "📄 ENVIAR FACTURA ELECTRÓNICA - FORMATO TIRILLA\n\n## 🔗 Descripción General\nEste endpoint permite enviar facturas electrónicas en formato TIRILLA (thermal receipt format) para impresoras térmicas POS. El formato tirilla es especialmente útil para terminales de punto de venta que requieren impresión directa en papel térmico sin necesidad de formatos complejos.\n\n## 📋 URL del Endpoint\n\n- **Modo Síncrono (respuesta inmediata):**\n```\nhttp://apidian2026-8.oo/api/ubl2.1/invoice\n```\n\n- **Modo Asíncrono (con set de pruebas de DIAN):**\n```\nhttp://apidian2026-8.oo/api/ubl2.1/invoice/{iddelsetdepruebasdeladian}\n```\n\n**Nota:** Si tiene un dominio configurado, reemplace `apidian2026-8.oo` con su dominio registrado.\n\n## 🔑 Campos Principales\n\nEsta solicitud implementa los siguientes campos específicos para el formato tirilla:\n\n| Campo | Tipo | Descripción | Ejemplo |\n|-------|------|-------------|----------|\n| `invoice_template` | String (\"1\"-\"4\") | Especifica la plantilla de impresión para tirilla: 1=Básica, 2=Logo Centrado, 3=Compacta, 4=Detallada | \"3\" |\n| `template_token` | String (bcrypt) | Token de autenticación bcrypt para validar la plantilla. Generado al crear la plantilla en configuración | \"$2y$10$GEtWBadfR3aRNfwDyKxnc...\" |\n| `disable_confirmation_text` | Boolean | Deshabilita el texto de confirmación en la impresión | true |\n| `logo_empresa_emisora` | String (base64) | Logotipo de la empresa en formato Base64 (800x600px máx., 2MB) | \"/9j/4AAQSkZJRg...\" |\n| `establishment_name` | String | Nombre del establecimiento para impresión | \"TORRE SOFTWARE NRO 1\" |\n| `establishment_address` | String | Dirección del establecimiento | \"BRR LIMONAR MZ 6 CS 3\" |\n| `establishment_phone` | String | Teléfono del establecimiento | \"3226563672\" |\n| `establishment_municipality` | Number | Código DANE del municipio | 600 |\n| `establishment_email` | String | Email del establecimiento | \"info@empresa.com\" |\n\n## 🎨 Plantillas Disponibles\n\n| Código | Nombre | Descripción | Casos de Uso |\n|--------|--------|-------------|---------------|\n| 1 | Básica | Formato simple sin decoraciones | Tiendas pequeñas, cafeterías |\n| 2 | Logo Centrado | Logo empresarial centrado en la parte superior | Retail, restaurantes premium |\n| 3 | Compacta | Información condensada para papeles estrechos (80mm) | Comercios con poco espacio |\n| 4 | Detallada | Incluye información completa de cliente y detalles del producto | Farmacias, supermercados |\n\n## 🔐 Token de Plantilla (template_token)\n\nEl `template_token` es un hash bcrypt que valida la identidad de la plantilla:\n\n- **Formato:** `$2y$10$GEtWBadfR3aRNfwDyKxnc.TM0tU6hDZ3cmQF7VoiPFTAwUhci2Ehq`\n- **Propósito:** Prevenir alteración de plantillas por terceros\n- **Generación:** Creado automáticamente al definir la plantilla en `/api/config/templates`\n- **Validación:** El servidor verifica el token antes de usar la plantilla\n- **Seguridad:** Nunca comparta tokens entre diferentes empresas o puntos de venta\n\n## 🖼️ Logo de la Empresa\n\nEl campo `logo_empresa_emisora` acepta la imagen en formato Base64:\n\n- **Formato de imagen:** JPG, PNG (convertido a JPG internamente)\n- **Tamaño recomendado:** 800x600 píxeles\n- **Tamaño máximo:** 2MB\n- **Proceso:** La API comprime automáticamente a 2MB si es necesario\n- **Ubicación en impresión:** Encabezado de la tirilla\n- **Nota:** Solo se usa si la plantilla seleccionada incluye logo\n\n## 🏢 Datos del Establecimiento\n\nLos campos de establecimiento permiten sobrescribir la configuración por defecto de la empresa:\n\n```json\n\"establishment_name\": \"TORRE SOFTWARE NRO 1\",\n\"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\n\"establishment_phone\": \"3226563672\",\n\"establishment_municipality\": 600,\n\"establishment_email\": \"alternate_email@alternate.com\"\n```\n\n**Uso:** Útil para empresas con múltiples sucursales que desean diferente información por establecimiento.\n\n## 💳 Formas de Pago\n\nEsta solicitud incluye múltiples formas de pago registradas en el array `payment_form`:\n\n```json\n\"payment_form\": [\n {\n \"payment_form_id\": 2, // Forma: 2=Crédito\n \"duration_measure\": \"30\", // Plazo en días\n \"payment_due_date\": \"2025-11-28\",\n \"payment_method_id\": 30 // Método: 30=Tarjeta Crédito\n },\n {\n \"payment_form_id\": 2,\n \"duration_measure\": \"30\",\n \"payment_due_date\": \"2025-11-28\",\n \"payment_method_id\": 10 // Método: 10=Efectivo\n }\n]\n```\n\n## 📊 Estructura del Ejemplo\n\nEsta solicitud incluye una factura de ejemplo con los siguientes valores:\n\n- **Número:** 990000174\n- **Valor base:** $1,000,000.00\n- **Descuento global:** $50,000.00 (5%)\n- **IVA (19%):** $159,663.87\n- **Valor total:** $950,000.00\n- **Líneas:** 1 producto con descripción \"COMISION POR SERVICIOS\"\n- **Impuesto:** Una tarifa de IVA del 19%\n\n## 📌 Notas Importantes\n\n1. **Token de Plantilla Obligatorio:** El `template_token` debe ser válido y coincidir con la plantilla especificada en `invoice_template`. Sin este token, la solicitud será rechazada.\n\n2. **Validación de Base64:** El campo `logo_empresa_emisora` debe ser un string Base64 válido. La API rechaza datos inválidos o no Base64.\n\n3. **Estándares de Plantilla:** Las plantillas deben cumplir con estándares de UBL 2.1 para Colombia (DIAN).\n\n4. **Compatibilidad POS:** Las plantillas están diseñadas para impresoras térmicas estándar de 80mm y 58mm de ancho.\n\n5. **Deshabilitación de Confirmación:** `disable_confirmation_text: true` omite el mensaje de confirmación en la impresión para optimizar papel.\n\n6. **Datos del Establecimiento:** Los campos `establishment_*` son opcionales. Si se omiten, se usan los valores del Paso 1 - Config Company.\n\n7. **Modo Asíncrono vs Síncrono:** El modo asíncrono requiere consultar el estado posterior usando el endpoint `.../ubl2.1/status/zip` con el ZIP_KEY devuelto.\n\n8. **Set de Pruebas DIAN:** El parámetro `iddelsetdepruebasdeladian` es obligatorio en modo asíncrono para registrar las pruebas con DIAN.\n\n9. **Formato de Respuesta:** La respuesta incluye el XML UBL firmado digitalmente, ZIP_KEY (para consultas posteriores), y estado de validación DIAN.\n\n10. **Errores de Validación:** En modo síncrono, errores de validación se devuelven inmediatamente. En modo asíncrono, consulte el estado usando el ZIP_KEY.\n\n11. **Email de Envío:** El flag `sendmail: true` envía la factura al email del cliente. `sendmailtome: false` omite la copia al emisor.\n\n12. **Resolución de Facturación:** El campo `resolution_number` (18760000001) debe estar registrado en DIAN y ser del tipo \"Resolución de Facturación\" para facturas electrónicas." }, "response": [] }, { "name": "Tres Lineas, Descuento Global, Una Tarifa de IVA", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": 990000175,\r\n \"type_document_id\": 1,\r\n \"date\": \"2025-10-28\",\r\n \"time\": \"04:08:12\",\r\n \"resolution_number\": \"18760000001\",\r\n \"prefix\": \"SETP\",\r\n \"actividadeconomica\": \"6201\",\r\n \"notes\": \"ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA\",\r\n \"disable_confirmation_text\": true,\r\n \"establishment_name\": \"TORRE SOFTWARE NRO 1\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"establishment_email\": \"alternate_email@alternate.com\",\r\n \"sendmail\": true,\r\n \"sendmailtome\": false,\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"customer\": {\r\n \"identification_number\": 41946692,\r\n \"dv\": 6,\r\n \"name\": \"ELIZABETH CARDONA VILLADA\",\r\n \"phone\": \"3103891693\",\r\n \"address\": \"CLL 4 NRO 33-90\",\r\n \"email\": \"alexander_obando@hotmail.com\",\r\n \"merchant_registration\": \"0000000-00\",\r\n \"type_document_identification_id\": 3,\r\n \"type_organization_id\": 2,\r\n \"type_liability_id\": 7,\r\n \"municipality_id\": 822,\r\n \"type_regime_id\": 1,\r\n \"tax_id\": 1\r\n },\r\n \"payment_form\": {\r\n \"payment_form_id\": 2,\r\n \"payment_method_id\": 30,\r\n \"payment_due_date\": \"2025-10-28\",\r\n \"duration_measure\": \"0\"\r\n },\r\n \"allowance_charges\": [{\r\n \"discount_id\": 1,\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"300000.00\",\r\n \"base_amount\": \"9000000.00\"\r\n }\r\n ],\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"7563025.210\",\r\n \"tax_exclusive_amount\": \"7563025.210\",\r\n \"tax_inclusive_amount\": \"9000000.00\",\r\n \"allowance_total_amount\": \"300000.00\",\r\n \"payable_amount\": \"8700000.00\"\r\n },\r\n \"tax_totals\": [\r\n\t\t{\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"1436974.790\",\r\n \"taxable_amount\": \"7563025.210\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"invoice_lines\": [\r\n\t\t{\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"840336.134\",\r\n \"free_of_charge_indicator\": false,\r\n \"tax_totals\": [{\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"159663.865\",\r\n \"taxable_amount\": \"840336.134\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"ARTICULO NRO 1\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n \"code\": \"ART1\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"1000000.00\",\r\n \"base_quantity\": \"1\"\r\n },\r\n\t\t{\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"1680672.269\",\r\n \"free_of_charge_indicator\": false,\r\n \"tax_totals\": [{\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"319327.731\",\r\n \"taxable_amount\": \"1680672.269\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"ARTICULO NRO 2\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n \"code\": \"ART2\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"2000000.00\",\r\n \"base_quantity\": \"1\"\r\n },\r\n\t\t{\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"2\",\r\n \"line_extension_amount\": \"5042016.806\",\r\n \"free_of_charge_indicator\": false,\r\n \"tax_totals\": [{\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"957983.194\",\r\n \"taxable_amount\": \"5042016.806\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"ARTICULO NRO 3\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n \"code\": \"ART3\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"3000000.00\",\r\n \"base_quantity\": \"1\"\r\n }\r\n ]\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "📄 FACTURA CON DESCUENTO GLOBAL - TRES LÍNEAS\n\n## 🔗 Descripción General\nEste ejemplo demuestra cómo enviar una factura electrónica con **tres líneas de productos** y un **descuento global aplicado al total** de la factura (no descuentos por línea). El descuento global permite aplicar un único porcentaje o monto fijo al valor total antes de calcular el IVA, ideal para descuentos de clientes VIP, cupones promocionales o descuentos generales por volumen de compra.\n\n## 📋 URL del Endpoint\n\n- **Modo Síncrono (respuesta inmediata):**\n```\nhttp://apidian2026-8.oo/api/ubl2.1/invoice\n```\n\n- **Modo Asíncrono (con set de pruebas de DIAN):**\n```\nhttp://apidian2026-8.oo/api/ubl2.1/invoice/{iddelsetdepruebasdeladian}\n```\n\n**Nota:** Si tiene un dominio configurado, reemplace `apidian2026-8.oo` con su dominio registrado.\n\n## 🔑 Característica Principal\n\nEsta factura implementa **descuento global a nivel de factura**, lo que permite:\n\n- Aplicar un único descuento al total de todas las líneas\n- Calcular el descuento proporcionalmente sobre el subtotal\n- Aplicar IVA sobre el valor después del descuento global\n- Simplificar la estructura cuando todas las líneas tienen el mismo tipo de descuento\n- Reflejar el descuento como un ítem independiente en la representación gráfica\n\n## 💰 Estructura del Descuento Global\n\n```json\n\"allowance_charges\": [{\n \"discount_id\": 1,\n \"charge_indicator\": false, // false = descuento, true = cargo\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\n \"amount\": \"300000.00\", // Monto del descuento\n \"base_amount\": \"9000000.00\" // Valor base antes del descuento\n}]\n```\n\n**Cálculo del Descuento:**\n- Valor base de todas las líneas: $9,000,000.00\n- Descuento aplicado: -$300,000.00 (3.33%)\n- Subtotal después del descuento: $8,700,000.00\n- IVA 19% sobre subtotal: $1,436,974.79\n- **Total a pagar:** **$8,700,000.00** (IVA incluido en este valor)\n\n## 📦 Estructura de las Tres Líneas\n\n### Línea 1: ARTICULO NRO 1\n```json\n{\n \"description\": \"ARTICULO NRO 1\",\n \"code\": \"ART1\",\n \"price_amount\": \"1000000.00\",\n \"invoiced_quantity\": \"1\",\n \"line_extension_amount\": \"840336.134\",\n \"tax_totals\": [{\n \"tax_id\": 1,\n \"tax_amount\": \"159663.865\",\n \"percent\": \"19.00\"\n }]\n}\n```\n- Precio unitario: $1,000,000.00\n- Cantidad: 1 unidad\n- **Subtotal línea:** $1,000,000.00\n\n### Línea 2: ARTICULO NRO 2\n```json\n{\n \"description\": \"ARTICULO NRO 2\",\n \"code\": \"ART2\",\n \"price_amount\": \"2000000.00\",\n \"invoiced_quantity\": \"1\",\n \"line_extension_amount\": \"1680672.269\",\n \"tax_totals\": [{\n \"tax_id\": 1,\n \"tax_amount\": \"319327.731\",\n \"percent\": \"19.00\"\n }]\n}\n```\n- Precio unitario: $2,000,000.00\n- Cantidad: 1 unidad\n- **Subtotal línea:** $2,000,000.00\n\n### Línea 3: ARTICULO NRO 3 (Cantidad: 2)\n```json\n{\n \"description\": \"ARTICULO NRO 3\",\n \"code\": \"ART3\",\n \"price_amount\": \"3000000.00\",\n \"invoiced_quantity\": \"2\",\n \"line_extension_amount\": \"5042016.806\",\n \"tax_totals\": [{\n \"tax_id\": 1,\n \"tax_amount\": \"957983.194\",\n \"percent\": \"19.00\"\n }]\n}\n```\n- Precio unitario: $3,000,000.00\n- Cantidad: 2 unidades\n- **Subtotal línea:** $6,000,000.00\n\n## 📊 Totales de la Factura 990000175\n\n| Concepto | Valor |\n|----------|-------|\n| **Línea 1** | $1,000,000.00 |\n| **Línea 2** | $2,000,000.00 |\n| **Línea 3** | $6,000,000.00 |\n| **Subtotal antes de descuento** | $9,000,000.00 |\n| **Descuento Global** | -$300,000.00 |\n| **Subtotal después de descuento** | $8,700,000.00 |\n| **Base gravable (ajustada)** | $7,563,025.21 |\n| **IVA Total (19%)** | $1,436,974.79 |\n| **Total a Pagar** | **$8,700,000.00** |\n\n## 🏢 Datos del Cliente\n\nEsta factura se emite a:\n\n```json\n\"customer\": {\n \"identification_number\": 41946692,\n \"dv\": 6,\n \"name\": \"ELIZABETH CARDONA VILLADA\",\n \"type_document_identification_id\": 3, // Cédula de Ciudadanía\n \"type_organization_id\": 2, // Persona Natural\n \"type_liability_id\": 7, // Responsabilidad fiscal\n \"municipality_id\": 822,\n \"type_regime_id\": 1, // Régimen Común\n \"tax_id\": 1 // IVA\n}\n```\n\n## 💳 Forma de Pago\n\nPago a crédito con tarjeta:\n\n```json\n\"payment_form\": {\n \"payment_form_id\": 2, // Crédito\n \"payment_method_id\": 30, // Tarjeta de Crédito\n \"payment_due_date\": \"2025-10-28\",\n \"duration_measure\": \"0\" // Pago inmediato (0 días)\n}\n```\n\n## 📝 Notas Personalizadas\n\nEsta factura incluye:\n\n### Notas Generales\n```json\n\"notes\": \"ESTA ES UNA NOTA DE PRUEBA...\"\n```\n\n### Nota de Encabezado\n```json\n\"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA...\"\n```\n\n### Nota de Pie de Página\n```json\n\"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA...\"\n```\n\n### Notas en Cada Línea\nCada línea incluye:\n```json\n\"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\"\n```\n\n## 🏢 Configuración del Establecimiento\n\n```json\n\"establishment_name\": \"TORRE SOFTWARE NRO 1\",\n\"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\n\"establishment_phone\": \"3226563672\",\n\"establishment_municipality\": 600,\n\"establishment_email\": \"alternate_email@alternate.com\"\n```\n\n## 🧮 Diferencia: Descuento Global vs Descuento en Línea\n\n| Aspecto | Descuento Global | Descuento en Línea |\n|---------|------------------|--------------------|\n| **Ubicación JSON** | `allowance_charges` (raíz) | `invoice_lines[].allowance_charges` |\n| **Alcance** | Aplica al total de la factura | Aplica solo a la línea específica |\n| **Flexibilidad** | Un solo % o monto para toda la factura | Diferentes % por producto |\n| **IVA** | Se calcula sobre total con descuento | Se calcula sobre valor con descuento por línea |\n| **Visualización** | Aparece al final, antes de impuestos | Aparece en detalle de cada línea |\n| **Uso típico** | Descuentos de clientes VIP, cupones | Promociones por producto, descuentos por volumen |\n| **Ejemplo Factura** | **990000175 (este ejemplo)** | 990000177, 990000178 |\n\n## 📌 Notas Importantes\n\n1. **Descuento Global:** El descuento se aplica usando el array `allowance_charges` **a nivel raíz** de la factura, no dentro de las líneas individuales.\n\n2. **Campo `charge_indicator`:** Debe ser `false` para descuentos. Si es `true`, representa un cargo adicional al total.\n\n3. **Base Amount:** El campo `base_amount: \"9000000.00\"` representa la suma de todas las líneas antes de aplicar el descuento.\n\n4. **Cálculo del IVA:** El IVA se calcula sobre el subtotal después de aplicar el descuento global, no sobre el valor original.\n\n5. **Allowance Total Amount:** A nivel de factura, `allowance_total_amount: \"300000.00\"` refleja el monto total del descuento global.\n\n6. **Tres Líneas sin Descuentos Individuales:** Esta factura incluye 3 productos sin descuentos en línea:\n - ARTICULO NRO 1 (1 unidad, $1M)\n - ARTICULO NRO 2 (1 unidad, $2M)\n - ARTICULO NRO 3 (2 unidades, $3M c/u = $6M)\n\n7. **Código de Actividad Económica:** El campo `actividadeconomica: \"6201\"` identifica la actividad económica CIIU del emisor.\n\n8. **Notas en Línea:** Cada línea incluye su propia nota que aparece en el detalle del producto en la representación gráfica.\n\n9. **Validación DIAN:** La suma de `line_extension_amount` de todas las líneas debe coincidir con el total antes del descuento.\n\n10. **Email Automático:** Con `sendmail: true`, la factura se envía automáticamente al cliente. `sendmailtome: false` omite la copia al emisor.\n\n11. **Head y Foot Note:** Estas notas aparecen en encabezado y pie de cada página de la representación gráfica.\n\n12. **Campo `disable_confirmation_text`:** Con `true`, se omite el texto de confirmación en la impresión para optimizar espacio en papel." }, "response": [] }, { "name": "Vista Preeliminar Factura", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"number\": 990000802,\r\n\t\"type_document_id\": 1,\r\n\t\"date\": \"2025-07-30\",\r\n\t\"time\": \"04:08:12\",\r\n\t\"resolution_number\": \"18760000001\",\r\n\t\"prefix\": \"SETP\",\r\n \"notes\": \"ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA\",\r\n \"disable_confirmation_text\": true,\r\n \"invoice_template\": \"3\",\r\n \"template_token\": \"$2y$10$mzkIm.5uVrwtigToAVY0.O/ENNJSOBjTXpCNUU/Jzaa2z2h/hRxpO\",\r\n \"establishment_name\": \"TORRE SOFTWARE NRO 1\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"establishment_email\": \"alternate_email@alternate.com\",\r\n\t\"sendmail\": false,\r\n \"sendmailtome\": false,\r\n \"seze\": \"2021-2017\",\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 41946692,\r\n\t\t\"dv\": 6,\r\n\t\t\"name\": \"ELIZABETH CARDONA VILLADA\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexander_obando@hotmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 3,\r\n\t\t\"type_organization_id\": 2,\r\n \"type_liability_id\": 7,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1,\r\n \"tax_id\": 15\r\n\t},\r\n\t\"payment_form\": [{\r\n\t\t\"payment_form_id\": 2,\r\n\t\t\"payment_method_id\": 30,\r\n\t\t\"payment_due_date\": \"2025-08-30\",\r\n\t\t\"duration_measure\": \"30\"\r\n\t}],\t\r\n\t\"allowance_charges\": [\r\n\t\t{\r\n\t\t\t\"discount_id\": 1,\r\n\t\t\t\"charge_indicator\": false,\r\n\t\t\t\"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n\t\t\t\"amount\": \"50000.00\",\r\n\t\t\t\"base_amount\": \"1000000.00\"\r\n\t\t}\r\n\t],\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\"tax_exclusive_amount\": \"840336.134\",\r\n\t\t\"tax_inclusive_amount\": \"1000000.00\",\r\n\t\t\"allowance_total_amount\": \"50000.00\",\r\n\t\t\"payable_amount\": \"950000.00\"\r\n\t},\r\n\t\"tax_totals\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\"percent\": \"19\",\r\n\t\t\t\"taxable_amount\": \"840336.134\"\r\n\t\t}\r\n\t],\r\n\t\"invoice_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\t\t\"taxable_amount\": \"840336.134\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"COMISION POR SERVICIOS\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"COMISION\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"1000000.00\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice/preeliminar-view", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice", "preeliminar-view" ] }, "description": "📄 VISTA PRELIMINAR DE FACTURA ELECTRÓNICA\n\n## 🔗 Descripción General\nEste endpoint permite generar una **vista previa** de la representación gráfica de una factura electrónica **sin enviarla a la DIAN**. Es ideal para validar el formato visual, revisar campos, detectar errores de estructura y confirmar que todos los datos se visualizan correctamente antes del envío oficial.\n\n## 📋 URL del Endpoint\n\n```\nhttp://apidian2026-8.oo/api/ubl2.1/invoice/preeliminar-view\n```\n\n**Nota:** Si tiene un dominio configurado, reemplace `apidian2026-8.oo` con su dominio registrado.\n\n## 🎯 Propósito de la Vista Preliminar\n\n- **Validación Visual:** Verificar la apariencia de la factura antes del envío a DIAN\n- **Detección de Errores:** Identificar campos faltantes o mal formateados\n- **Pruebas de Formato:** Evaluar diferentes plantillas de impresión sin afectar el set de pruebas\n- **Control de Calidad:** Asegurar que head_note, foot_note y logo se visualizan correctamente\n- **Sin Impacto DIAN:** No consume el set de pruebas ni registra en DIAN\n\n## 🔑 Campos Específicos de Vista Preliminar\n\nEsta solicitud implementa los siguientes campos únicos:\n\n| Campo | Tipo | Descripción | Ejemplo |\n|-------|------|-------------|----------|\n| `notes` | String | Notas generales de la factura (aparecen en el encabezado) | \"ESTA ES UNA NOTA DE PRUEBA...\" |\n| `head_note` | String | Texto libre en el **encabezado** de la representación gráfica | \"PRUEBA DE TEXTO LIBRE EN ENCABEZADO...\" |\n| `foot_note` | String | Texto libre en el **pie de página** de la representación gráfica | \"PRUEBA DE TEXTO LIBRE EN PIE DE PAGINA...\" |\n| `seze` | String | Identificador del periodo SEZE (Servicio de Envío de Zonas Especiales) | \"2021-2017\" |\n| `invoice_template` | String (\"1\"-\"4\") | Plantilla de visualización (1=Básica, 2=Logo, 3=Compacta, 4=Detallada) | \"3\" |\n| `template_token` | String (bcrypt) | Token de autenticación para la plantilla | \"$2y$10$mzkIm.5uVrwtig...\" |\n| `disable_confirmation_text` | Boolean | Deshabilita texto de confirmación en impresión | true |\n| `sendmail` | Boolean | Enviar email al cliente (en vista preliminar siempre es `false`) | false |\n| `sendmailtome` | Boolean | Enviar copia al emisor (en vista preliminar siempre es `false`) | false |\n\n## 📝 Notas Personalizadas\n\n### 1. **Notas Generales (`notes`)**\n```json\n\"notes\": \"ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA...\"\n```\n- **Ubicación:** Sección de información general de la factura\n- **Propósito:** Observaciones importantes sobre la transacción\n- **Límite:** Sin límite de caracteres, pero se recomienda máximo 500 para legibilidad\n\n### 2. **Nota de Encabezado (`head_note`)**\n```json\n\"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA...\"\n```\n- **Ubicación:** Parte superior de la representación gráfica\n- **Uso:** Mensajes institucionales, advertencias legales, promociones\n- **Formato:** Texto plano sin formato HTML\n\n### 3. **Nota de Pie de Página (`foot_note`)**\n```json\n\"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA...\"\n```\n- **Ubicación:** Parte inferior de cada página de la representación gráfica\n- **Uso:** Información de contacto, términos legales, datos del software\n- **Formato:** Texto plano sin formato HTML\n\n## 🏢 Datos del Establecimiento\n\nEsta solicitud sobrescribe la configuración por defecto:\n\n```json\n\"establishment_name\": \"TORRE SOFTWARE NRO 1\",\n\"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\n\"establishment_phone\": \"3226563672\",\n\"establishment_municipality\": 600,\n\"establishment_email\": \"alternate_email@alternate.com\"\n```\n\n**Beneficio:** Permite previsualizar facturas con datos de diferentes sucursales sin modificar la configuración principal.\n\n## 🎨 Plantillas de Visualización\n\n| Código | Nombre | Descripción | Mejor Para |\n|--------|--------|-------------|------------|\n| 1 | Básica | Formato simple sin decoraciones | Facturas rápidas, pruebas iniciales |\n| 2 | Logo Centrado | Logo empresarial en la parte superior | Imagen corporativa destacada |\n| 3 | Compacta | Información condensada (80mm) | **USADO EN ESTE EJEMPLO** - Terminales POS |\n| 4 | Detallada | Información completa con todos los campos | Facturas complejas, auditorías |\n\n## 🔐 Periodo SEZE\n\nEl campo `seze` identifica el periodo del Servicio de Envío de Zonas Especiales:\n\n```json\n\"seze\": \"2021-2017\"\n```\n\n- **Formato:** \"AñoInicio-AñoFin\"\n- **Propósito:** Registro para beneficios tributarios en zonas especiales de Colombia\n- **Validación:** Debe coincidir con los periodos registrados en DIAN\n- **Opcional:** Solo requerido para contribuyentes en zonas SEZE\n\n## 💳 Forma de Pago\n\nEsta solicitud incluye pago a crédito:\n\n```json\n\"payment_form\": [{\n \"payment_form_id\": 2, // Forma: 2=Crédito\n \"payment_method_id\": 30, // Método: 30=Tarjeta Crédito\n \"payment_due_date\": \"2025-08-30\",\n \"duration_measure\": \"30\" // Plazo: 30 días\n}]\n```\n\n## 📊 Estructura del Ejemplo\n\nEsta solicitud incluye una factura de ejemplo con los siguientes valores:\n\n- **Número:** 990000802\n- **Fecha:** 2025-07-30\n- **Valor base:** $1,000,000.00\n- **Descuento global:** $50,000.00 (5%)\n- **IVA (19%):** $159,663.87\n- **Valor total:** $950,000.00\n- **Líneas:** 1 producto con descripción \"COMISION POR SERVICIOS\"\n- **Notas de línea:** Incluye nota específica del detalle\n\n## 🖼️ Respuesta del Endpoint\n\nLa respuesta incluye:\n\n```json\n{\n \"success\": true,\n \"message\": \"Vista preliminar generada exitosamente\",\n \"data\": {\n \"preview_html\": \"...\", // HTML de la representación gráfica\n \"preview_pdf_base64\": \"JVBERi0xLj...\", // PDF en Base64 (opcional)\n \"invoice_data\": { ... }, // Datos procesados de la factura\n \"validation_warnings\": [ ... ] // Advertencias de validación\n }\n}\n```\n\n## 📌 Notas Importantes\n\n1. **Sin Envío a DIAN:** Este endpoint NO envía la factura a DIAN. Solo genera la vista previa de la representación gráfica.\n\n2. **No Consume Set de Pruebas:** La vista preliminar no afecta el contador de facturas del set de pruebas de DIAN.\n\n3. **Validación Completa:** Aunque no se envía a DIAN, el endpoint valida todos los campos según UBL 2.1 y normativa DIAN.\n\n4. **Head Note y Foot Note:** Estos campos son opcionales. Si se omiten o son `null`, no se muestra ningún texto en encabezado/pie.\n\n5. **Longitud de Notas:** Las notas muy largas pueden afectar el diseño de la representación gráfica. Se recomienda máximo 500 caracteres para `head_note` y `foot_note`.\n\n6. **Template Token:** El token debe ser válido y corresponder a la plantilla especificada en `invoice_template`.\n\n7. **Email Deshabilitado:** Los campos `sendmail` y `sendmailtome` deben ser `false` en vista preliminar. No se envían emails.\n\n8. **Datos del Cliente:** Incluya el campo `tax_id: 15` para impuestos especiales (en este ejemplo se usa el código 15).\n\n9. **Resolución de Facturación:** El campo `resolution_number` debe estar registrado en DIAN para que la validación sea exitosa.\n\n10. **Formato de Respuesta:** La respuesta incluye HTML y/o PDF Base64 de la representación gráfica para visualización inmediata.\n\n11. **Uso Recomendado:** Utilice este endpoint para pruebas de formato, capacitación de usuarios y validación de datos antes del envío oficial a DIAN.\n\n12. **Diferencia con Endpoint Normal:** El endpoint normal `.../ubl2.1/invoice` sí envía a DIAN y consume el set de pruebas. Use `.../preeliminar-view` solo para previsualización." }, "response": [] }, { "name": "Una Linea, IVA e Impuesto al Consumo En La Misma Linea", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": 990000255,\r\n \"type_document_id\": 1,\r\n \"date\": \"2025-11-27\",\r\n \"time\": \"07:26:25\",\r\n \"resolution_number\": \"18760000001\",\r\n \"prefix\": \"SETP\",\r\n \"disable_confirmation_text\": true,\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"CLL 11 NRO 21-73\",\r\n \"establishment_phone\": \"3103891693\",\r\n \"establishment_municipality\": 822,\r\n \"establishment_email\": \"alexanderobandolondono@gmail.com\",\r\n \"sendmail\": true,\r\n \"sendmailtome\": false,\r\n \"send_customer_credentials\": false,\r\n \"head_note\": null,\r\n \"foot_note\": \"Sistema POS ManagerERP QUALITY COLOMBIA S.A NIT 900.174.087-1 - Documento Generado con Software Propio Nit: 901788781\",\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 41946692,\r\n\t\t\"dv\": 6,\r\n\t\t\"name\": \"ELIZABETH CARDONA VILLADA\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexander_obando@hotmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 3,\r\n\t\t\"type_organization_id\": 2,\r\n \"type_liability_id\": 7,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1,\r\n \"tax_id\": 1\r\n\t},\r\n \"payment_form\": {\r\n \"payment_form_id\": 1,\r\n \"payment_method_id\": 10,\r\n \"payment_due_date\": \"2025-11-27\",\r\n \"duration_measure\": \"0\"\r\n },\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"3128.74\",\r\n \"tax_exclusive_amount\": \"3128.74\",\r\n \"tax_inclusive_amount\": \"12200.00\",\r\n \"payable_amount\": \"12200.00\"\r\n },\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"594.46\",\r\n \"percent\": \"19\",\r\n \"taxable_amount\": \"3128.74\"\r\n },\r\n {\r\n \"tax_id\": 2,\r\n \"unit_measure_id\": \"70\",\r\n \"tax_amount\": \"8476.80\",\r\n \"percent\": \"0\",\r\n \"taxable_amount\": \"8476.80\"\r\n }\r\n ],\r\n \"invoice_lines\": [\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"2.00\",\r\n \"line_extension_amount\": \"3128.74\",\r\n \"free_of_charge_indicator\": false,\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"594.46\",\r\n \"percent\": \"19\",\r\n \"taxable_amount\": \"3128.74\"\r\n },\r\n {\r\n \"tax_id\": 2,\r\n \"unit_measure_id\": \"70\",\r\n \"tax_amount\": \"8476.80\",\r\n \"percent\": \"0\",\r\n \"taxable_amount\": \"0\",\r\n \"per_unit_amount\": \"4238.40\",\r\n \"base_unit_measure\": \"2.00\"\r\n }\r\n ],\r\n \"description\": \"LYM ROJO 20\",\r\n \"code\": \"601438\",\r\n \"type_item_identification_id\": \"4\",\r\n \"price_amount\": \"6100.00\",\r\n \"base_quantity\": \"2\"\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "📄 FACTURA CON IVA E IMPUESTO AL CONSUMO EN LA MISMA LÍNEA\n\n## 🔗 Descripción General\nEste ejemplo demuestra cómo enviar una factura electrónica que incluye **dos impuestos diferentes aplicados a la misma línea de producto**: IVA (Impuesto al Valor Agregado) e Impuesto al Consumo. Esta configuración es común en productos como cigarrillos, licores, bolsas plásticas y otros artículos gravados con impuestos especiales además del IVA.\n\n## 📋 URL del Endpoint\n\n- **Modo Síncrono (respuesta inmediata):**\n```\nhttp://apidian2026-8.oo/api/ubl2.1/invoice\n```\n\n- **Modo Asíncrono (con set de pruebas de DIAN):**\n```\nhttp://apidian2026-8.oo/api/ubl2.1/invoice/{iddelsetdepruebasdeladian}\n```\n\n**Nota:** Si tiene un dominio configurado, reemplace `apidian2026-8.oo` con su dominio registrado.\n\n## 🔑 Característica Principal\n\nEsta factura implementa **múltiples impuestos en una misma línea**, lo que permite:\n\n- Aplicar IVA (tax_id: 1) sobre el valor base del producto\n- Aplicar Impuesto al Consumo (tax_id: 2) sobre la misma línea\n- Calcular correctamente los totales con ambos impuestos\n- Cumplir con la normativa DIAN para productos con doble tributación\n\n## 💰 Estructura de Impuestos\n\n### Impuestos a Nivel de Factura (`tax_totals`)\n\n```json\n\"tax_totals\": [\n {\n \"tax_id\": 1, // IVA\n \"tax_amount\": \"594.46\",\n \"percent\": \"19\",\n \"taxable_amount\": \"3128.74\"\n },\n {\n \"tax_id\": 2, // Impuesto al Consumo\n \"unit_measure_id\": \"70\",\n \"tax_amount\": \"8476.80\",\n \"percent\": \"0\",\n \"taxable_amount\": \"8476.80\"\n }\n]\n```\n\n### Impuestos a Nivel de Línea (`invoice_lines[].tax_totals`)\n\n```json\n\"tax_totals\": [\n {\n \"tax_id\": 1, // IVA del 19%\n \"tax_amount\": \"594.46\",\n \"percent\": \"19\",\n \"taxable_amount\": \"3128.74\"\n },\n {\n \"tax_id\": 2, // Impuesto al Consumo\n \"unit_measure_id\": \"70\",\n \"tax_amount\": \"8476.80\",\n \"percent\": \"0\", // 0% indica monto fijo por unidad\n \"taxable_amount\": \"0\",\n \"per_unit_amount\": \"4238.40\", // Monto fijo por unidad\n \"base_unit_measure\": \"2.00\" // Cantidad de unidades\n }\n]\n```\n\n## 📊 Tipos de Impuestos\n\n| tax_id | Nombre | Descripción | Aplicación |\n|--------|--------|-------------|------------|\n| 1 | IVA | Impuesto al Valor Agregado | Porcentaje sobre base gravable (19% en este ejemplo) |\n| 2 | Impuesto al Consumo | Tributo especial | Monto fijo por unidad o porcentaje |\n| 3 | ICA | Impuesto de Industria y Comercio | Porcentaje sobre ingresos |\n| 4 | INC | Impuesto Nacional al Consumo | Porcentaje sobre valor |\n\n## 🧮 Cálculo del Ejemplo\n\nEsta factura (990000176) incluye:\n\n### Valores Base\n- **Precio unitario:** $6,100.00\n- **Cantidad:** 2 unidades\n- **Producto:** \"LYM ROJO 20\" (código: 601438)\n\n### Cálculo de IVA\n1. **Base gravable:** $3,128.74\n2. **IVA (19%):** $3,128.74 × 0.19 = **$594.46**\n\n### Cálculo de Impuesto al Consumo\n1. **Monto por unidad:** $4,238.40\n2. **Cantidad:** 2 unidades\n3. **Total impuesto:** $4,238.40 × 2 = **$8,476.80**\n\n### Totales de la Factura\n- **Valor sin impuestos:** $3,128.74\n- **IVA:** $594.46\n- **Impuesto al Consumo:** $8,476.80\n- **Valor total:** **$12,200.00**\n\n## 🏢 Configuración del Establecimiento\n\nEsta solicitud incluye datos específicos del establecimiento:\n\n```json\n\"establishment_name\": \"TORRE SOFTWARE\",\n\"establishment_address\": \"CLL 11 NRO 21-73\",\n\"establishment_phone\": \"3103891693\",\n\"establishment_municipality\": 822,\n\"establishment_email\": \"alexanderobandolondono@gmail.com\"\n```\n\n## 💳 Forma de Pago\n\nPago de contado en efectivo:\n\n```json\n\"payment_form\": {\n \"payment_form_id\": 1, // Contado\n \"payment_method_id\": 10, // Efectivo\n \"payment_due_date\": \"2025-10-28\",\n \"duration_measure\": \"0\" // Inmediato\n}\n```\n\n## 📝 Nota de Pie de Página\n\nEsta factura incluye información del sistema POS en el pie de página:\n\n```json\n\"foot_note\": \"Sistema POS ManagerERP QUALITY COLOMBIA S.A NIT 900.174.087-1 - Documento Generado con Software Propio Nit: 901788781\"\n```\n\n## 🎯 Campos Clave para Impuesto al Consumo\n\n| Campo | Descripción | Valor en Ejemplo |\n|-------|-------------|------------------|\n| `per_unit_amount` | Monto fijo del impuesto por unidad | \"4238.40\" |\n| `base_unit_measure` | Cantidad de unidades gravadas | \"2.00\" |\n| `unit_measure_id` | Unidad de medida (70 = Unidad) | \"70\" |\n| `percent` | Porcentaje (0 indica monto fijo) | \"0\" |\n| `taxable_amount` | Base gravable (0 para monto fijo) | \"0\" |\n\n## 📌 Notas Importantes\n\n1. **Doble Tributación:** Este ejemplo muestra cómo aplicar IVA e Impuesto al Consumo simultáneamente en la misma línea de producto.\n\n2. **Monto Fijo vs Porcentaje:** El Impuesto al Consumo puede aplicarse como:\n - **Monto fijo por unidad:** Usar `per_unit_amount` con `percent: \"0\"`\n - **Porcentaje:** Usar `percent` con el valor del porcentaje y `taxable_amount`\n\n3. **Campo `per_unit_amount`:** Este campo es **obligatorio** cuando el Impuesto al Consumo es un monto fijo por unidad. Debe multiplicarse por la cantidad para obtener el total.\n\n4. **Campo `base_unit_measure`:** Indica la cantidad de unidades sobre las cuales se aplica el impuesto fijo.\n\n5. **Validación DIAN:** La suma de `tax_totals` a nivel de línea debe coincidir con los `tax_totals` a nivel de factura para cada tipo de impuesto.\n\n6. **Productos Típicos:** Esta configuración se usa para:\n - Bebidas alcohólicas\n - Cigarrillos y tabaco\n - Bolsas plásticas\n - Combustibles\n - Productos con gravámenes especiales\n\n7. **IVA sobre Base Gravable:** El IVA se calcula sobre la base gravable ($3,128.74), no sobre el precio total que incluye el impuesto al consumo.\n\n8. **Totales Monetarios:** El `payable_amount` ($12,200.00) incluye:\n - Valor base: $3,128.74\n - IVA: $594.46\n - Impuesto al Consumo: $8,476.80\n\n9. **Código de Producto:** El `type_item_identification_id: \"4\"` indica código estándar del vendedor.\n\n10. **Email y Notificaciones:** Con `sendmail: true`, la factura se envía automáticamente al email del cliente.\n\n11. **Foot Note:** El texto de pie de página identifica el software POS generador del documento.\n\n12. **Resolución DIAN:** El `resolution_number: \"18760000001\"` debe estar activo y registrado en DIAN para que la factura sea válida." }, "response": [] }, { "name": "Una Linea, Impuesto Nacional al Consumo", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": 990000256,\r\n \"type_document_id\": 1,\r\n \"date\": \"2025-11-27\",\r\n \"time\": \"07:26:25\",\r\n \"resolution_number\": \"18760000001\",\r\n \"prefix\": \"SETP\",\r\n \"disable_confirmation_text\": true,\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"CLL 11 NRO 21-73\",\r\n \"establishment_phone\": \"3103891693\",\r\n \"establishment_municipality\": 822,\r\n \"establishment_email\": \"alexanderobandolondono@gmail.com\",\r\n \"sendmail\": true,\r\n \"sendmailtome\": false,\r\n \"send_customer_credentials\": false,\r\n \"head_note\": null,\r\n \"foot_note\": \"\",\r\n \"customer\": {\r\n \"identification_number\": 41946692,\r\n \"dv\": 6,\r\n \"name\": \"ELIZABETH CARDONA VILLADA\",\r\n \"phone\": \"3103891693\",\r\n \"address\": \"CLL 4 NRO 33-90\",\r\n \"email\": \"alexander_obando@hotmail.com\",\r\n \"merchant_registration\": \"0000000-00\",\r\n \"type_document_identification_id\": 3,\r\n \"type_organization_id\": 2,\r\n \"type_liability_id\": 7,\r\n \"municipality_id\": 822,\r\n \"type_regime_id\": 1,\r\n \"tax_id\": 1\r\n },\r\n \"payment_form\": {\r\n \"payment_form_id\": 1,\r\n \"payment_method_id\": 10,\r\n \"payment_due_date\": \"2025-11-27\",\r\n \"duration_measure\": \"0\"\r\n },\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"11296.296296296\",\r\n \"tax_exclusive_amount\": \"11296.296296296\",\r\n \"tax_inclusive_amount\": \"12200.00\",\r\n \"payable_amount\": \"12200.00\"\r\n },\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 4,\r\n \"tax_amount\": \"903.703703703\",\r\n \"percent\": \"8\",\r\n \"taxable_amount\": \"11296.296296\"\r\n }\r\n ],\r\n \"invoice_lines\": [\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"2.00\",\r\n \"line_extension_amount\": \"11296.296296296\",\r\n \"free_of_charge_indicator\": false,\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 4,\r\n \"tax_amount\": \"903.703703703\",\r\n \"percent\": \"8\",\r\n \"taxable_amount\": \"11296.296296\"\r\n }\r\n ],\r\n \"description\": \"LYM ROJO 20\",\r\n \"code\": \"601438\",\r\n \"type_item_identification_id\": \"4\",\r\n \"price_amount\": \"6100.00\",\r\n \"base_quantity\": \"2\"\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "📄 FACTURA CON IMPUESTO NACIONAL AL CONSUMO (INC)\n\n## 🔗 Descripción General\nEste ejemplo demuestra cómo enviar una factura electrónica que incluye **dos impuestos diferentes aplicados a la misma línea de producto**: IVA (Impuesto al Valor Agregado) e Impuesto al Consumo. Esta configuración es común en productos como cigarrillos, licores, bolsas plásticas y otros artículos gravados con impuestos especiales además del IVA.\n\n## 📋 URL del Endpoint\n\n- **Modo Síncrono (respuesta inmediata):**\n```\nhttp://apidian2026-8.oo/api/ubl2.1/invoice\n```\n\n- **Modo Asíncrono (con set de pruebas de DIAN):**\n```\nhttp://apidian2026-8.oo/api/ubl2.1/invoice/{iddelsetdepruebasdeladian}\n```\n\n**Nota:** Si tiene un dominio configurado, reemplace `apidian2026-8.oo` con su dominio registrado.\n\n## 🔑 Característica Principal\n\nEsta factura implementa **múltiples impuestos en una misma línea**, lo que permite:\n\n- Aplicar IVA (tax_id: 1) sobre el valor base del producto\n- Aplicar Impuesto al Consumo (tax_id: 2) sobre la misma línea\n- Calcular correctamente los totales con ambos impuestos\n- Cumplir con la normativa DIAN para productos con doble tributación\n\n## 💰 Estructura de Impuestos\n\n### Impuestos a Nivel de Factura (`tax_totals`)\n\n```json\n\"tax_totals\": [\n {\n \"tax_id\": 1, // IVA\n \"tax_amount\": \"594.46\",\n \"percent\": \"19\",\n \"taxable_amount\": \"3128.74\"\n },\n {\n \"tax_id\": 2, // Impuesto al Consumo\n \"unit_measure_id\": \"70\",\n \"tax_amount\": \"8476.80\",\n \"percent\": \"0\",\n \"taxable_amount\": \"8476.80\"\n }\n]\n```\n\n### Impuestos a Nivel de Línea (`invoice_lines[].tax_totals`)\n\n```json\n\"tax_totals\": [\n {\n \"tax_id\": 1, // IVA del 19%\n \"tax_amount\": \"594.46\",\n \"percent\": \"19\",\n \"taxable_amount\": \"3128.74\"\n },\n {\n \"tax_id\": 2, // Impuesto al Consumo\n \"unit_measure_id\": \"70\",\n \"tax_amount\": \"8476.80\",\n \"percent\": \"0\", // 0% indica monto fijo por unidad\n \"taxable_amount\": \"0\",\n \"per_unit_amount\": \"4238.40\", // Monto fijo por unidad\n \"base_unit_measure\": \"2.00\" // Cantidad de unidades\n }\n]\n```\n\n## 📊 Tipos de Impuestos\n\n| tax_id | Nombre | Descripción | Aplicación |\n|--------|--------|-------------|------------|\n| 1 | IVA | Impuesto al Valor Agregado | Porcentaje sobre base gravable (19% en este ejemplo) |\n| 2 | Impuesto al Consumo | Tributo especial | Monto fijo por unidad o porcentaje |\n| 3 | ICA | Impuesto de Industria y Comercio | Porcentaje sobre ingresos |\n| 4 | INC | Impuesto Nacional al Consumo | Porcentaje sobre valor |\n\n## 🧮 Cálculo del Ejemplo\n\nEsta factura (990000176) incluye:\n\n### Valores Base\n- **Precio unitario:** $6,100.00\n- **Cantidad:** 2 unidades\n- **Producto:** \"LYM ROJO 20\" (código: 601438)\n\n### Cálculo de IVA\n1. **Base gravable:** $3,128.74\n2. **IVA (19%):** $3,128.74 × 0.19 = **$594.46**\n\n### Cálculo de Impuesto al Consumo\n1. **Monto por unidad:** $4,238.40\n2. **Cantidad:** 2 unidades\n3. **Total impuesto:** $4,238.40 × 2 = **$8,476.80**\n\n### Totales de la Factura\n- **Valor sin impuestos:** $3,128.74\n- **IVA:** $594.46\n- **Impuesto al Consumo:** $8,476.80\n- **Valor total:** **$12,200.00**\n\n## 🏢 Configuración del Establecimiento\n\nEsta solicitud incluye datos específicos del establecimiento:\n\n```json\n\"establishment_name\": \"TORRE SOFTWARE\",\n\"establishment_address\": \"CLL 11 NRO 21-73\",\n\"establishment_phone\": \"3103891693\",\n\"establishment_municipality\": 822,\n\"establishment_email\": \"alexanderobandolondono@gmail.com\"\n```\n\n## 💳 Forma de Pago\n\nPago de contado en efectivo:\n\n```json\n\"payment_form\": {\n \"payment_form_id\": 1, // Contado\n \"payment_method_id\": 10, // Efectivo\n \"payment_due_date\": \"2025-10-28\",\n \"duration_measure\": \"0\" // Inmediato\n}\n```\n\n## 📝 Nota de Pie de Página\n\nEsta factura incluye información del sistema POS en el pie de página:\n\n```json\n\"foot_note\": \"Sistema POS ManagerERP QUALITY COLOMBIA S.A NIT 900.174.087-1 - Documento Generado con Software Propio Nit: 901788781\"\n```\n\n## 🎯 Campos Clave para Impuesto al Consumo\n\n| Campo | Descripción | Valor en Ejemplo |\n|-------|-------------|------------------|\n| `per_unit_amount` | Monto fijo del impuesto por unidad | \"4238.40\" |\n| `base_unit_measure` | Cantidad de unidades gravadas | \"2.00\" |\n| `unit_measure_id` | Unidad de medida (70 = Unidad) | \"70\" |\n| `percent` | Porcentaje (0 indica monto fijo) | \"0\" |\n| `taxable_amount` | Base gravable (0 para monto fijo) | \"0\" |\n\n## 📌 Notas Importantes\n\n1. **Doble Tributación:** Este ejemplo muestra cómo aplicar IVA e Impuesto al Consumo simultáneamente en la misma línea de producto.\n\n2. **Monto Fijo vs Porcentaje:** El Impuesto al Consumo puede aplicarse como:\n - **Monto fijo por unidad:** Usar `per_unit_amount` con `percent: \"0\"`\n - **Porcentaje:** Usar `percent` con el valor del porcentaje y `taxable_amount`\n\n3. **Campo `per_unit_amount`:** Este campo es **obligatorio** cuando el Impuesto al Consumo es un monto fijo por unidad. Debe multiplicarse por la cantidad para obtener el total.\n\n4. **Campo `base_unit_measure`:** Indica la cantidad de unidades sobre las cuales se aplica el impuesto fijo.\n\n5. **Validación DIAN:** La suma de `tax_totals` a nivel de línea debe coincidir con los `tax_totals` a nivel de factura para cada tipo de impuesto.\n\n6. **Productos Típicos:** Esta configuración se usa para:\n - Bebidas alcohólicas\n - Cigarrillos y tabaco\n - Bolsas plásticas\n - Combustibles\n - Productos con gravámenes especiales\n\n7. **IVA sobre Base Gravable:** El IVA se calcula sobre la base gravable ($3,128.74), no sobre el precio total que incluye el impuesto al consumo.\n\n8. **Totales Monetarios:** El `payable_amount` ($12,200.00) incluye:\n - Valor base: $3,128.74\n - IVA: $594.46\n - Impuesto al Consumo: $8,476.80\n\n9. **Código de Producto:** El `type_item_identification_id: \"4\"` indica código estándar del vendedor.\n\n10. **Email y Notificaciones:** Con `sendmail: true`, la factura se envía automáticamente al email del cliente.\n\n11. **Foot Note:** El texto de pie de página identifica el software POS generador del documento.\n\n12. **Resolución DIAN:** El `resolution_number: \"18760000001\"` debe estar activo y registrado en DIAN para que la factura sea válida." }, "response": [] }, { "name": "Una Linea, Descuento en Linea, Una Tarifa de IVA Copy", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"number\": 990000177,\r\n\t\"type_document_id\": 1,\r\n\t\"date\": \"2025-10-28\",\r\n\t\"time\": \"04:08:12\",\r\n\t\"resolution_number\": \"18760000001\",\r\n\t\"prefix\": \"SETP\",\r\n \"notes\": \"ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA\",\r\n \"disable_confirmation_text\": true,\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"establishment_email\": \"alternate_email@alternate.com\",\r\n\t\"sendmail\": true,\r\n \"sendmailtome\": true,\r\n \"seze\": \"2021-2017\",\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 900166483,\r\n\t\t\"dv\": 1,\r\n\t\t\"name\": \"INVERSIONES DAVAL SAS\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexander_obando@hotmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 6,\r\n\t\t\"type_organization_id\": 1,\r\n \"type_liability_id\": 7,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1\r\n\t},\r\n\t\"payment_form\": {\r\n\t\t\"payment_form_id\": 2,\r\n\t\t\"payment_method_id\": 30,\r\n\t\t\"payment_due_date\": \"2025-11-28\",\r\n\t\t\"duration_measure\": \"30\"\r\n\t},\t\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"769500.00\",\r\n\t\t\"tax_exclusive_amount\": \"950000.00\",\r\n\t\t\"tax_inclusive_amount\": \"950000.00\",\r\n \"allowance_total_amount\": \"0.00\",\r\n\t\t\"payable_amount\": \"950000.00\"\r\n\t},\r\n\t\"tax_totals\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"180500\",\r\n\t\t\t\"percent\": \"19\",\r\n\t\t\t\"taxable_amount\": \"950000.00\"\r\n\t\t}\r\n\t],\r\n\t\"invoice_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"769500.00\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"allowance_charges\": [{\r\n\t\t\t\t\t\"charge_indicator\": false,\r\n\t\t\t\t\t\"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n\t\t\t\t\t\"amount\": \"50000.00\",\r\n\t\t\t\t\t\"base_amount\": \"1000000.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"180500\",\r\n\t\t\t\t\t\"taxable_amount\": \"950000\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"COMISION POR SERVICIOS\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"COMISION\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"1000000.00\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "📄 FACTURA CON DESCUENTO EN LÍNEA - UNA LÍNEA\n\n## 🔗 Descripción General\nEste ejemplo demuestra cómo enviar una factura electrónica con **una línea de producto** que tiene un **descuento aplicado a nivel de línea** (no descuento global). El descuento en línea permite aplicar un porcentaje o monto específico directamente al producto, ideal para promociones individuales, descuentos por cliente o precios especiales.\n\n## 📋 URL del Endpoint\n\n- **Modo Síncrono (respuesta inmediata):**\n```\nhttp://apidian2026-8.oo/api/ubl2.1/invoice\n```\n\n- **Modo Asíncrono (con set de pruebas de DIAN):**\n```\nhttp://apidian2026-8.oo/api/ubl2.1/invoice/{iddelsetdepruebasdeladian}\n```\n\n**Nota:** Si tiene un dominio configurado, reemplace `apidian2026-8.oo` con su dominio registrado.\n\n## 🔑 Característica Principal\n\nEsta factura implementa **descuento a nivel de línea**, lo que permite:\n\n- Aplicar descuento específico al producto\n- Calcular base gravable después del descuento\n- Aplicar IVA sobre el valor con descuento\n- Reflejar el descuento en el detalle de la línea\n- Estructura simple sin descuentos globales\n\n## 💰 Estructura del Descuento en Línea\n\n```json\n\"allowance_charges\": [{\n \"charge_indicator\": false, // false = descuento, true = cargo\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\n \"amount\": \"50000.00\", // Monto del descuento\n \"base_amount\": \"1000000.00\" // Precio base antes del descuento\n}]\n```\n\n**Cálculo del Descuento:**\n- Precio base: $1,000,000.00\n- Descuento aplicado: -$50,000.00 (5%)\n- Subtotal después del descuento: $950,000.00\n- Base gravable (ajustada): $769,500.00\n- IVA 19% sobre base gravable: $180,500.00\n- **Total a pagar:** **$950,000.00**\n\n## 📦 Estructura de la Línea\n\n```json\n{\n \"description\": \"COMISION POR SERVICIOS\",\n \"code\": \"COMISION\",\n \"price_amount\": \"1000000.00\", // Precio original\n \"invoiced_quantity\": \"1\",\n \"line_extension_amount\": \"769500.00\", // Después de descuento y ajustes\n \"allowance_charges\": [{ // Descuento en esta línea\n \"amount\": \"50000.00\",\n \"base_amount\": \"1000000.00\"\n }],\n \"tax_totals\": [{\n \"tax_id\": 1,\n \"tax_amount\": \"180500\",\n \"taxable_amount\": \"950000\",\n \"percent\": \"19.00\" // IVA 19%\n }],\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\"\n}\n```\n\n## 📊 Totales de la Factura 990000177\n\n| Concepto | Valor |\n|----------|-------|\n| **Precio original** | $1,000,000.00 |\n| **Descuento en línea** | -$50,000.00 |\n| **Subtotal con descuento** | $950,000.00 |\n| **Base gravable (line_extension_amount)** | $769,500.00 |\n| **IVA 19%** | $180,500.00 |\n| **Total a Pagar** | **$950,000.00** |\n\n## 🏢 Datos del Cliente\n\nEsta factura se emite a:\n\n```json\n\"customer\": {\n \"identification_number\": 900166483,\n \"dv\": 1,\n \"name\": \"INVERSIONES DAVAL SAS\",\n \"type_document_identification_id\": 6, // NIT\n \"type_organization_id\": 1, // Persona Jurídica\n \"type_liability_id\": 7, // Responsabilidad fiscal\n \"municipality_id\": 822,\n \"type_regime_id\": 1 // Régimen Común\n}\n```\n\n## 💳 Forma de Pago\n\nPago a crédito con tarjeta:\n\n```json\n\"payment_form\": {\n \"payment_form_id\": 2, // Crédito\n \"payment_method_id\": 30, // Tarjeta de Crédito\n \"payment_due_date\": \"2025-11-28\",\n \"duration_measure\": \"30\" // 30 días plazo\n}\n```\n\n## 📝 Notas Personalizadas\n\nEsta factura incluye:\n\n### Notas Generales\n```json\n\"notes\": \"ESTA ES UNA NOTA DE PRUEBA...\"\n```\n\n### Nota de Encabezado\n```json\n\"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA...\"\n```\n\n### Nota de Pie de Página\n```json\n\"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA...\"\n```\n\n### Nota en la Línea\n```json\n\"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\"\n```\n\n## 🔐 Periodo SEZE\n\n```json\n\"seze\": \"2021-2017\"\n```\n\nIdentifica el periodo del Servicio de Envío de Zonas Especiales para beneficios tributarios.\n\n## 🏢 Configuración del Establecimiento\n\n```json\n\"establishment_name\": \"TORRE SOFTWARE\",\n\"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\n\"establishment_phone\": \"3226563672\",\n\"establishment_municipality\": 600,\n\"establishment_email\": \"alternate_email@alternate.com\"\n```\n\n## 🧮 Diferencia: Descuento en Línea vs Descuento Global\n\n| Aspecto | Descuento en Línea | Descuento Global |\n|---------|-------------------|------------------|\n| **Ubicación JSON** | `invoice_lines[].allowance_charges` | `allowance_charges` (raíz) |\n| **Alcance** | Aplica solo a la línea específica | Aplica al total de la factura |\n| **Flexibilidad** | Descuento individual por producto | Un solo % o monto para toda la factura |\n| **IVA** | Se calcula sobre valor con descuento | Se calcula sobre total con descuento |\n| **Visualización** | Aparece en detalle de la línea | Aparece al final, antes de impuestos |\n| **Uso típico** | Promociones por producto, descuentos por volumen | Descuentos de clientes VIP, cupones |\n| **Ejemplo Factura** | **990000177 (este ejemplo)** | 990000175 |\n\n## 📌 Notas Importantes\n\n1. **Descuento en Línea:** El descuento se aplica usando el array `allowance_charges` **dentro de la línea** (`invoice_lines[].allowance_charges`), no a nivel de factura.\n\n2. **Campo `charge_indicator`:** Debe ser `false` para descuentos. Si es `true`, representa un cargo adicional a la línea.\n\n3. **Base Amount:** El campo `base_amount: \"1000000.00\"` representa el valor base del producto antes de aplicar el descuento.\n\n4. **Cálculo del IVA:** El IVA se calcula sobre el `taxable_amount` ($950,000), que es el valor después del descuento.\n\n5. **Line Extension Amount:** El campo `line_extension_amount: \"769500.00\"` es el valor ajustado que se usa para cálculos finales.\n\n6. **Allowance Total:** A nivel de factura, `allowance_total_amount: \"0.00\"` porque no hay descuento global, solo en línea.\n\n7. **Una Línea Simple:** Esta factura incluye un solo producto:\n - COMISION POR SERVICIOS (1 unidad)\n - Precio: $1,000,000.00\n - Descuento: $50,000.00 (5%)\n\n8. **Código de Producto:** El código \"COMISION\" con `type_item_identification_id: 4` (código estándar del vendedor).\n\n9. **Nota en Línea:** La línea incluye su propia nota que aparece en el detalle del producto en la representación gráfica.\n\n10. **Validación DIAN:** El `line_extension_amount` debe reflejar el valor después de aplicar todos los descuentos y ajustes.\n\n11. **Email Automático:** Con `sendmail: true` y `sendmailtome: true`, la factura se envía al cliente y al emisor.\n\n12. **Head y Foot Note:** Estas notas aparecen en encabezado y pie de cada página de la representación gráfica, útiles para información corporativa o legal." }, "response": [] }, { "name": "Tres Lineas, Descuento en Linea, Una Tarifa de IVA", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": 990000178,\r\n \"type_document_id\": 1,\r\n \"date\": \"2025-10-28\",\r\n \"time\": \"04:08:12\",\r\n \"resolution_number\": \"18760000001\",\r\n \"prefix\": \"SETP\",\r\n \"notes\": \"ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA\",\r\n \"disable_confirmation_text\": true,\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"establishment_email\": \"alternate_email@alternate.com\",\r\n \"sendmail\": true,\r\n \"sendmailtome\": true,\r\n \"seze\": \"2021-2017\",\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"customer\": {\r\n \"identification_number\": 900166483,\r\n \"dv\": 1,\r\n \"name\": \"INVERSIONES DAVAL SAS\",\r\n \"phone\": \"3103891693\",\r\n \"address\": \"CLL 4 NRO 33-90\",\r\n \"email\": \"alexander_obando@hotmail.com\",\r\n \"merchant_registration\": \"0000000-00\",\r\n \"type_document_identification_id\": 6,\r\n \"type_organization_id\": 1,\r\n \"type_liability_id\": 7,\r\n \"municipality_id\": 822,\r\n \"type_regime_id\": 1\r\n },\r\n \"payment_form\": {\r\n \"payment_form_id\": 2,\r\n \"payment_method_id\": 30,\r\n \"payment_due_date\": \"2025-11-28\",\r\n \"duration_measure\": \"30\"\r\n },\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"7310924.175\",\r\n \"tax_exclusive_amount\": \"7310924.175\",\r\n \"tax_inclusive_amount\": \"8700000.00\",\r\n \"allowance_total_amount\": \"0.00\",\r\n \"payable_amount\": \"8700000.00\"\r\n },\r\n \"tax_totals\":\r\n [{\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"1389075.630\",\r\n \"percent\": \"19\",\r\n \"taxable_amount\": \"7310924.175\"\r\n }\r\n ],\r\n \"invoice_lines\": [\r\n\t\t{\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"798319.327\",\r\n \"free_of_charge_indicator\": false,\r\n\t\t\t\"allowance_charges\": [{\r\n\t\t\t\t\t\"charge_indicator\": false,\r\n\t\t\t\t\t\"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n\t\t\t\t\t\"amount\": \"50000.00\",\r\n\t\t\t\t\t\"base_amount\": \"1000000.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n \"tax_totals\": [{\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"151680.673\",\r\n \"taxable_amount\": \"798319.327\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"ARTICULO NRO 1\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n \"code\": \"ART1\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"1000000.00\",\r\n \"base_quantity\": \"1\"\r\n },\r\n\t\t{\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"1554621.848\",\r\n \"free_of_charge_indicator\": false,\r\n\t\t\t\"allowance_charges\": [{\r\n\t\t\t\t\t\"charge_indicator\": false,\r\n\t\t\t\t\t\"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n\t\t\t\t\t\"amount\": \"150000.00\",\r\n\t\t\t\t\t\"base_amount\": \"2000000.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n \"tax_totals\": [{\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"295378.152\",\r\n \"taxable_amount\": \"1554621.848\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"ARTICULO NRO 2\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n \"code\": \"ART2\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"2000000.00\",\r\n \"base_quantity\": \"1\"\r\n },\r\n\t\t{\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"2\",\r\n \"line_extension_amount\": \"4957983.193\",\r\n \"free_of_charge_indicator\": false,\r\n\t\t\t\"allowance_charges\": [{\r\n\t\t\t\t\t\"charge_indicator\": false,\r\n\t\t\t\t\t\"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n\t\t\t\t\t\"amount\": \"100000.00\",\r\n\t\t\t\t\t\"base_amount\": \"6000000.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n \"tax_totals\": [{\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"942016.807\",\r\n \"taxable_amount\": \"4957983.193\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"ARTICULO NRO 3\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n \"code\": \"ART3\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"3000000.00\",\r\n \"base_quantity\": \"1\"\r\n }\r\n ]\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "📄 FACTURA CON DESCUENTOS EN LÍNEA - TRES LÍNEAS\n\n## 🔗 Descripción General\nEste ejemplo demuestra cómo enviar una factura electrónica con **tres líneas de productos**, cada una con **descuentos aplicados a nivel de línea** (no descuentos globales). Los descuentos en línea permiten aplicar porcentajes o montos específicos a cada producto individualmente, ideal para promociones por artículo, descuentos por volumen o precios especiales.\n\n## 📋 URL del Endpoint\n\n- **Modo Síncrono (respuesta inmediata):**\n```\nhttp://apidian2026-8.oo/api/ubl2.1/invoice\n```\n\n- **Modo Asíncrono (con set de pruebas de DIAN):**\n```\nhttp://apidian2026-8.oo/api/ubl2.1/invoice/{iddelsetdepruebasdeladian}\n```\n\n**Nota:** Si tiene un dominio configurado, reemplace `apidian2026-8.oo` con su dominio registrado.\n\n## 🔑 Característica Principal\n\nEsta factura implementa **descuentos a nivel de línea**, lo que permite:\n\n- Aplicar descuentos específicos a cada producto individualmente\n- Diferenciar porcentajes de descuento por artículo\n- Calcular bases gravables después de aplicar descuentos\n- Aplicar IVA sobre el valor con descuento ya aplicado\n- Reflejar correctamente los descuentos en cada línea del detalle\n\n## 💰 Estructura de Descuentos en Línea\n\n### Línea 1: ARTICULO NRO 1\n```json\n\"allowance_charges\": [{\n \"charge_indicator\": false, // false = descuento, true = cargo\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\n \"amount\": \"50000.00\", // Monto del descuento\n \"base_amount\": \"1000000.00\" // Precio base antes del descuento\n}]\n```\n**Cálculo:**\n- Precio base: $1,000,000.00\n- Descuento: -$50,000.00 (5%)\n- Subtotal: $950,000.00\n- Base gravable (tras ajuste): $798,319.33\n- IVA 19%: $151,680.67\n- **Total línea:** $950,000.00\n\n### Línea 2: ARTICULO NRO 2\n```json\n\"allowance_charges\": [{\n \"charge_indicator\": false,\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\n \"amount\": \"150000.00\", // Descuento de $150,000\n \"base_amount\": \"2000000.00\" // Precio base $2,000,000\n}]\n```\n**Cálculo:**\n- Precio base: $2,000,000.00\n- Descuento: -$150,000.00 (7.5%)\n- Subtotal: $1,850,000.00\n- Base gravable (tras ajuste): $1,554,621.85\n- IVA 19%: $295,378.15\n- **Total línea:** $1,850,000.00\n\n### Línea 3: ARTICULO NRO 3 (Cantidad: 2)\n```json\n\"allowance_charges\": [{\n \"charge_indicator\": false,\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\n \"amount\": \"100000.00\", // Descuento de $100,000\n \"base_amount\": \"6000000.00\" // Precio base $3M × 2 unidades\n}]\n```\n**Cálculo:**\n- Precio unitario: $3,000,000.00\n- Cantidad: 2 unidades\n- Precio base total: $6,000,000.00\n- Descuento: -$100,000.00 (1.67%)\n- Subtotal: $5,900,000.00\n- Base gravable (tras ajuste): $4,957,983.19\n- IVA 19%: $942,016.81\n- **Total línea:** $5,900,000.00\n\n## 📊 Totales de la Factura 990000178\n\n| Concepto | Valor |\n|----------|-------|\n| **Línea 1** | $950,000.00 |\n| **Línea 2** | $1,850,000.00 |\n| **Línea 3** | $5,900,000.00 |\n| **Subtotal sin IVA** | $7,310,924.18 |\n| **IVA Total (19%)** | $1,389,075.63 |\n| **Total a Pagar** | **$8,700,000.00** |\n\n## 🏢 Datos del Cliente\n\nEsta factura se emite a:\n\n```json\n\"customer\": {\n \"identification_number\": 900166483,\n \"dv\": 1,\n \"name\": \"INVERSIONES DAVAL SAS\",\n \"type_document_identification_id\": 6, // NIT\n \"type_organization_id\": 1, // Persona Jurídica\n \"type_liability_id\": 7, // Responsabilidad fiscal\n \"municipality_id\": 822,\n \"type_regime_id\": 1 // Régimen Común\n}\n```\n\n## 💳 Forma de Pago\n\nPago a crédito con tarjeta:\n\n```json\n\"payment_form\": {\n \"payment_form_id\": 2, // Crédito\n \"payment_method_id\": 30, // Tarjeta de Crédito\n \"payment_due_date\": \"2025-11-28\",\n \"duration_measure\": \"30\" // 30 días plazo\n}\n```\n\n## 📝 Notas Personalizadas\n\nEsta factura incluye:\n\n### Notas Generales\n```json\n\"notes\": \"ESTA ES UNA NOTA DE PRUEBA...\"\n```\n\n### Nota de Encabezado\n```json\n\"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA...\"\n```\n\n### Nota de Pie de Página\n```json\n\"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA...\"\n```\n\n### Notas en Cada Línea\nCada línea incluye:\n```json\n\"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\"\n```\n\n## 🔐 Periodo SEZE\n\n```json\n\"seze\": \"2021-2017\"\n```\n\nIdentifica el periodo del Servicio de Envío de Zonas Especiales para beneficios tributarios.\n\n## 🏢 Configuración del Establecimiento\n\n```json\n\"establishment_name\": \"TORRE SOFTWARE\",\n\"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\n\"establishment_phone\": \"3226563672\",\n\"establishment_municipality\": 600,\n\"establishment_email\": \"alternate_email@alternate.com\"\n```\n\n## 🧮 Diferencia: Descuento en Línea vs Descuento Global\n\n| Aspecto | Descuento en Línea | Descuento Global |\n|---------|-------------------|------------------|\n| **Ubicación JSON** | `invoice_lines[].allowance_charges` | `allowance_charges` (raíz) |\n| **Alcance** | Aplica solo a la línea específica | Aplica al total de la factura |\n| **Flexibilidad** | Diferentes % por producto | Un solo % o monto para toda la factura |\n| **IVA** | Se calcula sobre valor con descuento | Se calcula sobre total con descuento |\n| **Visualización** | Aparece en detalle de cada línea | Aparece al final, antes de impuestos |\n| **Uso típico** | Promociones por producto, descuentos por volumen | Descuentos de clientes VIP, cupones |\n\n## 📌 Notas Importantes\n\n1. **Descuentos en Línea:** Los descuentos se aplican usando el array `allowance_charges` **dentro de cada línea** (`invoice_lines[].allowance_charges`), no a nivel global.\n\n2. **Campo `charge_indicator`:** Debe ser `false` para descuentos. Si es `true`, representa un cargo adicional.\n\n3. **Base Amount:** El campo `base_amount` representa el valor base antes de aplicar el descuento. Para productos con cantidad > 1, es el precio unitario × cantidad.\n\n4. **Cálculo del IVA:** El IVA se calcula sobre la `line_extension_amount` (valor después del descuento), no sobre el precio base.\n\n5. **Múltiples Descuentos:** Puede incluir varios elementos en el array `allowance_charges` para aplicar múltiples descuentos a la misma línea.\n\n6. **Allowance Total:** A nivel de factura, `allowance_total_amount: \"0.00\"` porque los descuentos están en líneas, no globales.\n\n7. **Tres Líneas:** Esta factura incluye 3 productos diferentes:\n - ARTICULO NRO 1 (1 unidad, descuento $50K)\n - ARTICULO NRO 2 (1 unidad, descuento $150K)\n - ARTICULO NRO 3 (2 unidades, descuento $100K)\n\n8. **Códigos de Producto:** Los códigos son personalizados (\"ART1\", \"ART2\", \"ART3\") con `type_item_identification_id: 4` (código estándar del vendedor).\n\n9. **Notas en Línea:** Cada línea incluye su propia nota que aparece en el detalle del producto en la representación gráfica.\n\n10. **Validación DIAN:** La suma de `line_extension_amount` de todas las líneas debe coincidir con el total a nivel de factura.\n\n11. **Email Automático:** Con `sendmail: true` y `sendmailtome: true`, la factura se envía al cliente y al emisor.\n\n12. **Head y Foot Note:** Estas notas aparecen en encabezado y pie de cada página de la representación gráfica, útiles para información corporativa o legal." }, "response": [] }, { "name": "Dos Lineas, Descuento Global y Descuento de Linea, Dos Tarifas de IVA Copy", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": \"990000179\",\r\n \"prefix\": \"SETP\",\r\n \"type_document_id\": \"1\",\r\n \"date\": \"2025-10-28\",\r\n \"time\": \"07:21:19\",\r\n \"resolution_number\": \"18760000001\",\r\n \"customer\": {\r\n \"identification_number\": 89008003,\r\n \"name\": \"ALEXANDER OBANDO LONDOÑO\",\r\n \"phone\": \"3103891693\",\r\n \"address\": \"VEREDA REGUEROS\",\r\n \"email\": \"gerencia@torresoftware.com\",\r\n \"merchant_registration\": \"0000-00\",\r\n \"type_document_identification_id\": 3,\r\n \"type_organization_id\": 2,\r\n \"municipality_id\": 629,\r\n \"type_regime_id\": 2\r\n },\r\n \"payment_form\": {\r\n \"duration_measure\": \"30\",\r\n \"payment_form_id\": \"2\",\r\n \"payment_method_id\": \"1\",\r\n \"payment_due_date\": \"2025-11-28\"\r\n },\r\n \"previous_balance\": \"0\",\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"89831.93\",\r\n \"tax_exclusive_amount\": \"89831.93\",\r\n \"tax_inclusive_amount\": \"105000.00\",\r\n \"charge_total_amount\": \"0.00\",\r\n \"payable_amount\": \"103000.00\",\r\n \"allowance_total_amount\": \"2000.00\"\r\n },\r\n \"allowance_charges\": [{\r\n \"discount_id\": 1,\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"Descuento General\",\r\n \"amount\": \"2000.00\",\r\n \"base_amount\": \"10000.00\"\r\n }\r\n ],\r\n \"tax_totals\": [{\r\n \"tax_id\": \"1\",\r\n \"tax_amount\": \"15168.06\",\r\n \"taxable_amount\": \"79831.93\",\r\n \"percent\": \"19.00\"\r\n }, {\r\n \"tax_id\": \"1\",\r\n \"tax_amount\": \"0.00\",\r\n \"taxable_amount\": \"10000.00\",\r\n \"percent\": \"0.00\"\r\n }\r\n ],\r\n \"invoice_lines\": [{\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": 1,\r\n \"line_extension_amount\": \"79831.93\",\r\n \"free_of_charge_indicator\": false,\r\n \"tax_totals\": [{\r\n \"tax_id\": \"1\",\r\n \"tax_amount\": \"15168.06\",\r\n \"taxable_amount\": \"79831.93\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"Plan Int-RE-3M+: 3548K/800KPeríodo: 05/07/2022 al 04/08/2022Fecha de Corte : 09/08/2022\",\r\n \"code\": \"SERVICIO\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"100000.00\",\r\n \"base_quantity\": 1,\r\n \"allowance_charges\": [{\r\n \"discount_id\": 12,\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"Descuento General\",\r\n \"amount\": \"5000.00\",\r\n \"base_amount\": \"100000.00\"\r\n }\r\n ]\r\n }, {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": 1,\r\n \"line_extension_amount\": \"10000.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"tax_totals\": [{\r\n \"tax_id\": \"1\",\r\n \"tax_amount\": \"0.00\",\r\n \"taxable_amount\": \"10000.00\",\r\n \"percent\": \"0.00\"\r\n }\r\n ],\r\n \"description\": \"Reconexión del servicio por Corte (Comprobante vencido #00197020)\",\r\n \"code\": \"RECONEXION\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"10000.00\",\r\n \"base_quantity\": 1\r\n }\r\n ]\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "📄 FACTURA CON DESCUENTO COMBINADO (GLOBAL + LÍNEA) Y DOS TARIFAS DE IVA\n\n## 🔗 Descripción General\nEste ejemplo demuestra una factura electrónica compleja que combina **dos tipos de descuentos** (global aplicado al total + descuento específico en una línea) con **dos tarifas diferentes de IVA** (19% y 0%). Esta estructura es ideal para casos donde se necesita aplicar tanto descuentos generales de la factura como promociones específicas por producto, con productos que tienen diferentes tratamientos tributarios.\n\n## 📋 URL del Endpoint\n\n- **Modo Síncrono (respuesta inmediata):**\n```\nhttp://apidian2026-8.oo/api/ubl2.1/invoice\n```\n\n- **Modo Asíncrono (con set de pruebas de DIAN):**\n```\nhttp://apidian2026-8.oo/api/ubl2.1/invoice/{iddelsetdepruebasdeladian}\n```\n\n**Nota:** Si tiene un dominio configurado, reemplace `apidian2026-8.oo` con su dominio registrado.\n\n## 🔑 Características Principales\n\nEsta factura implementa:\n\n1. **Descuento Global:** $2,000 aplicado al total de la factura (sobre base de $10,000)\n2. **Descuento en Línea:** $5,000 aplicado específicamente a la primera línea (sobre base de $100,000)\n3. **Dos Tarifas de IVA:** \n - Línea 1: IVA 19% (Plan de internet)\n - Línea 2: IVA 0% (Reconexión)\n4. **Dos Productos Diferentes:** Servicio de internet + Reconexión\n\n## 💰 Estructura de Descuentos\n\n### Descuento Global (Nivel Factura)\n```json\n\"allowance_charges\": [{\n \"discount_id\": 1,\n \"charge_indicator\": false, // false = descuento\n \"allowance_charge_reason\": \"Descuento General\",\n \"amount\": \"2000.00\", // Monto del descuento global\n \"base_amount\": \"10000.00\" // Base sobre la que se aplica\n}]\n```\n\n### Descuento en Línea (Dentro de invoice_lines[0])\n```json\n\"invoice_lines\": [{\n \"allowance_charges\": [{\n \"discount_id\": 12,\n \"charge_indicator\": false,\n \"allowance_charge_reason\": \"Descuento General\",\n \"amount\": \"5000.00\", // Descuento específico de esta línea\n \"base_amount\": \"100000.00\" // Precio base del producto\n }]\n}]\n```\n\n## 📦 Estructura de las Dos Líneas\n\n### Línea 1: Plan Internet (IVA 19% + Descuento en Línea)\n```json\n{\n \"description\": \"Plan Int-RE-3M+: 3548K/800K Período: 05/07/2022 al 04/08/2022\",\n \"code\": \"SERVICIO\",\n \"price_amount\": \"100000.00\",\n \"invoiced_quantity\": 1,\n \"line_extension_amount\": \"79831.93\", // Después de descuento en línea\n \"allowance_charges\": [{ // Descuento de $5,000 en esta línea\n \"amount\": \"5000.00\",\n \"base_amount\": \"100000.00\"\n }],\n \"tax_totals\": [{\n \"tax_id\": \"1\",\n \"tax_amount\": \"15168.06\",\n \"taxable_amount\": \"79831.93\",\n \"percent\": \"19.00\" // IVA del 19%\n }]\n}\n```\n- Precio original: $100,000.00\n- Descuento en línea: -$5,000.00\n- Valor después de descuento: $95,000.00\n- Proporción de descuento global: -$15,168.07\n- **Subtotal línea:** $79,831.93\n- **IVA 19%:** $15,168.06\n\n### Línea 2: Reconexión (IVA 0% + Sin Descuento en Línea)\n```json\n{\n \"description\": \"Reconexión del servicio por Corte (Comprobante vencido #00197020)\",\n \"code\": \"RECONEXION\",\n \"price_amount\": \"10000.00\",\n \"invoiced_quantity\": 1,\n \"line_extension_amount\": \"10000.00\", // Sin descuento en línea\n \"tax_totals\": [{\n \"tax_id\": \"1\",\n \"tax_amount\": \"0.00\",\n \"taxable_amount\": \"10000.00\",\n \"percent\": \"0.00\" // IVA del 0% (exento)\n }]\n}\n```\n- Precio: $10,000.00\n- Sin descuento en línea\n- **Subtotal línea:** $10,000.00\n- **IVA 0%:** $0.00 (producto exento)\n\n## 📊 Totales de la Factura 990000179\n\n| Concepto | Valor |\n|----------|-------|\n| **Línea 1 (antes descuentos)** | $100,000.00 |\n| **Descuento en Línea 1** | -$5,000.00 |\n| **Línea 2 (sin descuento línea)** | $10,000.00 |\n| **Subtotal antes desc. global** | $105,000.00 |\n| **Descuento Global** | -$2,000.00 |\n| **Line Extension Amount** | $89,831.93 |\n| **Tax Exclusive Amount** | $89,831.93 |\n| **IVA 19% (sobre $79,831.93)** | $15,168.06 |\n| **IVA 0% (sobre $10,000.00)** | $0.00 |\n| **Tax Inclusive Amount** | $105,000.00 |\n| **Total Descuentos (allowance_total_amount)** | $2,000.00 |\n| **Total a Pagar (payable_amount)** | **$103,000.00** |\n\n## 🧮 Estructura de Impuestos (tax_totals)\n\n```json\n\"tax_totals\": [\n {\n \"tax_id\": \"1\", // IVA\n \"tax_amount\": \"15168.06\", // IVA de la línea 1\n \"taxable_amount\": \"79831.93\", // Base gravable línea 1\n \"percent\": \"19.00\" // Tarifa 19%\n },\n {\n \"tax_id\": \"1\", // IVA\n \"tax_amount\": \"0.00\", // Sin IVA en línea 2\n \"taxable_amount\": \"10000.00\", // Base gravable línea 2\n \"percent\": \"0.00\" // Tarifa 0% (exento)\n }\n]\n```\n\n## 🏢 Datos del Cliente\n\nEsta factura se emite a:\n\n```json\n\"customer\": {\n \"identification_number\": 89008003,\n \"name\": \"ALEXANDER OBANDO LONDOÑO\",\n \"phone\": \"3103891693\",\n \"address\": \"VEREDA REGUEROS\",\n \"email\": \"gerencia@torresoftware.com\",\n \"merchant_registration\": \"0000-00\",\n \"type_document_identification_id\": 3, // Cédula de Ciudadanía\n \"type_organization_id\": 2, // Persona Natural\n \"municipality_id\": 629,\n \"type_regime_id\": 2 // Régimen Simplificado\n}\n```\n\n## 💳 Forma de Pago\n\nPago a crédito:\n\n```json\n\"payment_form\": {\n \"duration_measure\": \"30\", // Días de plazo\n \"payment_form_id\": \"2\", // Crédito\n \"payment_method_id\": \"1\", // Instrumento no definido\n \"payment_due_date\": \"2025-11-28\"\n}\n```\n\n## 🔀 Orden de Aplicación de Descuentos\n\n1. **Primero:** Se aplican los descuentos en línea (dentro de cada `invoice_lines[]`)\n2. **Segundo:** Se calcula el subtotal con descuentos de línea\n3. **Tercero:** Se aplica el descuento global sobre el subtotal\n4. **Cuarto:** Se calculan los impuestos sobre el valor después de todos los descuentos\n\n**Ejemplo del cálculo:**\n```\nLínea 1: $100,000 - $5,000 (desc. línea) = $95,000\nLínea 2: $10,000 (sin desc. línea)\nSubtotal: $105,000\nDescuento global: -$2,000 (aplicado proporcionalmente)\nBase imponible Línea 1: $79,831.93\nBase imponible Línea 2: $10,000.00\nIVA 19% sobre $79,831.93 = $15,168.06\nIVA 0% sobre $10,000.00 = $0.00\nTotal: $103,000.00\n```\n\n## 🆚 Comparación: Descuento Global vs Descuento en Línea\n\n| Aspecto | Descuento Global | Descuento en Línea |\n|---------|------------------|--------------------|\n| **Ubicación JSON** | `allowance_charges` (raíz) | `invoice_lines[].allowance_charges` |\n| **Alcance** | Toda la factura | Solo la línea específica |\n| **Aplicación** | Después de sumar todas las líneas | Antes de calcular subtotales |\n| **En este ejemplo** | $2,000 sobre $10,000 base | $5,000 sobre $100,000 (solo línea 1) |\n| **Visualización PDF** | Aparece al final, antes de impuestos | Aparece en detalle de la línea |\n| **Cálculo IVA** | IVA se calcula después de este descuento | IVA se calcula después de este descuento |\n\n## 📌 Notas Importantes\n\n1. **Descuentos Combinados:** Este ejemplo demuestra cómo combinar descuentos globales (a nivel factura) con descuentos por línea (a nivel producto).\n\n2. **Dos Tarifas de IVA:** La factura incluye productos con diferentes tratamientos tributarios:\n - Servicio de internet: Gravado al 19%\n - Reconexión: Exento (0%)\n\n3. **tax_totals (Raíz):** Debe incluir un objeto separado por cada tarifa de IVA diferente (19% y 0%).\n\n4. **Orden de Descuentos:** Los descuentos en línea se aplican primero, luego el descuento global se distribuye proporcionalmente.\n\n5. **allowance_total_amount:** En `legal_monetary_totals`, este campo refleja solo el descuento global ($2,000), no incluye descuentos de línea.\n\n6. **line_extension_amount (raíz):** Es la suma de todas las líneas después de aplicar descuentos en línea pero antes del descuento global.\n\n7. **Campo `previous_balance`:** Con valor \"0\" indica que no hay saldo anterior pendiente.\n\n8. **Resolución de Facturación:** La factura usa la resolución \"18760000001\" autorizada por la DIAN.\n\n9. **Productos Exentos:** La línea 2 (Reconexión) tiene IVA 0% porque es un servicio exento de impuestos.\n\n10. **Cálculo Complejo:** La combinación de descuentos global + línea + dos IVAs requiere validación cuidadosa de todos los totales.\n\n11. **Base Amount en Descuentos:** \n - Descuento global: base_amount = $10,000 (solo sobre parte del total)\n - Descuento línea: base_amount = $100,000 (precio original del producto)\n\n12. **Múltiples discount_id:** Los descuentos pueden tener diferentes `discount_id` (1 y 12 en este ejemplo), referenciando diferentes tipos de descuento en la base de datos." }, "response": [] }, { "name": "Enviar Pendientes Factura", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice/send_pendings", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice", "send_pendings" ] }, "description": "# ENVIAR FACTURAS PENDIENTES\n\n## 📋 Descripción\nEnvía a la DIAN todas las facturas que quedaron **pendientes de transmisión** (estado `state_document_id` = 2). Útil cuando hubo fallas de conexión o errores temporales.\n\n**Request Handler:** `InvoiceController@sendPendings`\n\n---\n\n## 🔗 URL\n```\nPOST /api/ubl2.1/invoice/send_pendings\n```\n\n---\n\n## 📤 Body\n**Vacío** - No requiere parámetros en el body.\n\n---\n\n## ⚙️ Comportamiento\n\n1. **Busca** documentos con `state_document_id = 2` (Pendiente)\n2. **Filtra** por company_id del usuario autenticado\n3. **Intenta enviar** cada documento a DIAN\n4. **Actualiza** estado según respuesta:\n - Si éxito: `state_document_id = 1` (Enviado)\n - Si falla: Permanece en 2 (Pendiente)\n5. **Retorna** resumen de envíos (exitosos/fallidos)\n\n---\n\n## ✅ Respuesta Exitosa\n\n```json\n{\n \"success\": true,\n \"message\": \"Proceso completado\",\n \"sent\": 5,\n \"failed\": 2,\n \"total\": 7\n}\n```\n\n---\n\n## 📌 Casos de Uso\n\n✅ Recuperación después de fallas de conexión \n✅ Reintento automático de transmisiones fallidas \n✅ Limpieza de cola de documentos pendientes \n✅ Sincronización después de mantenimiento DIAN" }, "response": [] } ] }, { "name": "Nota Credito", "item": [ { "name": "Una Linea, Sin Descuentos, Una Tarifa de IVA", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"billing_reference\": {\r\n\t\t\"number\": \"SETP990000184\",\r\n\t\t\"uuid\": \"7ff5640c3cf343f6a3299a9c9bb01afa9ac370ba38075f06ac3e6a70c1c3dacc1e391f3f5a257c38fbf5c66e005d660d\",\r\n\t\t\"issue_date\": \"2025-10-29\"\r\n\t},\r\n\t\"discrepancyresponsecode\": 2,\r\n\t\"discrepancyresponsedescription\": \"PRUEBA DE MOTIVO NOTA CREDITO\",\r\n \"notes\": \"PRUEBA DE NOTA CREDITO\",\r\n \"prefix\": \"NC\",\r\n\t\"number\": 4,\r\n\t\"type_document_id\": 4,\r\n\t\"date\": \"2025-10-29\",\r\n\t\"time\": \"06:00:13\",\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"sendmail\": false,\r\n \"sendmailtome\": false,\r\n \"seze\": \"2021-2017\",\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 900166483,\r\n\t\t\"dv\": 1,\r\n\t\t\"name\": \"INVERSIONES DAVAL SAS\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexanderobandolondono@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 6,\r\n\t\t\"type_organization_id\": 1,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1\r\n\t},\r\n\t\"tax_totals\": [\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\"percent\": \"19\",\r\n\t\t\t\"taxable_amount\": \"840336.134\"\r\n\t\t}\r\n\t],\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\"tax_exclusive_amount\": \"840336.134\",\r\n\t\t\"tax_inclusive_amount\": \"1000000.00\",\r\n\t\t\"payable_amount\": \"1000000.00\"\r\n\t},\r\n\t\"credit_note_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\t\t\"taxable_amount\": \"840336.134\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"COMISION POR SERVICIOS\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"COMISION\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"840336.134\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/credit-note", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "credit-note" ] }, "description": "## 📋 PRIMER ENVIO DE NOTA CREDITO\n\n### 🎯 **Descripción General**\nEste endpoint permite emitir **Notas Crédito electrónicas** (type_document_id = 4) que están asociadas obligatoriamente a una factura previamente emitida. Las Notas Crédito se utilizan para anular total o parcialmente una factura, aplicar descuentos posteriores, o corregir errores en el documento original.\n\n### 🔗 **Endpoint**\n```\nPOST http://apidian2026-8.oo/api/ubl2.1/credit-note\nPOST http://apidian2026-8.oo/api/ubl2.1/credit-note/{testSetId}\n```\n\n### 🔑 **Campos Especiales (Diferencias con Factura)**\n\n**1. billing_reference** ⚠️ **(OBLIGATORIO)**\n- `number`: Número de la factura a la que referencia\n- `uuid`: UUID/CUFE de la factura original\n- `issue_date`: Fecha de emisión de la factura original\n\n**2. discrepancyresponsecode** (Código de motivo)\n- 1: Devolución parcial de bienes\n- 2: Anulación\n- 3: Rebaja o descuento parcial\n- 4: Ajuste de precio\n\n**3. discrepancyresponsedescription** (Descripción del motivo)\n- Texto libre explicando el motivo de la nota crédito\n\n**4. credit_note_lines** (en lugar de invoice_lines)\n- Misma estructura que invoice_lines pero para notas crédito\n\n### 🔧 **Handler Técnico**\n- **Controlador**: `CreditNoteController@store`\n- **Validación**: `CreditNoteRequest`\n- **Modelo**: `Document` (type_document_id = 4)\n\n### 🎭 **Modos de Operación**\n\n**1. Modo Síncrono** (Sin testSetId)\n```\nPOST /api/ubl2.1/credit-note\n```\n✅ Respuesta inmediata con validación DIAN\n✅ Incluye resultado: válida o no válida\n✅ No afecta el set de pruebas\n\n**2. Modo Asíncrono** (Con testSetId)\n```\nPOST /api/ubl2.1/credit-note/{testSetId}\n```\n⏳ Respuesta con `zip_key` para consulta posterior\n⏳ Afecta el set de pruebas de la DIAN\n⏳ Consultar resultado en: `/api/ubl2.1/status/zip`\n\n### 💾 **Impacto en Base de Datos**\n- Crea registro en tabla `documents` con `type_document_id = 4`\n- Actualiza `state_document_id` según validación DIAN\n- Genera PDF con representación gráfica de la NC\n- Almacena XML firmado en `storage/xml/`\n\n### ✅ **Respuesta Exitosa (Modo Síncrono)**\n```json\n{\n \"success\": true,\n \"message\": \"Nota Crédito generada correctamente\",\n \"cufe\": \"7ff5640c3cf343f6...\",\n \"number\": \"NC-4\",\n \"pdf_url\": \"http://.../api/pdf/credit-note/NC-4\",\n \"xml_url\": \"http://.../api/xml/credit-note/NC-4\",\n \"dian_status\": \"VALIDADA\"\n}\n```\n\n### ⏳ **Respuesta Exitosa (Modo Asíncrono)**\n```json\n{\n \"success\": true,\n \"zip_key\": \"abc123def456\",\n \"message\": \"Nota Crédito enviada a la cola\"\n}\n```\n\n### ❌ **Errores Comunes**\n- `billing_reference requerido`: Debe referenciar factura válida\n- `UUID de factura no existe`: El CUFE no corresponde a factura registrada\n- `discrepancyresponsecode inválido`: Código debe ser 1, 2, 3 o 4\n- `credit_note_lines vacío`: Debe tener al menos una línea\n- `Valores no coinciden con factura`: Monto excede valor original\n\n### 📌 **Ejemplo cURL**\n```bash\ncurl -X POST \"http://apidian2026-8.oo/api/ubl2.1/credit-note\" \\\n -H \"Authorization: Bearer 4acf1833b3a763a2d7a6253c82cbcfb1...\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"billing_reference\": {\n \"number\": \"SETP990000184\",\n \"uuid\": \"7ff5640c3cf343f6...\",\n \"issue_date\": \"2025-10-29\"\n },\n \"discrepancyresponsecode\": 2,\n \"discrepancyresponsedescription\": \"Anulación por error\",\n \"prefix\": \"NC\",\n \"number\": 4,\n \"type_document_id\": 4,\n \"customer\": {...},\n \"credit_note_lines\": [{...}]\n }'\n```" }, "response": [] }, { "name": "Factura Nacional Suplemento K, Moneda extranjera", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"billing_reference\": {\r\n\t\t\"number\": \"SETP990000171\",\r\n\t\t\"uuid\": \"dfd42c09e6a26b31a237cbb4fea221effd90f935a25ae7f3942d1cc60ee7c55fc59f7cde60226b26f12701b40588e272\",\r\n\t\t\"issue_date\": \"2025-10-28\"\r\n\t},\r\n\t\"discrepancyresponsecode\": 2,\r\n\t\"discrepancyresponsedescription\": \"NOTA CREDITO A FACTURA ELECTRONICA EN MONEDA EXTRANJERA\",\r\n \"notes\": \"PRUEBA DE NOTA CREDITO A FACTURA ELECTRONICA EN MONEDA EXTRANJERA\",\r\n \"prefix\": \"NC\",\r\n\t\"number\": 5,\r\n\t\"type_document_id\": 4,\r\n\t\"date\": \"2025-10-29\",\r\n\t\"time\": \"06:00:13\",\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"sendmail\": false,\r\n \"sendmailtome\": false,\r\n \"seze\": \"2021-2017\",\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"k_supplement_national\": {\r\n \"FctConvCop\": \"3890\",\r\n \"MonedaCop\": \"USD\",\r\n \"SubTotalCop\": \"200.00\",\r\n \"DescuentoDetalleCop\": \"0.00\",\r\n \"RecargoDetalleCop\": \"0.00\",\r\n \"TotalBrutoFacturaCop\": \"200.00\",\r\n \"TotIvaCop\": \"38.00\",\r\n \"TotIncCop\": \"0.00\",\r\n \"TotBolCop\": \"0.00\",\r\n \"TotICLCop\": \"0.00\",\r\n \"TotINPPCop\": \"0.00\",\r\n \"TotIBUACop\": \"0.00\",\r\n \"TotICUICop\": \"0.00\",\r\n \"TotADVCop\": \"0.00\",\r\n \"ImpOtroCop\": \"0.00\",\r\n \"MntImpCop\": \"38.00\",\r\n \"TotalNetoFacturaCop\": \"238.00\",\r\n \"MntDctoCop\": \"0.00\",\r\n \"MntRcgoCop\": \"0.00\",\r\n \"VlrPagarCop\": \"238.00\",\r\n \"ReteFueCop\": \"0.00\",\r\n \"ReteIvaCop\": \"0.00\",\r\n \"ReteIcaCop\": \"0.00\",\r\n \"TotAnticiposCop\": \"0.00\"\r\n },\r\n \"customer\": {\r\n \"identification_number\": \"FR42128XD090\",\r\n \"name\": \"BLANCA NUBIA ALVAREZ ALZATE \",\r\n \"phone\": \"3148931130\",\r\n \"address\": \"CR 14 BIS 31 B 37 BRR SAN NICOLAS\",\r\n \"email\": \"blancanubiaa@hotmail.com\",\r\n \"merchant_registration\": \"0000-00\",\r\n \"type_document_identification_id\": 8,\r\n \"type_organization_id\": 2,\r\n \"country_id\": 65,\r\n \"municipality_name\": \"MIAMI\",\r\n \"state_name\": \"FLORIDA\",\r\n \"type_liability_id\": 117,\r\n \"type_regime_id\": 2\r\n },\r\n \"allowance_charges\": [\r\n {\r\n \"discount_id\": 10,\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"15840.00\"\r\n },\r\n {\r\n \"charge_indicator\": true,\r\n \"allowance_charge_reason\": \"CARGO POR FLETES/FREIGHT CHARGE\",\r\n \"amount\": \"200.00\",\r\n \"base_amount\": \"15840.00\"\r\n }\r\n ],\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"15840.00\",\r\n \"tax_exclusive_amount\": \"15840.00\",\r\n \"tax_inclusive_amount\": \"15840.00\",\r\n \"allowance_total_amount\": \"0.00\",\r\n \"charge_total_amount\": \"200.00\",\r\n \"payable_amount\": \"16040.00\"\r\n },\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"0.00\",\r\n \"percent\": \"0\",\r\n \"taxable_amount\": \"15840.00\"\r\n }\r\n ],\r\n \"credit_note_lines\": [\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"5.00\",\r\n \"line_extension_amount\": \"4950.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"4950.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"0.00\",\r\n \"taxable_amount\": \"4950.00\",\r\n \"percent\": \"0.00\"\r\n }\r\n ],\r\n \"description\": \"LEGGINS DE DAMA REF 1032\",\r\n \"brandname\": \"FULLFIT\",\r\n \"modelname\": \"1032\",\r\n \"code\": \"1032\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"990.00\",\r\n \"base_quantity\": \"5.00\"\r\n },\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"6.00\",\r\n \"line_extension_amount\": \"5940.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"5940.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"0.00\",\r\n \"taxable_amount\": \"5940.00\",\r\n \"percent\": \"0.00\"\r\n }\r\n ],\r\n \"description\": \"LEGGINS DE DAMA REF 1087\",\r\n \"brandname\": \"FULLFIT\",\r\n \"modelname\": \"1087\",\r\n \"code\": \"1087\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"990.00\",\r\n \"base_quantity\": \"6.00\"\r\n },\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"5.00\",\r\n \"line_extension_amount\": \"4950.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"4950.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"0.00\",\r\n \"taxable_amount\": \"4950.00\",\r\n \"percent\": \"0.00\"\r\n }\r\n ],\r\n \"description\": \"LEGGINS DE DAMA REF 1088\",\r\n \"brandname\": \"FULLFIT\",\r\n \"modelname\": \"1088\",\r\n \"code\": \"1088\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"990.00\",\r\n \"base_quantity\": \"5.00\"\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/credit-note", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "credit-note" ] }, "description": "## 💱 NOTA CREDITO CON SUPLEMENTO K - MONEDA EXTRANJERA\n\n### 🎯 **Descripción General**\nEste endpoint permite emitir **Notas Crédito en moneda extranjera** que requieren el objeto `k_supplement_national` para convertir valores a COP. Esta funcionalidad es esencial para negocios que operan con clientes internacionales.\n\n### 🔗 **Endpoint**\n```\nPOST http://apidian2026-8.oo/api/ubl2.1/credit-note\n```\n\n### 🌍 **Campo Especial: k_supplement_national**\n\nEste objeto es **OBLIGATORIO** para Notas Crédito en moneda extranjera:\n\n**Campos del Suplemento K:**\n- `FctConvCop`: Tasa de conversión (TRM)\n- `MonedaCop`: Código de moneda (USD, EUR, GBP, etc.)\n- `SubTotalCop`: Subtotal en COP\n- `TotIvaCop`: Total IVA en COP\n- `VlrPagarCop`: Valor total a pagar en COP\n- `MntDctoCop`: Descuentos en COP\n- `MntRcgoCop`: Recargos en COP\n- `ReteFueCop`: Retención en la fuente en COP\n- `ReteIvaCop`: Retención de IVA en COP\n- `ReteIcaCop`: Retención de ICA en COP\n\n**Customer para extranjeros:**\n- `country_id`: ID del país (diferente a Colombia)\n- `municipality_name`: Nombre de la ciudad (texto libre)\n- `state_name`: Nombre del estado/región (texto libre)\n- `type_document_identification_id`: 8 (Documento extranjero)\n\n### 📊 **Comportamiento en PDF**\nLa representación gráfica muestra:\n- Valores en moneda extranjera (USD, EUR, etc.)\n- Equivalente en COP según TRM\n- Ambos valores visibles para el cliente\n\n### ✅ **Respuesta Exitosa**\n```json\n{\n \"success\": true,\n \"message\": \"Nota Crédito en moneda extranjera generada\",\n \"cufe\": \"dfd42c09e6a26b31...\",\n \"number\": \"NC-5\",\n \"currency\": \"USD\",\n \"trm\": \"3890\",\n \"pdf_url\": \"http://.../api/pdf/credit-note/NC-5\"\n}\n```\n\n### ⚠️ **Consideraciones Importantes**\n- La TRM debe ser la vigente al momento de la emisión\n- Los valores en COP deben coincidir con la conversión\n- El cliente debe tener country_id diferente a Colombia\n- Útil para: devoluciones de exportación, anulaciones de ventas internacionales\n\n_Ver endpoint anterior para detalles completos de Notas Crédito básicas._" }, "response": [] }, { "name": "Una Linea, Descuento Global, Una Tarifa de IVA", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"billing_reference\": {\r\n\t\t\"number\": \"SETP990000184\",\r\n\t\t\"uuid\": \"7ff5640c3cf343f6a3299a9c9bb01afa9ac370ba38075f06ac3e6a70c1c3dacc1e391f3f5a257c38fbf5c66e005d660d\",\r\n\t\t\"issue_date\": \"2025-10-29\"\r\n\t},\r\n\t\"discrepancyresponsecode\": 2,\r\n\t\"discrepancyresponsedescription\": \"PRUEBA DE MOTIVO NOTA CREDITO\",\r\n \"notes\": \"PRUEBA DE NOTA CREDITO\",\r\n \"prefix\": \"NC\",\r\n\t\"number\": 6,\r\n\t\"type_document_id\": 4,\r\n\t\"date\": \"2025-10-29\",\r\n\t\"time\": \"06:00:13\",\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"sendmail\": false,\r\n \"sendmailtome\": false,\r\n \"seze\": \"2021-2017\",\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 800135582,\r\n\t\t\"dv\": 7,\r\n\t\t\"name\": \"FUNDACION ALEJANDRO LONDOÑO\",\r\n\t\t\"phone\": \"3105193539\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"gerencia@torresoftware.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 6,\r\n\t\t\"type_organization_id\": 1,\r\n \"type_liability_id\": 117,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1\r\n\t},\r\n\t\"allowance_charges\": [\r\n\t\t{\r\n\t\t\t\"discount_id\": 1,\r\n\t\t\t\"charge_indicator\": false,\r\n\t\t\t\"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n\t\t\t\"amount\": \"50000.00\",\r\n\t\t\t\"base_amount\": \"1000000.00\"\r\n\t\t}\r\n\t],\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\"tax_exclusive_amount\": \"840336.134\",\r\n\t\t\"tax_inclusive_amount\": \"1000000.00\",\r\n\t\t\"allowance_total_amount\": \"50000.00\",\r\n\t\t\"payable_amount\": \"950000.00\"\r\n\t},\r\n\t\"tax_totals\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\"percent\": \"19\",\r\n\t\t\t\"taxable_amount\": \"840336.134\"\r\n\t\t}\r\n\t],\r\n\t\"credit_note_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\t\t\"taxable_amount\": \"840336.134\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"COMISION POR SERVICIOS\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"COMISION\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"1000000.00\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/credit-note", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "credit-note" ] }, "description": "## 💰 NOTA CREDITO CON DESCUENTO GLOBAL\n\n### 🎯 **Descripción**\nNota Crédito con `allowance_charges` a nivel global (descuento aplicado al total del documento).\n\n### 🔑 **Campo Especial**\n- **allowance_charges** (nivel documento): Array de descuentos/cargos globales\n - `discount_id`: ID del tipo de descuento\n - `charge_indicator`: false = descuento, true = cargo\n - `allowance_charge_reason`: Motivo del descuento\n - `amount`: Valor del descuento\n - `base_amount`: Base sobre la que se aplica\n\n### 📊 **Cálculos**\n- `line_extension_amount`: Subtotal líneas\n- `allowance_total_amount`: Total descuentos globales\n- `payable_amount` = line_extension_amount + tax - allowance_total_amount\n\n_Ver primer endpoint de Nota Crédito para detalles completos._" }, "response": [] }, { "name": "Una Linea, Descuento en Linea, Una Tarifa de IVA", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"billing_reference\": {\r\n\t\t\"number\": \"SETP990000184\",\r\n\t\t\"uuid\": \"7ff5640c3cf343f6a3299a9c9bb01afa9ac370ba38075f06ac3e6a70c1c3dacc1e391f3f5a257c38fbf5c66e005d660d\",\r\n\t\t\"issue_date\": \"2025-10-29\"\r\n\t},\r\n\t\"discrepancyresponsecode\": 2,\r\n\t\"discrepancyresponsedescription\": \"PRUEBA DE MOTIVO NOTA CREDITO\",\r\n \"notes\": \"PRUEBA DE NOTA CREDITO\",\r\n \"resolution_number\": \"0000000000\",\r\n \"prefix\": \"NC\",\r\n\t\"number\": 7,\r\n\t\"type_document_id\": 4,\r\n\t\"date\": \"2025-10-29\",\r\n\t\"time\": \"06:00:13\",\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"sendmail\": true,\r\n \"sendmailtome\": true,\r\n \"seze\": \"2021-2017\",\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 900166483,\r\n\t\t\"dv\": 1,\r\n\t\t\"name\": \"INVERSIONES DAVAL SAS\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexanderobandolondono@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 6,\r\n\t\t\"type_organization_id\": 1,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1\r\n\t},\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"769500.00\",\r\n\t\t\"tax_exclusive_amount\": \"950000.00\",\r\n\t\t\"tax_inclusive_amount\": \"950000.00\",\r\n\t\t\"payable_amount\": \"950000.00\"\r\n\t},\r\n\t\"tax_totals\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"180500\",\r\n\t\t\t\"percent\": \"19\",\r\n\t\t\t\"taxable_amount\": \"950000.00\"\r\n\t\t}\r\n\t],\r\n\t\"credit_note_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"769500.00\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"allowance_charges\": [{\r\n\t\t\t\t\t\"charge_indicator\": false,\r\n\t\t\t\t\t\"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n\t\t\t\t\t\"amount\": \"50000.00\",\r\n\t\t\t\t\t\"base_amount\": \"1000000.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"180500\",\r\n\t\t\t\t\t\"taxable_amount\": \"950000\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"COMISION POR SERVICIOS\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"COMISION\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"1000000.00\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/credit-note", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "credit-note" ] }, "description": "## 🎯 NOTA CREDITO CON DESCUENTO POR LINEA\n\n### 📋 **Descripción**\nNota Crédito con descuentos aplicados a nivel de línea (individual por producto/servicio). Este formato es útil cuando se necesita Especificar descuentos diferentes por cada ítem.\n\n### 🔑 **Campo Especial**\n- **credit_note_lines[].allowance_charges**: Array de descuentos/cargos a nivel de línea\n - `charge_indicator`: false = descuento, true = cargo\n - `allowance_charge_reason`: Motivo del descuento\n - `amount`: Valor del descuento en la línea\n - `base_amount`: Base sobre la que se calcula el descuento\n - `discount_id`: ID del tipo de descuento (tabla `discounts`)\n\n### 🆚 **Diferencia con Descuento Global**\n- **Descuento por línea**: Se aplica individualmente a cada producto\n- **Descuento global**: Se aplica al total del documento\n- Ambos pueden coexistir en el mismo documento\n\n### 💡 **Ejemplo de Uso**\n```json\n\"credit_note_lines\": [\n {\n \"description\": \"Producto A\",\n \"line_extension_amount\": \"1000000.00\",\n \"allowance_charges\": [\n {\n \"charge_indicator\": false,\n \"allowance_charge_reason\": \"DESCUENTO PRONTO PAGO\",\n \"amount\": \"100000.00\",\n \"base_amount\": \"1000000.00\",\n \"discount_id\": 1\n }\n ]\n }\n]\n```\n\n### 📌 **Notas**\n- El descuento reduce el `line_extension_amount` de la línea\n- Los impuestos se calculan sobre el valor **después** del descuento\n- Puede tener múltiples descuentos por línea\n- `discount_id` debe existir en tabla `discounts` de la BD\n\n_Ver primer endpoint de Nota Crédito para documentación completa de campos base._" }, "response": [] }, { "name": "Sin Referencia a Factura - Una Linea, Sin Descuentos, Una Tarifa de IVA", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"discrepancyresponsecode\": 1,\r\n \"notes\": \"PRUEBA DE NOTA CREDITO\",\r\n \"prefix\": \"NC\",\r\n\t\"number\": 18,\r\n\t\"type_document_id\": 4,\r\n\t\"date\": \"2025-10-30\",\r\n\t\"time\": \"06:00:13\",\r\n \"type_operation_id\": \"8\",\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"sendmail\": false,\r\n \"sendmailtome\": false,\r\n \"seze\": \"2021-2017\",\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 900166483,\r\n\t\t\"dv\": 1,\r\n\t\t\"name\": \"INVERSIONES DAVAL SAS\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexanderobandolondono@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 6,\r\n\t\t\"type_organization_id\": 1,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1\r\n\t},\r\n\t\"tax_totals\": [\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\"percent\": \"19\",\r\n\t\t\t\"taxable_amount\": \"840336.134\"\r\n\t\t}\r\n\t],\r\n \"invoice_period\": {\r\n \"start_date\": \"2023-12-01\",\r\n \"end_date\": \"2023-12-31\"\r\n },\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\"tax_exclusive_amount\": \"840336.134\",\r\n\t\t\"tax_inclusive_amount\": \"1000000.00\",\r\n\t\t\"payable_amount\": \"1000000.00\"\r\n\t},\r\n\t\"credit_note_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\t\t\"taxable_amount\": \"840336.134\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"COMISION POR SERVICIOS\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"COMISION\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"840336.134\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/credit-note", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "credit-note" ] }, "description": "## 🔓 NOTA CREDITO SIN REFERENCIA A FACTURA\n\n### 🎯 **Descripción**\nNota Crédito **SIN** `billing_reference` (no está asociada a una factura específica). Esto es válido para casos especiales permitidos por la DIAN.\n\n### ⚠️ **Diferencias Clave**\n- ❌ **NO incluye** `billing_reference`\n- ✅ **Incluye** `type_operation_id`: \"8\" (Operación no sujeta)\n- ✅ **Incluye** `invoice_period`: Período de facturación (start_date, end_date)\n- ✅ **Incluye** `discrepancyresponsecode` sin factura referenciada\n\n### 🔑 **Campos Especiales**\n- **type_operation_id**: \"8\" = Operación no sujeta a referencia\n- **invoice_period**: Período al que aplica la nota crédito\n - `start_date`: Fecha inicio del período\n - `end_date`: Fecha fin del período\n\n### 📋 **Casos de Uso**\n- Devoluciones sin factura específica\n- Compensaciones de períodos\n- Ajustes globales autorizados por DIAN\n\n_Ver primer endpoint de Nota Crédito para detalles completos._" }, "response": [] }, { "name": "Enviar Pendientes Nota Credito", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/credit-note/send_pendings", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "credit-note", "send_pendings" ] }, "description": "# ENVIAR NOTAS CRÉDITO PENDIENTES\n\n## 📋 Descripción\nEnvía a la DIAN todas las notas crédito que quedaron **pendientes de transmisión** (estado `state_document_id` = 2). Útil cuando hubo fallas de conexión o errores temporales al crear notas crédito con `dont_send_yet: true`.\n\n**Request Handler:** `CreditNoteController@send_pendings`\n\n---\n\n## 🔗 URL\n```\nPOST /api/ubl2.1/credit-note/send_pendings\nPOST /api/ubl2.1/credit-note/send_pendings/{prefix}\nPOST /api/ubl2.1/credit-note/send_pendings/{prefix}/{number}\n```\n\n---\n\n## 📤 Body\n**Vacío** - No requiere parámetros en el body.\n\n---\n\n## 🔧 Parámetros URL (Opcionales)\n\n| Parámetro | Tipo | Descripción | Ejemplo |\n|-----------|------|-------------|---------|\n| **prefix** | string | Filtrar por prefijo específico | `NC`, `NCS` |\n| **number** | string | Filtrar por número específico (requiere prefix) | `125` |\n\n**Ejemplos de uso:**\n```\n# Enviar todas las NC pendientes de la empresa\nPOST /api/ubl2.1/credit-note/send_pendings\n\n# Enviar todas las NC con prefijo \"NC\"\nPOST /api/ubl2.1/credit-note/send_pendings/NC\n\n# Enviar NC específica NC-125\nPOST /api/ubl2.1/credit-note/send_pendings/NC/125\n\n# Enviar TODAS las NC pendientes del sistema (solo admin)\nPOST /api/ubl2.1/credit-note/send_pendings/ALL/ALL\n```\n\n---\n\n## ⚙️ Comportamiento\n\n1. **Busca** notas crédito con `type_document_id = 4` y `state_document_id = 2` (Pendiente)\n2. **Filtra** por company_id del usuario autenticado (o todas si ALL/ALL)\n3. **Aplica filtros** de prefix/number si fueron proporcionados\n4. **Lee archivos** XML y ZIP previamente generados\n5. **Firma y envía** cada documento a DIAN\n6. **Actualiza** estado según respuesta:\n - Si éxito: `state_document_id = 1` (Enviado) + guarda CUDE\n - Si falla: Permanece en 2 (Pendiente)\n7. **Retorna** resumen de envíos (exitosos/fallidos)\n\n---\n\n## 🔄 Flujo: Generación Offline → Envío Diferido\n\n### **Paso 1: Crear NC sin enviar a DIAN**\n```json\nPOST /api/ubl2.1/credit-note\n{\n \"dont_send_yet\": true,\n \"prefix\": \"NC\",\n \"number\": 123,\n \"type_document_id\": 4,\n \"billing_reference\": {...},\n \"credit_note_lines\": [...]\n}\n```\n\n**Resultado:**\n- Documento guardado en BD con `state_document_id: 2`\n- CUDE generado localmente\n- XML y ZIP creados pero NO enviados a DIAN\n- Sin validación DIAN aún\n\n### **Paso 2: Enviar pendientes cuando hay conexión**\n```bash\nPOST /api/ubl2.1/credit-note/send_pendings\n```\n\n**Resultado:**\n- Envía todas las NC pendientes a DIAN\n- Actualiza estados\n- Genera ApplicationResponse\n\n---\n\n## ✅ Respuesta Exitosa\n\n```json\n{\n \"success\": true,\n \"message\": \"Envios de documentos pendientes realizados con exito.\",\n \"responses\": [\n {\n \"document\": \"NC-123\",\n \"Envelope\": {\n \"Body\": {\n \"SendBillSyncResponse\": {\n \"SendBillSyncResult\": {\n \"IsValid\": \"true\",\n \"StatusCode\": \"00\",\n \"StatusDescription\": \"Procesado Correctamente.\",\n \"XmlDocumentKey\": \"abc123...xyz789\"\n }\n }\n }\n }\n },\n {\n \"document\": \"NC-124\",\n \"Envelope\": {...}\n }\n ]\n}\n```\n\n---\n\n## 📋 Sin Documentos Pendientes\n\n```json\n{\n \"success\": true,\n \"message\": \"No existen registros de documentos pendientes para realizar envios....\"\n}\n```\n\n---\n\n## ❌ Respuesta con Error\n\n```json\n{\n \"success\": false,\n \"message\": \"El servicio DIAN no se encuentra disponible en el momento, reintente mas tarde...\"\n}\n```\n\n---\n\n## 🎯 Casos de Uso\n\n### **Caso 1: Conexión Inestable**\n```\nProblema:\n- Internet intermitente durante el día\n- Necesitas emitir NC pero DIAN no responde\n\nSolución:\n1. Crear NC con dont_send_yet: true\n2. Acumular documentos localmente\n3. Al final del día: send_pendings\n4. Todas las NC se envían en lote\n```\n\n### **Caso 2: Procesamiento Nocturno**\n```\nProblema:\n- Alto volumen de devoluciones diarias\n- No quieres esperar DIAN en cada operación\n\nSolución:\n1. Durante el día: dont_send_yet: true\n2. A las 11 PM: Ejecutar send_pendings\n3. Transmisión en horario de bajo tráfico\n```\n\n### **Caso 3: Recuperación de Fallas**\n```\nProblema:\n- Hubo caída de servidor DIAN\n- Quedaron NC sin enviar\n\nSolución:\n1. Ejecutar send_pendings\n2. Sistema reintenta automáticamente\n3. Actualiza estados según respuesta\n```\n\n---\n\n## 📌 Consideraciones Importantes\n\n1. **dont_send_yet: true** → Marca el documento como `state_document_id = 2` (Pendiente)\n\n2. **Filtros opcionales:**\n - Sin parámetros: Envía todos los pendientes de la empresa\n - Con prefix: Solo NC con ese prefijo\n - Con prefix/number: NC específica\n\n3. **ALL/ALL:** Requiere permisos de administrador, envía pendientes de TODAS las empresas\n\n4. **Archivos requeridos:** Los XML y ZIP deben existir desde la creación original\n\n5. **CUDE:** Se actualiza con el valor retornado por DIAN al validar\n\n6. **Timeout:** Configurado para 24 horas (86400 seg) para lotes grandes\n\n7. **Memory limit:** 4GB para manejar múltiples documentos\n\n8. **Certificado:** Verifica vigencia antes de enviar\n\n9. **Empresa activa:** Solo envía si `company.state = true`\n\n10. **S3 compatible:** Funciona con archivos en almacenamiento local o S3\n\n---\n\n## 🔑 Diferencias con Facturas\n\n| Aspecto | Facturas | Notas Crédito |\n|---------|----------|---------------|\n| **Endpoint** | `/invoice/send_pendings` | `/credit-note/send_pendings` |\n| **type_document_id** | 1 | 4 |\n| **Prefijos XML** | `FES-`, `ReqFE-`, `RptaFE-` | `NCS-`, `ReqNC-`, `RptaNC-` |\n| **Campo clave** | `cufe` | `cude` |\n| **Controlador** | InvoiceController | CreditNoteController |\n\n---\n\n## 💡 Recomendaciones\n\n✅ Usar `dont_send_yet: true` cuando:\n- Conexión inestable\n- Alto volumen de operaciones\n- Procesamiento en lote preferido\n\n✅ Programar `send_pendings` en:\n- Horarios de baja carga (noche/madrugada)\n- Después de verificar conectividad\n- Con monitoreo de resultados\n\n✅ Validar respuestas:\n- Verificar `IsValid = 'true'`\n- Guardar logs de errores\n- Reintentar documentos fallidos\n\n---\n\n## 🔐 Seguridad\n\n- Requiere **Bearer Token** válido\n- Filtra por empresa del token (excepto ALL/ALL)\n- Valida certificado digital vigente\n- Verifica estado activo de la empresa" }, "response": [] } ] }, { "name": "Nota Debito", "item": [ { "name": "Una Linea, Sin Descuentos, Una Tarifa de IVA", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"billing_reference\": {\r\n\t\t\"number\": \"SETP990000184\",\r\n\t\t\"uuid\": \"7ff5640c3cf343f6a3299a9c9bb01afa9ac370ba38075f06ac3e6a70c1c3dacc1e391f3f5a257c38fbf5c66e005d660d\",\r\n\t\t\"issue_date\": \"2025-10-29\"\r\n\t},\r\n\t\"discrepancyresponsecode\": 3,\r\n\t\"discrepancyresponsedescription\": \"PRUEBA DE MOTIVO NOTA DEBITO\",\r\n \"notes\": \"PRUEBA DE NOTA DEBITO\",\r\n \"prefix\": \"ND\",\r\n\t\"number\": 1,\r\n\t\"type_document_id\": 5,\r\n\t\"date\": \"2025-10-29\",\r\n\t\"time\": \"06:00:13\",\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"sendmail\": false,\r\n \"sendmailtome\": false,\r\n \"seze\": \"2021-2017\",\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 900166483,\r\n\t\t\"dv\": 1,\r\n\t\t\"name\": \"INVERSIONES DAVAL SAS\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexanderobandolondono@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 6,\r\n\t\t\"type_organization_id\": 1,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1\r\n\t},\r\n\t\"allowance_charges\": [\r\n\t\t{\r\n\t\t\t\"discount_id\": 1,\r\n\t\t\t\"charge_indicator\": false,\r\n\t\t\t\"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n\t\t\t\"amount\": \"50000.00\",\r\n\t\t\t\"base_amount\": \"1000000.00\"\r\n\t\t}\r\n\t],\r\n\t\"requested_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\"tax_exclusive_amount\": \"840336.134\",\r\n\t\t\"tax_inclusive_amount\": \"1000000.00\",\r\n\t\t\"allowance_total_amount\": \"50000.00\",\r\n\t\t\"payable_amount\": \"950000.00\"\r\n\t},\r\n\t\"tax_totals\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\"percent\": \"19\",\r\n\t\t\t\"taxable_amount\": \"840336.134\"\r\n\t\t}\r\n\t],\r\n\t\"debit_note_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\t\t\"taxable_amount\": \"840336.134\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"COMISION POR SERVICIOS\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"COMISION\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"1000000.00\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/debit-note", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "debit-note" ] }, "description": "## 📄 NOTA DEBITO - UNA LINEA, SIN DESCUENTOS, UNA TARIFA DE IVA\n\n### 🔗 Descripción General\nNota Débito electrónica **ND-1** que registra **cargos adicionales** de $1.000.000 ($840.336,13 base + $159.663,87 IVA 19%) con descuento global de $50.000, resultando en un total a pagar de $950.000. Referencia la factura **SETP990000184** emitida el 2025-10-29.\n\n### 📋 URL del Endpoint\n```\nPOST http://apidian2026-8.oo/api/ubl2.1/debit-note\nPOST http://apidian2026-8.oo/api/ubl2.1/debit-note/{testSetId}\n```\n**Modos**: Síncrono (sin testSetId) y Asíncrono (con testSetId)\n\n---\n\n### 🔑 Campos/Características Principales\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **type_document_id** | `5` | Nota Débito electrónica |\n| **prefix** | `\"ND\"` | Prefijo de numeración |\n| **number** | `1` | Consecutivo ND-1 |\n| **date** | `\"2025-10-29\"` | Fecha de emisión |\n| **time** | `\"06:00:13\"` | Hora de emisión |\n| **discrepancyresponsecode** | `3` | Código de motivo: Cambio de valor |\n| **discrepancyresponsedescription** | `\"PRUEBA DE MOTIVO NOTA DEBITO\"` | Descripción del motivo |\n| **seze** | `\"2021-2017\"` | Período de validación previa DIAN |\n| **sendmail** | `false` | No enviar correo al cliente |\n| **sendmailtome** | `false` | No enviar copia al emisor |\n\n---\n\n### 📝 Referencia a Factura (billing_reference)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **number** | `\"SETP990000184\"` | Número de la factura referenciada |\n| **uuid** | `\"7ff5640c...005d660d\"` | CUFE de la factura original |\n| **issue_date** | `\"2025-10-29\"` | Fecha de emisión de factura original |\n\n**⚠️ Nota Importante**: El campo `billing_reference` es **OBLIGATORIO** para Notas Débito que referencian una factura específica.\n\n---\n\n### 🔢 Códigos de Discrepancia (discrepancyresponsecode)\n\n| Código | Descripción | Uso |\n|--------|-------------|-----|\n| **1** | Intereses de mora | Cargos por pago tardío |\n| **2** | Gastos por cobrar | Gastos administrativos, cobranza |\n| **3** | Cambio de valor | Ajuste de precio, aumento de valor |\n| **4** | Daños | Cargos por daños o pérdidas |\n| **5** | Otros | Otros motivos válidos |\n\n_En este ejemplo se usa código **3** (Cambio de valor)._\n\n---\n\n### 💰 Totales Solicitados (requested_monetary_totals)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **line_extension_amount** | `\"840336.134\"` | Base imponible (subtotal sin IVA) |\n| **tax_exclusive_amount** | `\"840336.134\"` | Total antes de impuestos |\n| **tax_inclusive_amount** | `\"1000000.00\"` | Total con IVA incluido |\n| **allowance_total_amount** | `\"50000.00\"` | Total descuentos globales |\n| **payable_amount** | `\"950000.00\"` | **Total a pagar final** |\n\n---\n\n### 📊 Cálculo de la Nota Débito\n\n```\n🧮 DETALLE DE CÁLCULO:\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n1 COMISION x $1.000.000,00 = $1.000.000,00\n \nSubtotal sin IVA (base): $ 840.336,13\n+ IVA 19%: $ 159.663,87\n ──────────────\nTotal con IVA: $1.000.000,00\n- Descuento Global: $ 50.000,00\n ──────────────\nTOTAL A PAGAR: $ 950.000,00\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n```\n\n**Nota**: La base imponible se calcula de forma que al aplicar IVA 19% resulte en $1.000.000 total.\n\n---\n\n### 🏢 Datos del Cliente\n\n| Campo | Valor |\n|-------|-------|\n| **Razón Social** | INVERSIONES DAVAL SAS |\n| **NIT** | 900166483-1 |\n| **Tipo Documento** | 6 (NIT) |\n| **Dirección** | CLL 4 NRO 33-90 |\n| **Municipio** | 822 |\n| **Teléfono** | 3103891693 |\n| **Email** | alexanderobandolondono@gmail.com |\n| **Régimen** | 1 (Responsable de IVA) |\n| **Tipo Organización** | 1 (Persona Jurídica) |\n| **Matrícula Mercantil** | 0000000-00 |\n\n---\n\n### 📦 Líneas de la Nota Débito (debit_note_lines)\n\n#### Línea 1: COMISION POR SERVICIOS\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **description** | `\"COMISION POR SERVICIOS\"` | Descripción del cargo |\n| **code** | `\"COMISION\"` | Código interno |\n| **type_item_identification_id** | `4` | Tipo de identificación |\n| **unit_measure_id** | `70` | Unidad (Unidad) |\n| **invoiced_quantity** | `\"1\"` | Cantidad |\n| **price_amount** | `\"1000000.00\"` | Precio unitario |\n| **base_quantity** | `\"1\"` | Cantidad base |\n| **line_extension_amount** | `\"840336.134\"` | Total línea (base sin IVA) |\n| **free_of_charge_indicator** | `false` | No es muestra gratis |\n| **notes** | `\"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\"` | Notas adicionales |\n\n**Impuestos de la línea**:\n- **tax_id**: 1 (IVA)\n- **percent**: 19.00%\n- **taxable_amount**: $840.336,13\n- **tax_amount**: $159.663,87\n\n---\n\n### 💳 Descuentos Globales (allowance_charges)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **discount_id** | `1` | Tipo de descuento |\n| **charge_indicator** | `false` | Es descuento (no cargo) |\n| **allowance_charge_reason** | `\"DESCUENTO GENERAL\"` | Motivo |\n| **amount** | `\"50000.00\"` | Valor del descuento |\n| **base_amount** | `\"1000000.00\"` | Base sobre la que aplica |\n\n**Cálculo**: $1.000.000 - $50.000 = $950.000 (total a pagar)\n\n---\n\n### 📝 Notas de Encabezado y Pie\n\n**head_note**: \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\"\n\n**foot_note**: \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\"\n\n---\n\n### 🔐 Datos del Establecimiento\n\n| Campo | Valor |\n|-------|-------|\n| **establishment_name** | TORRE SOFTWARE |\n| **establishment_address** | BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2 |\n| **establishment_phone** | 3226563672 |\n| **establishment_municipality** | 600 |\n\n---\n\n### 🧮 Comparación: Nota Débito vs Nota Crédito\n\n| Característica | Nota Débito (ND) | Nota Crédito (NC) |\n|----------------|------------------|-------------------|\n| **type_document_id** | 5 | 4 |\n| **Propósito** | Aumentar valor factura | Disminuir valor factura |\n| **Líneas** | `debit_note_lines` | `credit_note_lines` |\n| **Totales** | `requested_monetary_totals` | `requested_monetary_totals` |\n| **Casos de uso** | Intereses mora, cargos adicionales | Devoluciones, descuentos posteriores |\n| **discrepancyresponsecode** | 1-5 (ND) | 1-6 (NC) |\n| **billing_reference** | Obligatorio (si referencia factura) | Obligatorio (si referencia factura) |\n\n---\n\n### 📌 12 PUNTOS IMPORTANTES\n\n1. **billing_reference OBLIGATORIO**: Las Notas Débito que referencian una factura deben incluir `billing_reference` con `number`, `uuid` y `issue_date`.\n\n2. **discrepancyresponsecode válido**: Debe ser 1, 2, 3, 4 o 5 según la tabla de códigos de la DIAN.\n\n3. **debit_note_lines (no invoice_lines)**: Las Notas Débito usan el array `debit_note_lines` en lugar de `invoice_lines`.\n\n4. **requested_monetary_totals**: A diferencia de las facturas que usan `legal_monetary_totals`, las ND usan `requested_monetary_totals`.\n\n5. **Aumenta saldo del cliente**: Una Nota Débito AUMENTA el valor que el cliente debe pagar.\n\n6. **Validación DIAN inmediata**: En modo síncrono, la DIAN valida y responde inmediatamente.\n\n7. **Requiere factura válida**: La factura referenciada debe existir y estar validada por la DIAN.\n\n8. **Descuentos globales**: Se pueden aplicar descuentos globales en `allowance_charges` a nivel raíz.\n\n9. **Cálculo de base imponible**: La base se calcula de forma que Base × (1 + IVA%) = Total con IVA.\n\n10. **PDF y XML**: Se generan automáticamente PDF de representación gráfica y XML UBL 2.1 firmado.\n\n11. **Casos de uso comunes**: Intereses de mora, ajustes de precio, servicios adicionales, gastos de cobranza.\n\n12. **Período SEZE**: El campo `seze` indica el período de validación previa DIAN (ej: \"2021-2017\")." }, "response": [] }, { "name": "Una Linea, Descuento Global, Una Tarifa de IVA", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"billing_reference\": {\r\n\t\t\"number\": \"SETP990000184\",\r\n\t\t\"uuid\": \"7ff5640c3cf343f6a3299a9c9bb01afa9ac370ba38075f06ac3e6a70c1c3dacc1e391f3f5a257c38fbf5c66e005d660d\",\r\n\t\t\"issue_date\": \"2025-10-29\"\r\n\t},\r\n\t\"discrepancyresponsecode\": 3,\r\n\t\"discrepancyresponsedescription\": \"PRUEBA DE MOTIVO NOTA DEBITO\",\r\n \"notes\": \"PRUEBA DE NOTA DEBITO\",\r\n\t\"number\": 2,\r\n\t\"type_document_id\": 5,\r\n\t\"date\": \"2025-10-29\",\r\n\t\"time\": \"06:00:13\",\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"sendmail\": false,\r\n \"sendmailtome\": false,\r\n \"seze\": \"2021-2017\",\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 900166483,\r\n\t\t\"dv\": 1,\r\n\t\t\"name\": \"INVERSIONES DAVAL SAS\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexanderobandolondono@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 6,\r\n\t\t\"type_organization_id\": 1,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1\r\n\t},\r\n\t\"tax_totals\": [\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\"percent\": \"19\",\r\n\t\t\t\"taxable_amount\": \"840336.134\"\r\n\t\t}\r\n\t],\r\n\t\"requested_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\"tax_exclusive_amount\": \"840336.134\",\r\n\t\t\"tax_inclusive_amount\": \"1000000.00\",\r\n\t\t\"payable_amount\": \"1000000.00\"\r\n\t},\r\n\t\"debit_note_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\t\t\"taxable_amount\": \"840336.134\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"COMISION POR SERVICIOS\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"COMISION\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"840336.134\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/debit-note", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "debit-note" ] }, "description": "## 📄 NOTA DEBITO - UNA LINEA, DESCUENTO GLOBAL, UNA TARIFA DE IVA\n\n### 🔗 Descripción General\nNota Débito electrónica **ND-2** que registra cargos adicionales de $1.000.000 ($840.336,13 base + $159.663,87 IVA 19%), **sin descuentos aplicados**. Referencia la factura **SETP990000184** emitida el 2025-10-29 con motivo de cambio de valor (código 3).\n\n### 📋 URL del Endpoint\n```\nPOST http://apidian2026-8.oo/api/ubl2.1/debit-note\nPOST http://apidian2026-8.oo/api/ubl2.1/debit-note/{testSetId}\n```\n**Modos**: Síncrono (sin testSetId) y Asíncrono (con testSetId)\n\n---\n\n### 🔑 Campos/Características Principales\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **type_document_id** | `5` | Nota Débito electrónica |\n| **prefix** | _(sin prefix en body)_ | Sin prefijo explícito |\n| **number** | `2` | Consecutivo ND-2 |\n| **date** | `\"2025-10-29\"` | Fecha de emisión |\n| **time** | `\"06:00:13\"` | Hora de emisión |\n| **discrepancyresponsecode** | `3` | Código de motivo: Cambio de valor |\n| **discrepancyresponsedescription** | `\"PRUEBA DE MOTIVO NOTA DEBITO\"` | Descripción del motivo |\n| **seze** | `\"2021-2017\"` | Período de validación previa DIAN |\n| **sendmail** | `false` | No enviar correo al cliente |\n| **sendmailtome** | `false` | No enviar copia al emisor |\n\n---\n\n### 📝 Referencia a Factura (billing_reference)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **number** | `\"SETP990000184\"` | Número de la factura referenciada |\n| **uuid** | `\"7ff5640c...005d660d\"` | CUFE de la factura original |\n| **issue_date** | `\"2025-10-29\"` | Fecha de emisión de factura original |\n\n**⚠️ Nota Importante**: El campo `billing_reference` es **OBLIGATORIO** para Notas Débito que referencian una factura específica.\n\n---\n\n### 🔢 Códigos de Discrepancia (discrepancyresponsecode)\n\n| Código | Descripción | Uso |\n|--------|-------------|-----|\n| **1** | Intereses de mora | Cargos por pago tardío |\n| **2** | Gastos por cobrar | Gastos administrativos, cobranza |\n| **3** | Cambio de valor | Ajuste de precio, aumento de valor |\n| **4** | Daños | Cargos por daños o pérdidas |\n| **5** | Otros | Otros motivos válidos |\n\n_En este ejemplo se usa código **3** (Cambio de valor)._\n\n---\n\n### 💰 Totales Solicitados (requested_monetary_totals)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **line_extension_amount** | `\"840336.134\"` | Base imponible (subtotal sin IVA) |\n| **tax_exclusive_amount** | `\"840336.134\"` | Total antes de impuestos |\n| **tax_inclusive_amount** | `\"1000000.00\"` | Total con IVA incluido |\n| **payable_amount** | `\"1000000.00\"` | **Total a pagar final** |\n\n**⚠️ Diferencia con ND-1**: Esta ND **NO tiene descuentos globales**, por lo que `payable_amount` = `tax_inclusive_amount`.\n\n---\n\n### 📊 Cálculo de la Nota Débito\n\n```\n🧮 DETALLE DE CÁLCULO:\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n1 COMISION x $840.336,13 = $840.336,13\n \nSubtotal sin IVA (base): $ 840.336,13\n+ IVA 19%: $ 159.663,87\n ──────────────\nTotal con IVA: $1.000.000,00\n- Descuento Global: $ 0,00\n ──────────────\nTOTAL A PAGAR: $1.000.000,00\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n```\n\n**Nota**: En esta ND, el `price_amount` de la línea es $840.336,13 (no $1.000.000 como en ND-1).\n\n---\n\n### 🏢 Datos del Cliente\n\n| Campo | Valor |\n|-------|-------|\n| **Razón Social** | INVERSIONES DAVAL SAS |\n| **NIT** | 900166483-1 |\n| **Tipo Documento** | 6 (NIT) |\n| **Dirección** | CLL 4 NRO 33-90 |\n| **Municipio** | 822 |\n| **Teléfono** | 3103891693 |\n| **Email** | alexanderobandolondono@gmail.com |\n| **Régimen** | 1 (Responsable de IVA) |\n| **Tipo Organización** | 1 (Persona Jurídica) |\n| **Matrícula Mercantil** | 0000000-00 |\n\n---\n\n### 📦 Líneas de la Nota Débito (debit_note_lines)\n\n#### Línea 1: COMISION POR SERVICIOS\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **description** | `\"COMISION POR SERVICIOS\"` | Descripción del cargo |\n| **code** | `\"COMISION\"` | Código interno |\n| **type_item_identification_id** | `4` | Tipo de identificación |\n| **unit_measure_id** | `70` | Unidad (Unidad) |\n| **invoiced_quantity** | `\"1\"` | Cantidad |\n| **price_amount** | `\"840336.134\"` | Precio unitario (base sin IVA) |\n| **base_quantity** | `\"1\"` | Cantidad base |\n| **line_extension_amount** | `\"840336.134\"` | Total línea (base sin IVA) |\n| **free_of_charge_indicator** | `false` | No es muestra gratis |\n| **notes** | `\"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\"` | Notas adicionales |\n\n**Impuestos de la línea**:\n- **tax_id**: 1 (IVA)\n- **percent**: 19.00%\n- **taxable_amount**: $840.336,13\n- **tax_amount**: $159.663,87\n\n---\n\n### 📝 Notas de Encabezado y Pie\n\n**head_note**: \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\"\n\n**foot_note**: \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\"\n\n---\n\n### 🔐 Datos del Establecimiento\n\n| Campo | Valor |\n|-------|-------|\n| **establishment_name** | TORRE SOFTWARE |\n| **establishment_address** | BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2 |\n| **establishment_phone** | 3226563672 |\n| **establishment_municipality** | 600 |\n\n---\n\n### 🧮 Comparación: ND-1 vs ND-2\n\n| Característica | ND-1 | ND-2 |\n|----------------|------|------|\n| **number** | 1 | 2 |\n| **price_amount** | $1.000.000,00 | $840.336,13 |\n| **Descuento Global** | $50.000,00 | $0,00 |\n| **Total a pagar** | $950.000,00 | $1.000.000,00 |\n| **allowance_charges** | ✅ Incluido | ❌ No incluido |\n| **billing_reference** | SETP990000184 | SETP990000184 (misma factura) |\n\n**Diferencia clave**: ND-1 parte de un precio bruto de $1M y aplica descuento, mientras que ND-2 usa directamente el precio neto sin descuentos.\n\n---\n\n### 📌 12 PUNTOS IMPORTANTES\n\n1. **billing_reference OBLIGATORIO**: Las Notas Débito que referencian una factura deben incluir `billing_reference` con `number`, `uuid` y `issue_date`.\n\n2. **discrepancyresponsecode válido**: Debe ser 1, 2, 3, 4 o 5 según la tabla de códigos de la DIAN.\n\n3. **debit_note_lines (no invoice_lines)**: Las Notas Débito usan el array `debit_note_lines` en lugar de `invoice_lines`.\n\n4. **requested_monetary_totals**: A diferencia de las facturas que usan `legal_monetary_totals`, las ND usan `requested_monetary_totals`.\n\n5. **Sin descuentos**: Esta ND no incluye `allowance_charges`, resultando en total a pagar = total con IVA.\n\n6. **price_amount**: En esta ND, el `price_amount` es la base imponible ($840.336,13), no el precio con IVA.\n\n7. **Múltiples ND a misma factura**: Es válido emitir varias Notas Débito referenciando la misma factura original.\n\n8. **Aumenta saldo del cliente**: Una Nota Débito AUMENTA el valor que el cliente debe pagar.\n\n9. **Validación DIAN inmediata**: En modo síncrono, la DIAN valida y responde inmediatamente.\n\n10. **PDF y XML**: Se generan automáticamente PDF de representación gráfica y XML UBL 2.1 firmado.\n\n11. **Casos de uso comunes**: Intereses de mora, ajustes de precio, servicios adicionales, gastos de cobranza.\n\n12. **Consistencia de datos**: El cliente (INVERSIONES DAVAL SAS) debe ser el mismo de la factura referenciada." }, "response": [] }, { "name": "Factura Nacional Suplemento K, Moneda extranjera", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"billing_reference\": {\r\n\t\t\"number\": \"SETP990000171\",\r\n\t\t\"uuid\": \"dfd42c09e6a26b31a237cbb4fea221effd90f935a25ae7f3942d1cc60ee7c55fc59f7cde60226b26f12701b40588e272\",\r\n\t\t\"issue_date\": \"2025-10-28\"\r\n\t},\r\n\t\"discrepancyresponsecode\": 3,\r\n\t\"discrepancyresponsedescription\": \"NOTA CREDITO A FACTURA ELECTRONICA EN MONEDA EXTRANJERA\",\r\n \"notes\": \"PRUEBA DE NOTA CREDITO A FACTURA ELECTRONICA EN MONEDA EXTRANJERA\",\r\n \"prefix\": \"ND\",\r\n\t\"number\": 3,\r\n\t\"type_document_id\": 5,\r\n\t\"date\": \"2025-10-29\",\r\n\t\"time\": \"06:00:13\",\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"sendmail\": false,\r\n \"sendmailtome\": false,\r\n \"seze\": \"2021-2017\",\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"k_supplement_national\": {\r\n \"FctConvCop\": \"3890\",\r\n \"MonedaCop\": \"USD\",\r\n \"SubTotalCop\": \"200.00\",\r\n \"DescuentoDetalleCop\": \"0.00\",\r\n \"RecargoDetalleCop\": \"0.00\",\r\n \"TotalBrutoFacturaCop\": \"200.00\",\r\n \"TotIvaCop\": \"38.00\",\r\n \"TotIncCop\": \"0.00\",\r\n \"TotBolCop\": \"0.00\",\r\n \"TotICLCop\": \"0.00\",\r\n \"TotINPPCop\": \"0.00\",\r\n \"TotIBUACop\": \"0.00\",\r\n \"TotICUICop\": \"0.00\",\r\n \"TotADVCop\": \"0.00\",\r\n \"ImpOtroCop\": \"0.00\",\r\n \"MntImpCop\": \"38.00\",\r\n \"TotalNetoFacturaCop\": \"238.00\",\r\n \"MntDctoCop\": \"0.00\",\r\n \"MntRcgoCop\": \"0.00\",\r\n \"VlrPagarCop\": \"238.00\",\r\n \"ReteFueCop\": \"0.00\",\r\n \"ReteIvaCop\": \"0.00\",\r\n \"ReteIcaCop\": \"0.00\",\r\n \"TotAnticiposCop\": \"0.00\"\r\n },\r\n \"customer\": {\r\n \"identification_number\": \"FR42128XD090\",\r\n \"name\": \"BLANCA NUBIA ALVAREZ ALZATE \",\r\n \"phone\": \"3148931130\",\r\n \"address\": \"CR 14 BIS 31 B 37 BRR SAN NICOLAS\",\r\n \"email\": \"blancanubiaa@hotmail.com\",\r\n \"merchant_registration\": \"0000-00\",\r\n \"type_document_identification_id\": 8,\r\n \"type_organization_id\": 2,\r\n \"country_id\": 65,\r\n \"municipality_name\": \"MIAMI\",\r\n \"state_name\": \"FLORIDA\",\r\n \"type_liability_id\": 117,\r\n \"type_regime_id\": 2\r\n },\r\n \"allowance_charges\": [\r\n {\r\n \"discount_id\": 10,\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"15840.00\"\r\n },\r\n {\r\n \"charge_indicator\": true,\r\n \"allowance_charge_reason\": \"CARGO POR FLETES/FREIGHT CHARGE\",\r\n \"amount\": \"200.00\",\r\n \"base_amount\": \"15840.00\"\r\n }\r\n ],\r\n \"requested_monetary_totals\": {\r\n \"line_extension_amount\": \"15840.00\",\r\n \"tax_exclusive_amount\": \"15840.00\",\r\n \"tax_inclusive_amount\": \"15840.00\",\r\n \"allowance_total_amount\": \"0.00\",\r\n \"charge_total_amount\": \"200.00\",\r\n \"payable_amount\": \"16040.00\"\r\n },\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"0.00\",\r\n \"percent\": \"0\",\r\n \"taxable_amount\": \"15840.00\"\r\n }\r\n ],\r\n \"debit_note_lines\": [\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"5.00\",\r\n \"line_extension_amount\": \"4950.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"4950.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"0.00\",\r\n \"taxable_amount\": \"4950.00\",\r\n \"percent\": \"0.00\"\r\n }\r\n ],\r\n \"description\": \"LEGGINS DE DAMA REF 1032\",\r\n \"brandname\": \"FULLFIT\",\r\n \"modelname\": \"1032\",\r\n \"code\": \"1032\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"990.00\",\r\n \"base_quantity\": \"5.00\"\r\n },\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"6.00\",\r\n \"line_extension_amount\": \"5940.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"5940.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"0.00\",\r\n \"taxable_amount\": \"5940.00\",\r\n \"percent\": \"0.00\"\r\n }\r\n ],\r\n \"description\": \"LEGGINS DE DAMA REF 1087\",\r\n \"brandname\": \"FULLFIT\",\r\n \"modelname\": \"1087\",\r\n \"code\": \"1087\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"990.00\",\r\n \"base_quantity\": \"6.00\"\r\n },\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"5.00\",\r\n \"line_extension_amount\": \"4950.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"4950.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"0.00\",\r\n \"taxable_amount\": \"4950.00\",\r\n \"percent\": \"0.00\"\r\n }\r\n ],\r\n \"description\": \"LEGGINS DE DAMA REF 1088\",\r\n \"brandname\": \"FULLFIT\",\r\n \"modelname\": \"1088\",\r\n \"code\": \"1088\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"990.00\",\r\n \"base_quantity\": \"5.00\"\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/debit-note", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "debit-note" ] }, "description": "## 📄 NOTA DEBITO - FACTURA NACIONAL SUPLEMENTO K, MONEDA EXTRANJERA\n\n### 🔗 Descripción General\nNota Débito electrónica **ND-3** en **moneda extranjera (USD)** con suplemento nacional K que registra cargos adicionales de $16.040 USD ($15.840 base + $200 cargo por fletes) sobre la factura **SETP990000171** emitida el 2025-10-28. Incluye **3 líneas de productos** (leggins) con IVA 0% y conversión automática a pesos colombianos.\n\n### 📋 URL del Endpoint\n```\nPOST http://apidian2026-8.oo/api/ubl2.1/debit-note\nPOST http://apidian2026-8.oo/api/ubl2.1/debit-note/{testSetId}\n```\n**Modos**: Síncrono (sin testSetId) y Asíncrono (con testSetId)\n\n---\n\n### 🔑 Campos/Características Principales\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **type_document_id** | `5` | Nota Débito electrónica |\n| **prefix** | `\"ND\"` | Prefijo de numeración |\n| **number** | `3` | Consecutivo ND-3 |\n| **date** | `\"2025-10-29\"` | Fecha de emisión |\n| **time** | `\"06:00:13\"` | Hora de emisión |\n| **discrepancyresponsecode** | `3` | Código de motivo: Cambio de valor |\n| **discrepancyresponsedescription** | `\"NOTA CREDITO A FACTURA ELECTRONICA EN MONEDA EXTRANJERA\"` | Motivo (descripción dice NC pero es ND) |\n| **seze** | `\"2021-2017\"` | Período de validación previa DIAN |\n| **sendmail** | `false` | No enviar correo al cliente |\n| **sendmailtome** | `false` | No enviar copia al emisor |\n\n**⚠️ Nota**: La descripción menciona \"NOTA CREDITO\" pero el documento es una Nota Débito (type_document_id = 5).\n\n---\n\n### 📝 Referencia a Factura (billing_reference)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **number** | `\"SETP990000171\"` | Número de la factura referenciada |\n| **uuid** | `\"dfd42c09...40588e272\"` | CUFE de la factura original |\n| **issue_date** | `\"2025-10-28\"` | Fecha de emisión de factura original |\n\n**Nota**: Factura diferente a ND-1 y ND-2 (SETP990000184), esta referencia a **SETP990000171**.\n\n---\n\n### 💱 Suplemento Nacional K (k_supplement_national)\n\n**Campo especial para moneda extranjera**: Incluye valores en pesos colombianos (COP) convertidos.\n\n| Campo K | Valor | Descripción |\n|---------|-------|-------------|\n| **FctConvCop** | `\"3890\"` | Factor de conversión USD → COP (1 USD = 3.890 COP) |\n| **MonedaCop** | `\"USD\"` | Moneda extranjera utilizada |\n| **SubTotalCop** | `\"200.00\"` | Subtotal en COP (200 USD × 3890) |\n| **TotalBrutoFacturaCop** | `\"200.00\"` | Total bruto en COP |\n| **TotIvaCop** | `\"38.00\"` | IVA total en COP |\n| **MntImpCop** | `\"38.00\"` | Monto impuestos en COP |\n| **TotalNetoFacturaCop** | `\"238.00\"` | Total neto en COP |\n| **VlrPagarCop** | `\"238.00\"` | Valor a pagar en COP |\n\n**Otros campos en 0**: DescuentoDetalleCop, RecargoDetalleCop, TotIncCop, TotBolCop, TotICLCop, TotINPPCop, TotIBUACop, TotICUICop, TotADVCop, ImpOtroCop, MntDctoCop, MntRcgoCop, ReteFueCop, ReteIvaCop, ReteIcaCop, TotAnticiposCop.\n\n---\n\n### 🔢 Códigos de Discrepancia (discrepancyresponsecode)\n\n| Código | Descripción | Uso |\n|--------|-------------|-----|\n| **1** | Intereses de mora | Cargos por pago tardío |\n| **2** | Gastos por cobrar | Gastos administrativos, cobranza |\n| **3** | Cambio de valor | Ajuste de precio, aumento de valor |\n| **4** | Daños | Cargos por daños o pérdidas |\n| **5** | Otros | Otros motivos válidos |\n\n_En este ejemplo se usa código **3** (Cambio de valor)._\n\n---\n\n### 💰 Totales Solicitados (requested_monetary_totals) - USD\n\n| Campo | Valor (USD) | Descripción |\n|-------|-------------|-------------|\n| **line_extension_amount** | `\"15840.00\"` | Base imponible (subtotal 3 líneas) |\n| **tax_exclusive_amount** | `\"15840.00\"` | Total antes de impuestos |\n| **tax_inclusive_amount** | `\"15840.00\"` | Total con IVA (IVA = 0%) |\n| **allowance_total_amount** | `\"0.00\"` | Total descuentos |\n| **charge_total_amount** | `\"200.00\"` | Total cargos (fletes) |\n| **payable_amount** | `\"16040.00\"` | **Total a pagar final USD** |\n\n**Conversión COP**: 16.040 USD × 3.890 = $62.395.600 COP\n\n---\n\n### 📊 Cálculo de la Nota Débito\n\n```\n🧮 DETALLE DE CÁLCULO (USD):\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nLínea 1: 5 LEGGINS 1032 × $990 = $ 4.950,00\nLínea 2: 6 LEGGINS 1087 × $990 = $ 5.940,00\nLínea 3: 5 LEGGINS 1088 × $990 = $ 4.950,00\n ──────────\nSubtotal 3 líneas: $15.840,00\n+ IVA 0%: $ 0,00\n ──────────\nTotal con IVA: $15.840,00\n+ Cargo por Fletes: $ 200,00\n ──────────\nTOTAL A PAGAR USD: $16.040,00\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\nConversión COP (TRM 3.890):\n$16.040 USD × 3.890 = $62.395.600 COP\n```\n\n---\n\n### 🏢 Datos del Cliente (Extranjero)\n\n| Campo | Valor |\n|-------|-------|\n| **Nombre** | BLANCA NUBIA ALVAREZ ALZATE |\n| **Identificación** | FR42128XD090 |\n| **Tipo Documento** | 8 (Identificación extranjera) |\n| **Dirección** | CR 14 BIS 31 B 37 BRR SAN NICOLAS |\n| **País** | 65 (Francia) |\n| **Municipio** | MIAMI (texto libre) |\n| **Estado** | FLORIDA (texto libre) |\n| **Teléfono** | 3148931130 |\n| **Email** | blancanubiaa@hotmail.com |\n| **Régimen** | 2 (No responsable de IVA) |\n| **Tipo Organización** | 2 (Persona Natural) |\n| **Responsabilidad Fiscal** | 117 |\n| **Matrícula Mercantil** | 0000-00 |\n\n**⚠️ Nota**: Cliente extranjero (Francia, country_id 65) pero municipio/estado dice Miami/Florida (USA). Usar `municipality_name` y `state_name` para extranjeros.\n\n---\n\n### 📦 Líneas de la Nota Débito (debit_note_lines)\n\n#### Línea 1: LEGGINS DE DAMA REF 1032\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **description** | `\"LEGGINS DE DAMA REF 1032\"` | Descripción del producto |\n| **code** | `\"1032\"` | Código interno |\n| **brandname** | `\"FULLFIT\"` | Marca |\n| **modelname** | `\"1032\"` | Modelo |\n| **type_item_identification_id** | `4` | Tipo de identificación |\n| **unit_measure_id** | `70` | Unidad (Unidad) |\n| **invoiced_quantity** | `\"5.00\"` | Cantidad |\n| **price_amount** | `\"990.00\"` | Precio unitario USD |\n| **base_quantity** | `\"5.00\"` | Cantidad base |\n| **line_extension_amount** | `\"4950.00\"` | Total línea USD |\n| **free_of_charge_indicator** | `false` | No es muestra gratis |\n\n**Impuestos**: IVA 0% (tax_amount = $0)\n**Descuentos en línea**: $0 (allowance_charges presente pero amount = $0)\n\n#### Línea 2: LEGGINS DE DAMA REF 1087\n\n| Campo | Valor USD |\n|-------|----------|\n| **invoiced_quantity** | 6.00 |\n| **price_amount** | 990.00 |\n| **line_extension_amount** | 5.940,00 |\n| **tax_amount** | 0,00 (IVA 0%) |\n\n#### Línea 3: LEGGINS DE DAMA REF 1088\n\n| Campo | Valor USD |\n|-------|----------|\n| **invoiced_quantity** | 5.00 |\n| **price_amount** | 990.00 |\n| **line_extension_amount** | 4.950,00 |\n| **tax_amount** | 0,00 (IVA 0%) |\n\n**Total 3 líneas**: 5 + 6 + 5 = 16 unidades × $990 promedio = $15.840\n\n---\n\n### 💳 Cargos Adicionales (allowance_charges) - Globales\n\n#### Cargo 1: Descuento General (valor $0)\n\n| Campo | Valor |\n|-------|-------|\n| **discount_id** | `10` | Tipo de descuento |\n| **charge_indicator** | `false` | Es descuento (no cargo) |\n| **allowance_charge_reason** | `\"DESCUENTO GENERAL\"` | Motivo |\n| **amount** | `\"0.00\"` | Sin descuento |\n| **base_amount** | `\"15840.00\"` | Base sobre la que aplica |\n\n#### Cargo 2: Cargo por Fletes\n\n| Campo | Valor |\n|-------|-------|\n| **charge_indicator** | `true` | Es cargo (no descuento) |\n| **allowance_charge_reason** | `\"CARGO POR FLETES/FREIGHT CHARGE\"` | Motivo |\n| **amount** | `\"200.00\"` | Valor del cargo USD |\n| **base_amount** | `\"15840.00\"` | Base sobre la que aplica |\n\n**Cálculo**: $15.840 + $200 (fletes) = $16.040 total a pagar\n\n---\n\n### 📝 Notas de Encabezado y Pie\n\n**head_note**: \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\"\n\n**foot_note**: \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\"\n\n**notes**: \"PRUEBA DE NOTA CREDITO A FACTURA ELECTRONICA EN MONEDA EXTRANJERA\" (⚠️ dice NC pero es ND)\n\n---\n\n### 🔐 Datos del Establecimiento\n\n| Campo | Valor |\n|-------|-------|\n| **establishment_name** | TORRE SOFTWARE |\n| **establishment_address** | BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2 |\n| **establishment_phone** | 3226563672 |\n| **establishment_municipality** | 600 |\n\n---\n\n### 🧮 Comparación: ND-1/2/3\n\n| Característica | ND-1 | ND-2 | ND-3 |\n|----------------|------|------|------|\n| **number** | 1 | 2 | 3 |\n| **Moneda** | COP | COP | USD |\n| **Líneas** | 1 | 1 | 3 |\n| **Total** | $950.000 | $1.000.000 | $16.040 USD |\n| **IVA** | 19% | 19% | 0% |\n| **Cliente** | Nacional | Nacional | Extranjero |\n| **k_supplement_national** | ❌ | ❌ | ✅ |\n| **Cargos adicionales** | ❌ | ❌ | ✅ Fletes $200 |\n| **billing_reference** | SETP990000184 | SETP990000184 | SETP990000171 |\n\n---\n\n### 📌 12 PUNTOS IMPORTANTES\n\n1. **Moneda extranjera obligatoria**: Cuando se factura en moneda extranjera, el suplemento `k_supplement_national` es **OBLIGATORIO** para cumplir con normativa DIAN.\n\n2. **Factor de conversión**: El campo `FctConvCop` debe contener la **TRM (Tasa Representativa del Mercado)** del día de la transacción.\n\n3. **Cliente extranjero**: Usar `country_id`, `municipality_name`, `state_name` en lugar de `municipality_id` para clientes fuera de Colombia.\n\n4. **IVA 0% en exportación**: Las ventas al exterior pueden aplicar IVA 0% según normativa de exportación.\n\n5. **billing_reference diferente**: Esta ND referencia SETP990000171, distinta a ND-1 y ND-2 que referencian SETP990000184.\n\n6. **Cargos por fletes**: El campo `charge_indicator: true` indica un cargo adicional (no descuento) que aumenta el total.\n\n7. **Múltiples líneas**: Esta ND tiene 3 líneas de productos (leggins) vs 1 línea en ND-1 y ND-2.\n\n8. **Marca y modelo**: Los campos `brandname` y `modelname` son opcionales pero recomendados para productos con estas características.\n\n9. **Descuentos en $0**: Aunque existe `allowance_charges` en las líneas, todos tienen `amount: \"0.00\"` (sin descuento real).\n\n10. **Conversión automática**: El sistema convierte automáticamente USD a COP usando FctConvCop para cumplir con requisitos de la DIAN.\n\n11. **PDF bilingüe**: La representación gráfica debe mostrar valores en USD y COP simultáneamente.\n\n12. **Validación DIAN**: La DIAN valida que los valores en k_supplement_national coincidan con los cálculos principales multiplicados por FctConvCop." }, "response": [] }, { "name": "Una Linea, Descuento en Linea, Una Tarifa de IVA", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"billing_reference\": {\r\n\t\t\"number\": \"SETP990000171\",\r\n\t\t\"uuid\": \"dfd42c09e6a26b31a237cbb4fea221effd90f935a25ae7f3942d1cc60ee7c55fc59f7cde60226b26f12701b40588e272\",\r\n\t\t\"issue_date\": \"2025-10-28\"\r\n\t},\r\n\t\"discrepancyresponsecode\": 3,\r\n\t\"discrepancyresponsedescription\": \"PRUEBA DE MOTIVO NOTA DEBITO\",\r\n \"notes\": \"PRUEBA DE NOTA DEBITO\",\r\n\t\"number\": 4,\r\n\t\"type_document_id\": 5,\r\n\t\"date\": \"2025-10-29\",\r\n\t\"time\": \"06:00:13\",\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"sendmail\": false,\r\n \"sendmailtome\": false,\r\n \"seze\": \"2021-2017\",\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 900166483,\r\n\t\t\"dv\": 1,\r\n\t\t\"name\": \"INVERSIONES DAVAL SAS\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexanderobandolondono@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 6,\r\n\t\t\"type_organization_id\": 1,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1\r\n\t},\r\n\t\"requested_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"769500.00\",\r\n\t\t\"tax_exclusive_amount\": \"950000.00\",\r\n\t\t\"tax_inclusive_amount\": \"950000.00\",\r\n\t\t\"payable_amount\": \"950000.00\"\r\n\t},\r\n\t\"tax_totals\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"180500\",\r\n\t\t\t\"percent\": \"19\",\r\n\t\t\t\"taxable_amount\": \"950000.00\"\r\n\t\t}\r\n\t],\r\n\t\"debit_note_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"769500.00\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"allowance_charges\": [{\r\n\t\t\t\t\t\"charge_indicator\": false,\r\n\t\t\t\t\t\"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n\t\t\t\t\t\"amount\": \"50000.00\",\r\n\t\t\t\t\t\"base_amount\": \"1000000.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"180500\",\r\n\t\t\t\t\t\"taxable_amount\": \"950000\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"COMISION POR SERVICIOS\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"COMISION\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"1000000.00\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/debit-note", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "debit-note" ] }, "description": "## 📄 NOTA DEBITO - UNA LINEA, DESCUENTO EN LINEA, UNA TARIFA DE IVA\n\n### 🔗 Descripción General\nNota Débito electrónica **ND-4** que registra cargos adicionales de $950.000 ($769.500 base + $180.500 IVA 19%) con **descuento en línea** de $50.000 aplicado dentro de la línea de la comisión (no a nivel global). Referencia la factura **SETP990000171** emitida el 2025-10-28.\n\n### 📋 URL del Endpoint\n```\nPOST http://apidian2026-8.oo/api/ubl2.1/debit-note\nPOST http://apidian2026-8.oo/api/ubl2.1/debit-note/{testSetId}\n```\n**Modos**: Síncrono (sin testSetId) y Asíncrono (con testSetId)\n\n---\n\n### 🔑 Campos/Características Principales\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **type_document_id** | `5` | Nota Débito electrónica |\n| **prefix** | _(sin prefix en body)_ | Sin prefijo explícito |\n| **number** | `4` | Consecutivo ND-4 |\n| **date** | `\"2025-10-29\"` | Fecha de emisión |\n| **time** | `\"06:00:13\"` | Hora de emisión |\n| **discrepancyresponsecode** | `3` | Código de motivo: Cambio de valor |\n| **discrepancyresponsedescription** | `\"PRUEBA DE MOTIVO NOTA DEBITO\"` | Descripción del motivo |\n| **seze** | `\"2021-2017\"` | Período de validación previa DIAN |\n| **sendmail** | `false` | No enviar correo al cliente |\n| **sendmailtome** | `false` | No enviar copia al emisor |\n\n---\n\n### 📝 Referencia a Factura (billing_reference)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **number** | `\"SETP990000171\"` | Número de la factura referenciada |\n| **uuid** | `\"dfd42c09...40588e272\"` | CUFE de la factura original |\n| **issue_date** | `\"2025-10-28\"` | Fecha de emisión de factura original |\n\n**⚠️ Nota**: Misma factura que ND-3 (SETP990000171), diferente de ND-1 y ND-2.\n\n---\n\n### 💰 Totales Solicitados (requested_monetary_totals)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **line_extension_amount** | `\"769500.00\"` | Base imponible después de descuento en línea |\n| **tax_exclusive_amount** | `\"950000.00\"` | Total antes de impuestos (base + IVA base) |\n| **tax_inclusive_amount** | `\"950000.00\"` | Total con IVA incluido |\n| **payable_amount** | `\"950000.00\"` | **Total a pagar final** |\n\n**⚠️ Peculiaridad**: Los valores `tax_exclusive_amount`, `tax_inclusive_amount` y `payable_amount` son iguales ($950.000), lo que indica que el IVA ya está incluido en estos totales.\n\n---\n\n### 📊 Cálculo de la Nota Débito\n\n```\n🧮 DETALLE DE CÁLCULO:\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n1 COMISION precio bruto: $1.000.000,00\n- Descuento en Línea: $ 50.000,00\n ──────────────\nBase después descuento: $ 950.000,00\n \nCálculo IVA 19%:\ntaxable_amount = $950.000,00\nIVA = $950.000 × 19% = $180.500,00\n \nPero line_extension_amount = $769.500,00\n(Diferencia por modelo de cálculo específico)\n ──────────────\nTOTAL A PAGAR: $ 950.000,00\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n```\n\n**⚠️ Nota**: Los valores muestran que taxable_amount es $950.000 y se calcula IVA sobre ese monto, pero `line_extension_amount` es $769.500. Esta diferencia sugiere un modelo de cálculo específico.\n\n---\n\n### 🏢 Datos del Cliente\n\n| Campo | Valor |\n|-------|-------|\n| **Razón Social** | INVERSIONES DAVAL SAS |\n| **NIT** | 900166483-1 |\n| **Tipo Documento** | 6 (NIT) |\n| **Dirección** | CLL 4 NRO 33-90 |\n| **Municipio** | 822 |\n| **Teléfono** | 3103891693 |\n| **Email** | alexanderobandolondono@gmail.com |\n| **Régimen** | 1 (Responsable de IVA) |\n| **Tipo Organización** | 1 (Persona Jurídica) |\n| **Matrícula Mercantil** | 0000000-00 |\n\n**Nota**: Mismo cliente que ND-1 y ND-2.\n\n---\n\n### 📦 Líneas de la Nota Débito (debit_note_lines)\n\n#### Línea 1: COMISION POR SERVICIOS (con descuento en línea)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **description** | `\"COMISION POR SERVICIOS\"` | Descripción del cargo |\n| **code** | `\"COMISION\"` | Código interno |\n| **type_item_identification_id** | `4` | Tipo de identificación |\n| **unit_measure_id** | `70` | Unidad (Unidad) |\n| **invoiced_quantity** | `\"1\"` | Cantidad |\n| **price_amount** | `\"1000000.00\"` | Precio unitario bruto |\n| **base_quantity** | `\"1\"` | Cantidad base |\n| **line_extension_amount** | `\"769500.00\"` | Total línea después descuento |\n| **free_of_charge_indicator** | `false` | No es muestra gratis |\n| **notes** | `\"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\"` | Notas adicionales |\n\n**Descuento en línea** (dentro de `allowance_charges` de la línea):\n- **charge_indicator**: `false` (es descuento)\n- **allowance_charge_reason**: \"DESCUENTO GENERAL\"\n- **amount**: `\"50000.00\"` (descuento aplicado)\n- **base_amount**: `\"1000000.00\"` (precio base)\n\n**Impuestos de la línea**:\n- **tax_id**: 1 (IVA)\n- **percent**: 19.00%\n- **taxable_amount**: $950.000 (después del descuento)\n- **tax_amount**: $180.500\n\n**Cálculo línea**: $1.000.000 - $50.000 (descuento) = $950.000\n\n---\n\n### 🧮 Comparación: Descuento Global vs Descuento en Línea\n\n| Característica | ND-1 (Descuento Global) | ND-4 (Descuento en Línea) |\n|----------------|-------------------------|---------------------------|\n| **number** | 1 | 4 |\n| **Descuento** | $50.000 | $50.000 |\n| **Ubicación descuento** | `allowance_charges` raíz | `allowance_charges` dentro línea |\n| **Total a pagar** | $950.000 | $950.000 |\n| **line_extension_amount** | $840.336,13 | $769.500,00 |\n| **billing_reference** | SETP990000184 | SETP990000171 |\n| **Cliente** | INVERSIONES DAVAL SAS | INVERSIONES DAVAL SAS |\n\n**Diferencia clave**: ND-1 aplica descuento global después de calcular subtotales, mientras ND-4 aplica descuento **dentro de la línea** antes de calcular IVA.\n\n---\n\n### 📝 Notas de Encabezado y Pie\n\n**head_note**: \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\"\n\n**foot_note**: \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\"\n\n---\n\n### 🔐 Datos del Establecimiento\n\n| Campo | Valor |\n|-------|-------|\n| **establishment_name** | TORRE SOFTWARE |\n| **establishment_address** | BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2 |\n| **establishment_phone** | 3226563672 |\n| **establishment_municipality** | 600 |\n\n---\n\n### 📌 12 PUNTOS IMPORTANTES\n\n1. **Descuento en línea vs global**: Esta ND aplica el descuento **dentro del array `allowance_charges` de la línea**, no a nivel raíz del documento.\n\n2. **Orden de cálculo**: Descuento en línea se aplica ANTES de calcular IVA: (Precio - Descuento) × IVA%.\n\n3. **billing_reference diferente**: Esta ND referencia SETP990000171 (igual que ND-3), distinta de ND-1 y ND-2.\n\n4. **Misma estructura que facturas**: Los descuentos en línea siguen la misma lógica que en facturas con `invoice_lines[].allowance_charges`.\n\n5. **taxable_amount peculiar**: El `taxable_amount` es $950.000 (después del descuento), sobre el cual se calcula IVA 19%.\n\n6. **line_extension_amount**: Representa la base neta después de descuento ($769.500), aunque el cálculo exacto puede variar según implementación.\n\n7. **Múltiples descuentos**: Se pueden tener múltiples descuentos en la misma línea usando array `allowance_charges`.\n\n8. **Validación DIAN**: La DIAN valida que los cálculos de descuentos en línea sean correctos antes de aplicar impuestos.\n\n9. **charge_indicator false**: `charge_indicator: false` indica descuento; `true` indicaría cargo adicional.\n\n10. **base_amount**: El `base_amount` en el descuento indica sobre qué monto se calculó el descuento ($1.000.000).\n\n11. **Impacto en contabilidad**: Descuentos en línea afectan directamente la base imponible del IVA.\n\n12. **Casos de uso**: Descuentos en línea son comunes para descuentos por volumen, promociones por producto, o ajustes específicos por ítem." }, "response": [] }, { "name": "Sin Referencia a Factura - Una Linea, Sin Descuentos, Una Tarifa de IVA", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"discrepancyresponsecode\": 3,\r\n \"notes\": \"PRUEBA DE NOTA DEBITO\",\r\n \"prefix\": \"ND\",\r\n\t\"number\": 19,\r\n\t\"type_document_id\": 5,\r\n\t\"date\": \"2025-10-30\",\r\n\t\"time\": \"06:00:13\",\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"sendmail\": false,\r\n \"sendmailtome\": false,\r\n \"seze\": \"2021-2017\",\r\n \"type_operation_id\": 5,\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 900166483,\r\n\t\t\"dv\": 1,\r\n\t\t\"name\": \"INVERSIONES DAVAL SAS\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexanderobandolondono@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 6,\r\n\t\t\"type_organization_id\": 1,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1\r\n\t},\r\n\t\"tax_totals\": [\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\"percent\": \"19\",\r\n\t\t\t\"taxable_amount\": \"840336.134\"\r\n\t\t}\r\n\t],\r\n \"invoice_period\": {\r\n \"start_date\": \"2023-12-01\",\r\n \"end_date\": \"2023-12-31\"\r\n },\r\n\t\"requested_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\"tax_exclusive_amount\": \"840336.134\",\r\n\t\t\"tax_inclusive_amount\": \"1000000.00\",\r\n\t\t\"payable_amount\": \"1000000.00\"\r\n\t},\r\n\t\"debit_note_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\t\t\"taxable_amount\": \"840336.134\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"COMISION POR SERVICIOS\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"COMISION\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"840336.134\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/debit-note", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "debit-note" ] }, "description": "## 📄 NOTA DEBITO SIN REFERENCIA A FACTURA\n\n### 🔗 Descripción General\nNota Débito electrónica **ND-19** **SIN** `billing_reference` (no referencia factura específica) que registra cargos de $1.000.000 ($840.336,13 base + $159.663,87 IVA 19%). Incluye `type_operation_id: 5` e `invoice_period` para indicar el período al que aplica (diciembre 2023). Esto es válido para casos especiales permitidos por la DIAN.\n\n### 📋 URL del Endpoint\n```\nPOST http://apidian2026-8.oo/api/ubl2.1/debit-note\nPOST http://apidian2026-8.oo/api/ubl2.1/debit-note/{testSetId}\n```\n**Modos**: Síncrono (sin testSetId) y Asíncrono (con testSetId)\n\n---\n\n### 🔑 Campos/Características Principales\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **type_document_id** | `5` | Nota Débito electrónica |\n| **prefix** | `\"ND\"` | Prefijo de numeración |\n| **number** | `19` | Consecutivo ND-19 |\n| **date** | `\"2025-10-30\"` | Fecha de emisión |\n| **time** | `\"06:00:13\"` | Hora de emisión |\n| **type_operation_id** | `5` | Operación sin referencia a documento específico |\n| **discrepancyresponsecode** | `3` | Código de motivo: Cambio de valor |\n| **seze** | `\"2021-2017\"` | Período de validación previa DIAN |\n| **sendmail** | `false` | No enviar correo al cliente |\n| **sendmailtome** | `false` | No enviar copia al emisor |\n\n---\n\n### ⚠️ Diferencias Clave con ND con Referencia\n\n| Campo | ND con Referencia (ND-1/2/3/4) | ND Sin Referencia (ND-19) |\n|-------|-------------------------------|---------------------------|\n| **billing_reference** | ✅ **OBLIGATORIO** | ❌ **NO incluye** |\n| **type_operation_id** | No requerido | ✅ **5** (Operación sin referencia) |\n| **invoice_period** | No requerido | ✅ **Incluye** (start_date, end_date) |\n| **Casos de uso** | Ajuste a factura específica | Cargos periódicos globales |\n\n---\n\n### 📅 Período de Facturación (invoice_period)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **start_date** | `\"2023-12-01\"` | Fecha inicio del período |\n| **end_date** | `\"2023-12-31\"` | Fecha fin del período (diciembre 2023) |\n\n**Propósito**: Indica el período al que aplica la nota débito cuando no hay factura específica referenciada.\n\n---\n\n### 🔢 Códigos de Tipo de Operación\n\n| Código | Descripción | Uso |\n|--------|-------------|-----|\n| **5** | Operación sin referencia a documento | Notas débito/crédito sin billing_reference |\n| **8** | Operación no sujeta | Documentos especiales autorizados DIAN |\n| **10** | Otros | Otras operaciones válidas |\n\n_En este ejemplo se usa código **5** (Sin referencia a documento)._\n\n---\n\n### 💰 Totales Solicitados (requested_monetary_totals)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **line_extension_amount** | `\"840336.134\"` | Base imponible (subtotal sin IVA) |\n| **tax_exclusive_amount** | `\"840336.134\"` | Total antes de impuestos |\n| **tax_inclusive_amount** | `\"1000000.00\"` | Total con IVA incluido |\n| **payable_amount** | `\"1000000.00\"` | **Total a pagar final** |\n\n---\n\n### 📊 Cálculo de la Nota Débito\n\n```\n🧮 DETALLE DE CÁLCULO:\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n1 COMISION x $840.336,13 = $840.336,13\n \nSubtotal sin IVA (base): $ 840.336,13\n+ IVA 19%: $ 159.663,87\n ──────────────\nTotal con IVA: $1.000.000,00\n- Descuento: $ 0,00\n ──────────────\nTOTAL A PAGAR: $1.000.000,00\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n```\n\n---\n\n### 🏢 Datos del Cliente\n\n| Campo | Valor |\n|-------|-------|\n| **Razón Social** | INVERSIONES DAVAL SAS |\n| **NIT** | 900166483-1 |\n| **Tipo Documento** | 6 (NIT) |\n| **Dirección** | CLL 4 NRO 33-90 |\n| **Municipio** | 822 |\n| **Teléfono** | 3103891693 |\n| **Email** | alexanderobandolondono@gmail.com |\n| **Régimen** | 1 (Responsable de IVA) |\n| **Tipo Organización** | 1 (Persona Jurídica) |\n| **Matrícula Mercantil** | 0000000-00 |\n\n**Nota**: Mismo cliente que ND-1, ND-2 y ND-4.\n\n---\n\n### 📦 Líneas de la Nota Débito (debit_note_lines)\n\n#### Línea 1: COMISION POR SERVICIOS\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **description** | `\"COMISION POR SERVICIOS\"` | Descripción del cargo |\n| **code** | `\"COMISION\"` | Código interno |\n| **type_item_identification_id** | `4` | Tipo de identificación |\n| **unit_measure_id** | `70` | Unidad (Unidad) |\n| **invoiced_quantity** | `\"1\"` | Cantidad |\n| **price_amount** | `\"840336.134\"` | Precio unitario (base sin IVA) |\n| **base_quantity** | `\"1\"` | Cantidad base |\n| **line_extension_amount** | `\"840336.134\"` | Total línea (base sin IVA) |\n| **free_of_charge_indicator** | `false` | No es muestra gratis |\n| **notes** | `\"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\"` | Notas adicionales |\n\n**Impuestos de la línea**:\n- **tax_id**: 1 (IVA)\n- **percent**: 19.00%\n- **taxable_amount**: $840.336,13\n- **tax_amount**: $159.663,87\n\n---\n\n### 📝 Notas de Encabezado y Pie\n\n**head_note**: \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\"\n\n**foot_note**: \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\"\n\n**notes**: \"PRUEBA DE NOTA DEBITO\"\n\n---\n\n### 🔐 Datos del Establecimiento\n\n| Campo | Valor |\n|-------|-------|\n| **establishment_name** | TORRE SOFTWARE |\n| **establishment_address** | BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2 |\n| **establishment_phone** | 3226563672 |\n| **establishment_municipality** | 600 |\n\n---\n\n### 🧮 Comparación: ND Con vs Sin Referencia\n\n| Característica | ND Con Referencia | ND-19 Sin Referencia |\n|----------------|------------------|----------------------|\n| **billing_reference** | ✅ Incluido | ❌ NO incluido |\n| **type_operation_id** | No requerido | ✅ 5 (obligatorio) |\n| **invoice_period** | No requerido | ✅ Incluido |\n| **Propósito** | Ajuste a factura específica | Cargos globales periódicos |\n| **Validación DIAN** | Verifica factura existe | Verifica período válido |\n| **Casos de uso** | Intereses mora a factura X | Comisiones mensuales generales |\n\n---\n\n### 📋 Casos de Uso ND Sin Referencia\n\n1. **Comisiones periódicas**: Comisiones bancarias mensuales sin factura específica\n2. **Ajustes globales**: Ajustes de valor sobre período completo\n3. **Cargos administrativos**: Cargos administrativos mensuales/anuales\n4. **Servicios continuos**: Servicios de monitoreo o soporte sin factura individual\n5. **Intereses compuestos**: Intereses sobre saldo total del período\n6. **Cargos autorizados DIAN**: Casos especiales permitidos por la DIAN\n\n---\n\n### 📌 12 PUNTOS IMPORTANTES\n\n1. **billing_reference NO incluido**: A diferencia de ND-1/2/3/4, esta ND **NO** incluye `billing_reference`.\n\n2. **type_operation_id OBLIGATORIO**: Cuando no hay `billing_reference`, el campo `type_operation_id: 5` es **OBLIGATORIO**.\n\n3. **invoice_period requerido**: Debe incluir `invoice_period` con `start_date` y `end_date` para indicar el período.\n\n4. **Validación DIAN especial**: La DIAN valida que el tipo de operación 5 sea válido para el caso de uso declarado.\n\n5. **Autorización previa**: Algunos casos de ND sin referencia pueden requerir autorización previa de la DIAN.\n\n6. **Período histórico**: En este ejemplo, el período es diciembre 2023, pero la ND se emite en octubre 2025 (válido para ajustes retroactivos).\n\n7. **Sin descuentos**: Esta ND no incluye descuentos globales ni en línea.\n\n8. **Estructura similar**: Excepto `billing_reference`, la estructura es idéntica a ND con referencia.\n\n9. **Casos limitados**: Las ND sin referencia son válidas solo para casos específicos permitidos por normativa DIAN.\n\n10. **Trazabilidad**: Aunque no referencia factura, debe haber trazabilidad del motivo del cargo.\n\n11. **Contabilidad**: En contabilidad, estas ND afectan cuentas por cobrar generales, no facturas específicas.\n\n12. **Documentación adicional**: Se recomienda documentación adicional que justifique el cargo sin referencia a factura." }, "response": [] }, { "name": "Enviar Pendientes Nota Debito", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/debit-note/send_pendings", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "debit-note", "send_pendings" ] }, "description": "# ENVIAR NOTAS DÉBITO PENDIENTES\n\n## 📋 Descripción\nEnvía a la DIAN todas las notas débito que quedaron **pendientes de transmisión** (estado `state_document_id` = 2). Útil cuando hubo fallas de conexión o errores temporales al crear notas débito con `dont_send_yet: true`.\n\n**Request Handler:** `DebitNoteController@send_pendings`\n\n---\n\n## 🔗 URL\n```\nPOST /api/ubl2.1/debit-note/send_pendings\nPOST /api/ubl2.1/debit-note/send_pendings/{prefix}\nPOST /api/ubl2.1/debit-note/send_pendings/{prefix}/{number}\n```\n\n---\n\n## 📤 Body\n**Vacío** - No requiere parámetros en el body.\n\n---\n\n## 🔧 Parámetros URL (Opcionales)\n\n| Parámetro | Tipo | Descripción | Ejemplo |\n|-----------|------|-------------|---------|\n| **prefix** | string | Filtrar por prefijo específico | `ND`, `NDS` |\n| **number** | string | Filtrar por número específico (requiere prefix) | `125` |\n\n**Ejemplos de uso:**\n```\n# Enviar todas las ND pendientes de la empresa\nPOST /api/ubl2.1/debit-note/send_pendings\n\n# Enviar todas las ND con prefijo \"ND\"\nPOST /api/ubl2.1/debit-note/send_pendings/ND\n\n# Enviar ND específica ND-125\nPOST /api/ubl2.1/debit-note/send_pendings/ND/125\n\n# Enviar TODAS las ND pendientes del sistema (solo admin)\nPOST /api/ubl2.1/debit-note/send_pendings/ALL/ALL\n```\n\n---\n\n## ⚙️ Comportamiento\n\n1. **Busca** notas débito con `type_document_id = 5` y `state_document_id = 2` (Pendiente)\n2. **Filtra** por company_id del usuario autenticado (o todas si ALL/ALL)\n3. **Aplica filtros** de prefix/number si fueron proporcionados\n4. **Lee archivos** XML y ZIP previamente generados\n5. **Firma y envía** cada documento a DIAN\n6. **Actualiza** estado según respuesta:\n - Si éxito: `state_document_id = 1` (Enviado) + guarda CUDE\n - Si falla: Permanece en 2 (Pendiente)\n7. **Retorna** resumen de envíos (exitosos/fallidos)\n\n---\n\n## 🔄 Flujo: Generación Offline → Envío Diferido\n\n### **Paso 1: Crear ND sin enviar a DIAN**\n```json\nPOST /api/ubl2.1/debit-note\n{\n \"dont_send_yet\": true,\n \"prefix\": \"ND\",\n \"number\": 123,\n \"type_document_id\": 5,\n \"billing_reference\": {...},\n \"debit_note_lines\": [...]\n}\n```\n\n**Resultado:**\n- Documento guardado en BD con `state_document_id: 2`\n- CUDE generado localmente\n- XML y ZIP creados pero NO enviados a DIAN\n- Sin validación DIAN aún\n\n### **Paso 2: Enviar pendientes cuando hay conexión**\n```bash\nPOST /api/ubl2.1/debit-note/send_pendings\n```\n\n**Resultado:**\n- Envía todas las ND pendientes a DIAN\n- Actualiza estados\n- Genera ApplicationResponse\n\n---\n\n## ✅ Respuesta Exitosa\n\n```json\n{\n \"success\": true,\n \"message\": \"Envios de documentos pendientes realizados con exito.\",\n \"responses\": [\n {\n \"document\": \"ND-123\",\n \"Envelope\": {\n \"Body\": {\n \"SendBillSyncResponse\": {\n \"SendBillSyncResult\": {\n \"IsValid\": \"true\",\n \"StatusCode\": \"00\",\n \"StatusDescription\": \"Procesado Correctamente.\",\n \"XmlDocumentKey\": \"abc123...xyz789\"\n }\n }\n }\n }\n },\n {\n \"document\": \"ND-124\",\n \"Envelope\": {...}\n }\n ]\n}\n```\n\n---\n\n## 📋 Sin Documentos Pendientes\n\n```json\n{\n \"success\": true,\n \"message\": \"No existen registros de documentos pendientes para realizar envios....\"\n}\n```\n\n---\n\n## ❌ Respuesta con Error\n\n```json\n{\n \"success\": false,\n \"message\": \"El servicio DIAN no se encuentra disponible en el momento, reintente mas tarde...\"\n}\n```\n\n---\n\n## 🎯 Casos de Uso\n\n### **Caso 1: Conexión Inestable**\n```\nProblema:\n- Internet intermitente durante el día\n- Necesitas emitir ND pero DIAN no responde\n\nSolución:\n1. Crear ND con dont_send_yet: true\n2. Acumular documentos localmente\n3. Al final del día: send_pendings\n4. Todas las ND se envían en lote\n```\n\n### **Caso 2: Procesamiento Nocturno**\n```\nProblema:\n- Alto volumen de intereses de mora diarios\n- No quieres esperar DIAN en cada operación\n\nSolución:\n1. Durante el día: dont_send_yet: true\n2. A las 11 PM: Ejecutar send_pendings\n3. Transmisión en horario de bajo tráfico\n```\n\n### **Caso 3: Recuperación de Fallas**\n```\nProblema:\n- Hubo caída de servidor DIAN\n- Quedaron ND sin enviar\n\nSolución:\n1. Ejecutar send_pendings\n2. Sistema reintenta automáticamente\n3. Actualiza estados según respuesta\n```\n\n---\n\n## 📌 Consideraciones Importantes\n\n1. **dont_send_yet: true** → Marca el documento como `state_document_id = 2` (Pendiente)\n\n2. **Filtros opcionales:**\n - Sin parámetros: Envía todos los pendientes de la empresa\n - Con prefix: Solo ND con ese prefijo\n - Con prefix/number: ND específica\n\n3. **ALL/ALL:** Requiere permisos de administrador, envía pendientes de TODAS las empresas\n\n4. **Archivos requeridos:** Los XML y ZIP deben existir desde la creación original\n\n5. **CUDE:** Se actualiza con el valor retornado por DIAN al validar\n\n6. **Timeout:** Configurado para 24 horas (86400 seg) para lotes grandes\n\n7. **Memory limit:** 4GB para manejar múltiples documentos\n\n8. **Certificado:** Verifica vigencia antes de enviar\n\n9. **Empresa activa:** Solo envía si `company.state = true`\n\n10. **S3 compatible:** Funciona con archivos en almacenamiento local o S3\n\n---\n\n## 🔑 Diferencias con Facturas y Notas Crédito\n\n| Aspecto | Facturas | Notas Crédito | Notas Débito |\n|---------|----------|---------------|---------------|\n| **Endpoint** | `/invoice/send_pendings` | `/credit-note/send_pendings` | `/debit-note/send_pendings` |\n| **type_document_id** | 1 | 4 | 5 |\n| **Prefijos XML** | `FES-`, `ReqFE-`, `RptaFE-` | `NCS-`, `ReqNC-`, `RptaNC-` | `NDS-`, `ReqND-`, `RptaND-` |\n| **Campo clave** | `cufe` | `cude` | `cude` |\n| **Controlador** | InvoiceController | CreditNoteController | DebitNoteController |\n\n---\n\n## 💡 Recomendaciones\n\n✅ Usar `dont_send_yet: true` cuando:\n- Conexión inestable\n- Alto volumen de operaciones\n- Procesamiento en lote preferido\n\n✅ Programar `send_pendings` en:\n- Horarios de baja carga (noche/madrugada)\n- Después de verificar conectividad\n- Con monitoreo de resultados\n\n✅ Validar respuestas:\n- Verificar `IsValid = 'true'`\n- Guardar logs de errores\n- Reintentar documentos fallidos\n\n---\n\n## 🔐 Seguridad\n\n- Requiere **Bearer Token** válido\n- Filtra por empresa del token (excepto ALL/ALL)\n- Valida certificado digital vigente\n- Verifica estado activo de la empresa" }, "response": [] } ] }, { "name": "Nomina", "item": [ { "name": "Sendpayroll-TestSetId Sencilla", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"type_document_id\": 9,\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"CLL 11 NRO 21-73 BRR LA CABAÑA\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"establishment_email\": \"alternate_email@alternate.com\",\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"novelty\": {\r\n \"novelty\": false,\r\n \"uuidnov\": \"\"\r\n },\r\n \"period\": {\r\n \"admision_date\": \"2025-01-01\",\r\n \"settlement_start_date\": \"2025-09-01\",\r\n \"settlement_end_date\": \"2025-09-30\",\r\n \"worked_time\": 1735,\r\n \"issue_date\": \"2025-10-31\"\r\n },\r\n \"worker_code\": \"41946692\",\r\n \"prefix\": \"NI\",\r\n \"consecutive\": 6,\r\n \"payroll_period_id\": 4,\r\n \"notes\": \"PRUEBA DE ENVIO DE NOMINA ELECTRONICA\",\r\n \"worker\": {\r\n \"type_worker_id\": 1,\r\n \"sub_type_worker_id\": 1,\r\n \"payroll_type_document_identification_id\": 1,\r\n \"municipality_id\": 822,\r\n \"type_contract_id\": 1,\r\n \"high_risk_pension\": false,\r\n \"identification_number\": 41946692,\r\n \"surname\": \"CARDONA\",\r\n \"second_surname\": \"VILLADA\",\r\n \"first_name\": \"ELIZABETH\",\r\n \"address\": \"BRR LIMONAR MZ 6 CS 3 ET 1\",\r\n \"integral_salarary\": false,\r\n \"salary\": \"1500000.00\"\r\n },\r\n \"payment\": {\r\n \"payment_method_id\": 10,\r\n \"bank_name\": \"BANCO DAVIVIENDA\",\r\n \"account_type\": \"AHORROS\",\r\n \"account_number\": \"126070603280\"\r\n },\r\n \"payment_dates\": [{\r\n \"payment_date\": \"2025-09-15\"\r\n }, {\r\n \"payment_date\": \"2025-09-30\"\r\n }\r\n ],\r\n \"accrued\": {\r\n \"worked_days\": 30,\r\n \"salary\": \"750000.00\",\r\n \"transportation_allowance\": \"109000.00\",\r\n \"HEDs\": [{\r\n \"start_time\": \"2025-10-01T18:00:00\",\r\n \"end_time\": \"2025-10-01T19:00:00\",\r\n \"quantity\": 1,\r\n \"percentage\": 1,\r\n \"payment\": \"7812.50\"\r\n }, {\r\n \"start_time\": \"2025-10-02T18:00:00\",\r\n \"end_time\": \"2025-10-02T19:00:00\",\r\n \"quantity\": 1,\r\n \"percentage\": 1,\r\n \"payment\": \"7812.50\"\r\n }\r\n ],\r\n \"HENs\": [{\r\n \"start_time\": \"2025-10-01T21:00:00\",\r\n \"end_time\": \"2025-10-01T22:00:00\",\r\n \"quantity\": 1,\r\n \"percentage\": 2,\r\n \"payment\": \"10937.50\"\r\n }\r\n ],\r\n \"HRNs\": [{\r\n \"start_time\": \"2025-10-01T21:00:00\",\r\n \"end_time\": \"2025-10-01T22:00:00\",\r\n \"quantity\": 1,\r\n \"percentage\": 3,\r\n \"payment\": \"8437.50\"\r\n }, {\r\n \"start_time\": \"2025-10-02T21:00:00\",\r\n \"end_time\": \"2025-10-02T22:00:00\",\r\n \"quantity\": 1,\r\n \"percentage\": 3,\r\n \"payment\": \"8437.50\"\r\n }\r\n ],\r\n \"HEDDFs\": [{\r\n \"start_time\": \"2025-10-01T21:00:00\",\r\n \"end_time\": \"2025-10-01T22:00:00\",\r\n \"quantity\": 1,\r\n \"percentage\": 4,\r\n \"payment\": \"12500.00\"\r\n }\r\n ],\r\n \"HRDDFs\": [{\r\n \"start_time\": \"2025-10-01T16:00:00\",\r\n \"end_time\": \"2025-10-01T17:00:00\",\r\n \"quantity\": 1,\r\n \"percentage\": 5,\r\n \"payment\": \"10937.50\"\r\n }, {\r\n \"start_time\": \"2025-10-02T16:00:00\",\r\n \"end_time\": \"2025-10-02T17:00:00\",\r\n \"quantity\": 1,\r\n \"percentage\": 5,\r\n \"payment\": \"10937.50\"\r\n }\r\n ],\r\n \"HENDFs\": [{\r\n \"start_time\": \"2025-10-01T21:00:00\",\r\n \"end_time\": \"2025-10-01T22:00:00\",\r\n \"quantity\": 1,\r\n \"percentage\": 6,\r\n \"payment\": \"15625.00\"\r\n }\r\n ],\r\n \"HRNDFs\": [{\r\n \"start_time\": \"2025-10-01T21:00:00\",\r\n \"end_time\": \"2025-10-01T22:00:00\",\r\n \"quantity\": 1,\r\n \"percentage\": 7,\r\n \"payment\": \"13125.00\"\r\n }\r\n ],\r\n \"common_vacation\": [{\r\n \"start_date\": \"2025-10-01\",\r\n \"end_date\": \"2025-10-10\",\r\n \"quantity\": 10,\r\n \"payment\": \"500000.00\"\r\n }\r\n ],\r\n \"paid_vacation\": [{\r\n \"quantity\": 5,\r\n \"payment\": \"250000.00\"\r\n }\r\n ],\r\n \"service_bonus\": [{\r\n \"quantity\": 365,\r\n \"payment\": \"1500000.00\",\r\n \"paymentNS\": \"250000.00\"\r\n }\r\n ],\r\n \"severance\": [{\r\n \"payment\": \"1500000.00\",\r\n \"percentage\": \"12\",\r\n \"interest_payment\": \"180000.00\"\r\n }\r\n ],\r\n \"work_disabilities\": [{\r\n \"start_date\": \"2025-10-05\",\r\n \"end_date\": \"2025-10-10\",\r\n \"type\": 3,\r\n \"quantity\": 5,\r\n \"payment\": \"250000.00\"\r\n }, {\r\n \"start_date\": \"2025-10-11\",\r\n \"end_date\": \"2025-10-15\",\r\n \"type\": 3,\r\n \"quantity\": 5,\r\n \"payment\": \"250000.00\"\r\n }\r\n ],\r\n \"maternity_leave\": [{\r\n \"start_date\": \"2025-10-11\",\r\n \"end_date\": \"2025-10-15\",\r\n \"quantity\": 5,\r\n \"payment\": \"250000.00\"\r\n }\r\n ],\r\n \"paid_leave\": [{\r\n \"start_date\": \"2025-10-11\",\r\n \"end_date\": \"2025-10-15\",\r\n \"quantity\": 5,\r\n \"payment\": \"250000.00\"\r\n }\r\n ],\r\n \"non_paid_leave\": [{\r\n \"start_date\": \"2025-10-11\",\r\n \"end_date\": \"2025-10-15\",\r\n \"quantity\": 5\r\n }\r\n ],\r\n \"bonuses\": [{\r\n \"salary_bonus\": \"100000.00\"\r\n }, {\r\n \"salary_bonus\": \"95000.00\",\r\n \"non_salary_bonus\": \"50000.00\"\r\n }\r\n ],\r\n \"aid\": [{\r\n \"salary_assistance\": \"95000.00\",\r\n \"non_salary_assistance\": \"50000.00\"\r\n }\r\n ],\r\n \"legal_strike\": [{\r\n \"start_date\": \"2025-10-01\",\r\n \"end_date\": \"2025-10-10\",\r\n \"quantity\": 10\r\n }\r\n ],\r\n \"other_concepts\": [{\r\n \"salary_concept\": \"35000\",\r\n \"non_salary_concept\": \"50000\",\r\n \"description_concept\": \"INGRESO POR OTROS CONCEPTOS\"\r\n }\r\n ],\r\n \"compensations\": [{\r\n \"ordinary_compensation\": \"135000\",\r\n \"extraordinary_compensation\": \"250000\"\r\n }\r\n ],\r\n \"epctv_bonuses\": [{\r\n \"paymentS\": \"135000\",\r\n \"paymentNS\": \"250000\",\r\n \"salary_food_payment\": \"135000\",\r\n \"non_salary_food_payment\": \"250000\"\r\n }\r\n ],\r\n \"commissions\": [{\r\n \"commission\": \"135000\"\r\n }, {\r\n \"commission\": \"155000\"\r\n }\r\n ],\r\n \"third_party_payments\": [{\r\n \"third_party_payment\": \"155000\"\r\n }\r\n ],\r\n \"advances\": [{\r\n \"advance\": \"135000\"\r\n }, {\r\n \"advance\": \"50000\"\r\n }\r\n ],\r\n \"endowment\": \"250000.00\",\r\n \"sustenance_support\": \"1350000.00\",\r\n \"telecommuting\": \"250000.00\",\r\n \"withdrawal_bonus\": \"250000.00\",\r\n \"compensation\": \"135000.00\",\r\n \"accrued_total\": \"5145562.50\"\r\n },\r\n \"deductions\": {\r\n \"eps_type_law_deductions_id\": 1,\r\n \"eps_deduction\": \"60000.00\",\r\n \"pension_type_law_deductions_id\": 5,\r\n \"pension_deduction\": \"60000.00\",\r\n \"fondossp_type_law_deductions_id\": 9,\r\n \"fondosp_deduction_SP\": \"100000.00\",\r\n \"fondossp_sub_type_law_deductions_id\": 9,\r\n \"fondosp_deduction_sub\": \"50000.00\",\r\n \"labor_union\": [{\r\n \"percentage\": \"2.00\",\r\n \"deduction\": \"30000.00\"\r\n }\r\n ],\r\n \"sanctions\": [{\r\n \"public_sanction\": \"300000.00\",\r\n \"private_sanction\": \"130000.00\"\r\n }\r\n ],\r\n \"orders\": [{\r\n \"description\": \"LIBRANZA POR PEDIDO NRO 34256 GRUPO EXITO\",\r\n \"deduction\": \"13000.00\"\r\n }\r\n ],\r\n \"third_party_payments\": [{\r\n \"third_party_payment\": \"155000\"\r\n }, {\r\n \"third_party_payment\": \"59000\"\r\n }\r\n ],\r\n \"advances\": [{\r\n \"advance\": \"255000\"\r\n }, {\r\n \"advance\": \"79000\"\r\n }\r\n ],\r\n \"other_deductions\": [{\r\n \"other_deduction\": \"133000\"\r\n }\r\n ],\r\n \"voluntary_pension\": \"158000.00\",\r\n \"withholding_at_source\": \"65000.00\",\r\n \"afc\": \"33500.00\",\r\n \"cooperative\": \"25000.00\",\r\n \"tax_liens\": \"38500.00\",\r\n \"supplementary_plan\": \"65000.00\",\r\n \"education\": \"59000.00\",\r\n \"refund\": \"47000.00\",\r\n \"debt\": \"39000\",\r\n \"deductions_total\": \"120000.00\"\r\n }\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/payroll/38490179-23a6-4ce5-b7ec-7fb92588b3e6", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "payroll", "38490179-23a6-4ce5-b7ec-7fb92588b3e6" ] }, "description": "# 💼 NOMINA ELECTRONICA INDIVIDUAL\n\n## 📄 Descripción General\n\nEste ejemplo demuestra el **primer envío de Nómina Electrónica Individual** (`type_document_id: 9`) para documentar el pago de salarios, prestaciones y deducciones de un trabajador en un período específico.\n\nLa nómina electrónica es un documento que soporta el pago de salarios y prestaciones sociales a trabajadores, obligatorio desde agosto de 2020 según la Resolución 000013 de 2021 de la DIAN.\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/payroll/{{testSetId}}\n```\n\n**Características del Endpoint:**\n- **Modo**: Solo asíncrono (testSetId obligatorio)\n- **Autenticación**: Bearer token en header\n- **Content-Type**: application/json\n- **Controlador**: `PayrollController@store`\n- **Validación**: `PayrollRequest`\n- **Tabla**: `documents` (type_document_id = 9)\n\n---\n\n## 🔑 Campos Principales del Ejemplo\n\n### Datos de la Nómina\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **type_document_id** | 9 | Nómina Electrónica Individual |\n| **prefix** | NI | Prefijo autorizado para nómina individual |\n| **consecutive** | 6 | Número consecutivo de la nómina |\n| **worker_code** | 41946692 | Código identificador del trabajador |\n| **payroll_period_id** | 4 | ID del período de pago (mensual) |\n| **notes** | PRUEBA DE ENVIO... | Observaciones de la nómina |\n\n### Período de Liquidación (period)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **admision_date** | 2025-01-01 | Fecha de ingreso del trabajador |\n| **settlement_start_date** | 2025-09-01 | Inicio del período de liquidación |\n| **settlement_end_date** | 2025-09-30 | Fin del período de liquidación |\n| **worked_time** | 1735 | Tiempo trabajado en horas |\n| **issue_date** | 2025-10-31 | Fecha de emisión de la nómina |\n\n---\n\n## 🏢 Datos del Trabajador (worker)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **identification_number** | 41946692 | Cédula del trabajador |\n| **first_name** | ELIZABETH | Primer nombre |\n| **surname** | CARDONA | Primer apellido |\n| **second_surname** | VILLADA | Segundo apellido |\n| **address** | BRR LIMONAR MZ 6... | Dirección residencia |\n| **municipality_id** | 822 | ID del municipio |\n| **type_worker_id** | 1 | Tipo de trabajador (empleado) |\n| **sub_type_worker_id** | 1 | Subtipo de trabajador |\n| **type_contract_id** | 1 | Tipo de contrato laboral |\n| **payroll_type_document_identification_id** | 1 | Tipo documento (CC) |\n| **salary** | 1.500.000,00 | Salario mensual base |\n| **integral_salarary** | false | No es salario integral |\n| **high_risk_pension** | false | No cotiza pensión alto riesgo |\n\n---\n\n## 💰 Devengos - Accrued (Ingresos del Trabajador)\n\n### Conceptos Básicos\n\n| Concepto | Valor | Descripción |\n|----------|-------|-------------|\n| **worked_days** | 30 | Días trabajados en el período |\n| **salary** | 750.000,00 | Salario base del período |\n| **transportation_allowance** | 109.000,00 | Auxilio de transporte |\n| **endowment** | 250.000,00 | Dotación |\n| **sustenance_support** | 1.350.000,00 | Apoyo de sostenimiento |\n| **telecommuting** | 250.000,00 | Teletrabajo |\n| **withdrawal_bonus** | 250.000,00 | Bonificación de retiro |\n| **compensation** | 135.000,00 | Indemnización |\n\n### Horas Extras\n\n| Tipo | Cantidad | Porcentaje | Pago Total |\n|------|----------|------------|------------|\n| **HEDs** (Extras Diurnas) | 2 horas | 25% | 15.625,00 |\n| **HENs** (Extras Nocturnas) | 1 hora | 75% | 10.937,50 |\n| **HRNs** (Recargo Nocturno) | 2 horas | 35% | 16.875,00 |\n| **HEDDFs** (Extras Diurnas Festivas) | 1 hora | 100% | 12.500,00 |\n| **HRDDFs** (Recargo Diurno Festivo) | 2 horas | 75% | 21.875,00 |\n| **HENDFs** (Extras Nocturnas Festivas) | 1 hora | 150% | 15.625,00 |\n| **HRNDFs** (Recargo Nocturno Festivo) | 1 hora | 110% | 13.125,00 |\n\n### Vacaciones y Prestaciones\n\n| Concepto | Cantidad/Días | Pago |\n|----------|---------------|------|\n| **common_vacation** | 10 días | 500.000,00 |\n| **paid_vacation** | 5 días | 250.000,00 |\n| **service_bonus** | 365 días | 1.500.000,00 (S) + 250.000,00 (NS) |\n| **severance** | - | 1.500.000,00 + 180.000,00 (intereses) |\n\n### Incapacidades y Licencias\n\n| Concepto | Días | Pago |\n|----------|------|------|\n| **work_disabilities** | 10 días (2 períodos) | 500.000,00 |\n| **maternity_leave** | 5 días | 250.000,00 |\n| **paid_leave** | 5 días | 250.000,00 |\n| **non_paid_leave** | 5 días | 0,00 (sin pago) |\n| **legal_strike** | 10 días | 0,00 (sin pago) |\n\n### Otros Devengos\n\n| Concepto | Pago Total |\n|----------|------------|\n| **bonuses** (Bonificaciones) | 195.000,00 (S) + 50.000,00 (NS) |\n| **aid** (Auxilios) | 95.000,00 (S) + 50.000,00 (NS) |\n| **commissions** (Comisiones) | 290.000,00 |\n| **third_party_payments** | 155.000,00 |\n| **advances** (Anticipos devengados) | 185.000,00 |\n| **other_concepts** | 35.000,00 (S) + 50.000,00 (NS) |\n| **compensations** | 385.000,00 |\n| **epctv_bonuses** | 770.000,00 |\n\n### Total Devengado\n\n| **ACCRUED_TOTAL** | **5.145.562,50** |\n|-------------------|------------------|\n\n---\n\n## 📊 Deducciones - Deductions (Descuentos al Trabajador)\n\n### Deducciones de Ley\n\n| Concepto | ID/Tipo | Valor | Descripción |\n|----------|---------|-------|-------------|\n| **eps_deduction** | 1 | 60.000,00 | Salud (EPS) - 4% |\n| **pension_deduction** | 5 | 60.000,00 | Pensión - 4% |\n| **fondosp_deduction_SP** | 9 | 100.000,00 | Fondo solidaridad pensional |\n| **fondosp_deduction_sub** | 9 | 50.000,00 | Fondo solidaridad subsistencia |\n\n### Otras Deducciones\n\n| Concepto | Valor | Descripción |\n|----------|-------|-------------|\n| **labor_union** | 30.000,00 | Sindicato (2%) |\n| **sanctions** | 430.000,00 | Sanciones públicas + privadas |\n| **orders** | 13.000,00 | Libranzas (GRUPO EXITO) |\n| **third_party_payments** | 214.000,00 | Pagos a terceros |\n| **advances** | 334.000,00 | Anticipos descontados |\n| **other_deductions** | 133.000,00 | Otras deducciones |\n| **voluntary_pension** | 158.000,00 | Pensión voluntaria |\n| **withholding_at_source** | 65.000,00 | Retención en la fuente |\n| **afc** | 33.500,00 | Ahorro AFC |\n| **cooperative** | 25.000,00 | Cooperativa |\n| **tax_liens** | 38.500,00 | Embargos fiscales |\n| **supplementary_plan** | 65.000,00 | Plan complementario |\n| **education** | 59.000,00 | Educación |\n| **refund** | 47.000,00 | Reintegros |\n| **debt** | 39.000,00 | Deudas |\n\n### Total Deducciones\n\n| **DEDUCTIONS_TOTAL** | **120.000,00** |\n|----------------------|----------------|\n\n---\n\n## 🧮 Cálculo Neto a Pagar\n\n| Concepto | Valor |\n|----------|-------|\n| **Total Devengado** | 5.145.562,50 |\n| **Total Deducciones** | (120.000,00) |\n| **NETO A PAGAR** | **5.025.562,50** |\n\n---\n\n## 💳 Forma de Pago (payment)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **payment_method_id** | 10 | Transferencia bancaria |\n| **bank_name** | BANCO DAVIVIENDA | Entidad bancaria |\n| **account_type** | AHORROS | Tipo de cuenta |\n| **account_number** | 126070603280 | Número de cuenta del trabajador |\n\n### Fechas de Pago\n\n| Fecha | Descripción |\n|-------|-------------|\n| **2025-09-15** | Primer pago (anticipo) |\n| **2025-09-30** | Segundo pago (liquidación final) |\n\n---\n\n## 📝 Notas Importantes sobre Nómina Individual\n\n### 📌 1. Diferencia con Facturas Electrónicas\nLa nómina electrónica usa **CUNE** (Código Único de Nómina Electrónica), NO **CUFE**. El documento se registra en la tabla `documents` con `type_document_id = 9`, pero el procesamiento y estructura XML son completamente diferentes a las facturas.\n\n### 📌 2. Modo Asíncrono Obligatorio\nA diferencia de las facturas, las nóminas **solo se pueden enviar en modo asíncrono**. El `testSetId` es **obligatorio** en la URL. No existe la opción de envío síncrono para nóminas.\n\n### 📌 3. Plazo de Envío a la DIAN\nLa nómina electrónica debe transmitirse a la DIAN dentro de los **3 días hábiles** siguientes a la fecha de pago al trabajador, según la Resolución 000013 de 2021.\n\n### 📌 4. Componentes del JSON de Nómina\nUna nómina individual completa contiene 4 bloques principales:\n- **period**: Fechas del período de liquidación\n- **worker**: Datos completos del empleado\n- **accrued**: Todos los devengos (salarios, horas extras, prestaciones)\n- **deductions**: Todas las deducciones (salud, pensión, retenciones, libranzas)\n\n### 📌 5. Validación de Totales\nLa API valida que `accrued_total` coincida con la suma de todos los devengos, y `deductions_total` con la suma de todas las deducciones. Si no cuadran, la nómina será rechazada.\n\n### 📌 6. Tipos de Horas Extras\nExisten 7 tipos de horas extras en Colombia:\n- **HED**: Extra diurna (25%)\n- **HEN**: Extra nocturna (75%)\n- **HRN**: Recargo nocturno (35%)\n- **HEDDF**: Extra diurna dominical/festiva (100%)\n- **HRDDF**: Recargo diurno dominical/festiva (75%)\n- **HENDF**: Extra nocturna dominical/festiva (150%)\n- **HRNDF**: Recargo nocturno dominical/festiva (110%)\n\nCada tipo debe incluir: `start_time`, `end_time`, `quantity`, `percentage`, `payment`.\n\n### 📌 7. Deducciones Obligatorias de Ley\nTodo empleado debe tener mínimo dos deducciones:\n- **Salud (EPS)**: 4% del salario base\n- **Pensión**: 4% del salario base\n\nEstas deducciones requieren Especificar el `eps_type_law_deductions_id` y `pension_type_law_deductions_id` correspondientes.\n\n### 📌 8. Salario Integral vs Ordinario\nEl campo `integral_salarary` determina el tipo de salario:\n- **false**: Salario ordinario (aplican todas las prestaciones)\n- **true**: Salario integral (no aplican cesantías, primas, etc.)\n\nEn Colombia, el salario integral debe ser mínimo 10 SMMLV.\n\n### 📌 9. Novelty (Novedades)\nEl objeto `novelty` indica si la nómina tiene novedades o correcciones:\n- `novelty: false`: Nómina normal\n- `novelty: true`: Nómina con novedad, debe incluir `uuidnov` (UUID de la novedad)\n\n### 📌 10. Prefijos Autorizados\nLos prefijos comunes para nómina individual son:\n- **NI**: Nómina Individual\n- **NIM**: Nómina Individual Mensual\n- **NIQ**: Nómina Individual Quincenal\n\nDeben estar habilitados en el software de nómina (Paso 8 - Config Payroll Software).\n\n### 📌 11. Email al Trabajador\nLa nómina se envía por email al trabajador (no al cliente como en facturas). El email del empleado debe estar registrado en el sistema de nómina. Los campos `sendmail` y `sendmailtome` NO aplican para nóminas.\n\n### 📌 12. Consulta de Estado con zip_key\nAl ser asíncrono, la respuesta incluye un `zip_key`. Debe consultarse el resultado con:\n```\nPOST /api/ubl2.1/status/zip\n{\n \"zip_key\": \"valor_retornado\"\n}\n```\nEsto devolverá el CUNE, PDF y XML de la nómina una vez procesada por la DIAN.\n\n### 📌 13. Configuración Previa Requerida\nAntes de enviar nóminas, debe completarse:\n- **Paso 7**: Environment Software (Payroll)\n- **Paso 8**: Config Payroll Software\n- **Paso 9**: Resolution Payroll (resolución de autorización DIAN)\n\nSin esta configuración, las nóminas serán rechazadas.\n\n### 📌 14. Prestaciones Sociales\nLas prestaciones sociales incluyen:\n- **Prima de servicios** (`service_bonus`): Pagada en junio y diciembre\n- **Cesantías** (`severance`): Liquidadas anualmente\n- **Intereses sobre cesantías**: 12% anual sobre las cesantías\n- **Vacaciones**: 15 días por año trabajado\n\nCada una debe calcularse según la normativa laboral colombiana (Código Sustantivo del Trabajo).\n\n### 📌 15. Periodo de Liquidación\nEl `payroll_period_id` determina la frecuencia:\n- **1**: Semanal\n- **2**: Decenal (cada 10 días)\n- **3**: Catorcenal (cada 14 días)\n- **4**: Quincenal\n- **5**: Mensual\n\nEl período debe coincidir con lo pactado en el contrato laboral." }, "response": [] }, { "name": "SendpayrollNoteReemplazar-TestSetId Sencilla", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"type_document_id\": 10,\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"CLL 11 NRO 21-73 BRR LA CABAÑA\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"establishment_email\": \"alternate_email@alternate.com\",\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"type_note\": 1,\r\n \"predecessor\": {\r\n \"predecessor_number\": 5,\r\n \"predecessor_cune\": \"3c9596d08f883c780b8e02205549328da4edc71befa9de3737de39ad7679dbf43b526b8bca1e35b7a8a2624f987edada\",\r\n \"predecessor_issue_date\": \"2025-10-31\"\r\n },\r\n \"period\": {\r\n \"admision_date\": \"2025-01-01\",\r\n \"settlement_start_date\": \"2025-09-01\",\r\n \"settlement_end_date\": \"2025-09-30\",\r\n \"worked_time\": 1735,\r\n \"issue_date\": \"2025-10-31\"\r\n },\r\n \"worker_code\": \"41946692\",\r\n \"prefix\": \"NA\",\r\n \"consecutive\": 2,\r\n \"payroll_period_id\": 4,\r\n \"notes\": \"PRUEBA DE ENVIO DE NOMINA ELECTRONICA\",\r\n \"worker\": {\r\n \"type_worker_id\": 1,\r\n \"sub_type_worker_id\": 1,\r\n \"payroll_type_document_identification_id\": 1,\r\n \"municipality_id\": 822,\r\n \"type_contract_id\": 1,\r\n \"high_risk_pension\": false,\r\n \"identification_number\": 41946692,\r\n \"surname\": \"CARDONA\",\r\n \"second_surname\": \"VILLADA\",\r\n \"first_name\": \"ELIZABETH\",\r\n \"address\": \"BRR LIMONAR MZ 6 CS 3 ET 1\",\r\n \"integral_salarary\": false,\r\n \"salary\": \"1500000.00\"\r\n },\r\n \"payment\": {\r\n \"payment_method_id\": 10,\r\n \"bank_name\": \"BANCO DAVIVIENDA\",\r\n \"account_type\": \"AHORROS\",\r\n \"account_number\": \"126070603280\"\r\n },\r\n \"payment_dates\": [\r\n {\r\n \"payment_date\": \"2025-10-01\"\r\n },\r\n {\r\n \"payment_date\": \"2025-10-30\"\r\n }\r\n ],\r\n \"accrued\": {\r\n \"worked_days\": 30,\r\n \"salary\": \"750000.00\",\r\n \"transportation_allowance\": \"109000.00\",\r\n \"HEDs\": [\r\n {\r\n \"start_time\": \"2025-10-01T18:00:00\",\r\n \"end_time\": \"2025-10-01T19:00:00\",\r\n \"quantity\": 1,\r\n \"percentage\": 1,\r\n \"payment\": \"7812.50\"\r\n },\r\n {\r\n \"start_time\": \"2025-10-02T18:00:00\",\r\n \"end_time\": \"2025-10-02T19:00:00\",\r\n \"quantity\": 1,\r\n \"percentage\": 1,\r\n \"payment\": \"7812.50\"\r\n }\r\n ],\r\n \"HENs\": [\r\n {\r\n \"start_time\": \"2025-10-01T21:00:00\",\r\n \"end_time\": \"2025-10-01T22:00:00\",\r\n \"quantity\": 1,\r\n \"percentage\": 2,\r\n \"payment\": \"10937.50\"\r\n }\r\n ],\r\n \"HRNs\": [\r\n {\r\n \"start_time\": \"2025-10-01T21:00:00\",\r\n \"end_time\": \"2025-10-01T22:00:00\",\r\n \"quantity\": 1,\r\n \"percentage\": 3,\r\n \"payment\": \"8437.50\"\r\n },\r\n {\r\n \"start_time\": \"2025-10-02T21:00:00\",\r\n \"end_time\": \"2025-10-02T22:00:00\",\r\n \"quantity\": 1,\r\n \"percentage\": 3,\r\n \"payment\": \"8437.50\"\r\n }\r\n ],\r\n \"HEDDFs\": [\r\n {\r\n \"start_time\": \"2025-10-01T21:00:00\",\r\n \"end_time\": \"2025-10-01T22:00:00\",\r\n \"quantity\": 1,\r\n \"percentage\": 4,\r\n \"payment\": \"12500.00\"\r\n }\r\n ],\r\n \"HRDDFs\": [\r\n {\r\n \"start_time\": \"2025-10-01T16:00:00\",\r\n \"end_time\": \"2025-10-01T17:00:00\",\r\n \"quantity\": 1,\r\n \"percentage\": 5,\r\n \"payment\": \"10937.50\"\r\n },\r\n {\r\n \"start_time\": \"2025-10-02T16:00:00\",\r\n \"end_time\": \"2025-10-02T17:00:00\",\r\n \"quantity\": 1,\r\n \"percentage\": 5,\r\n \"payment\": \"10937.50\"\r\n }\r\n ],\r\n \"HENDFs\": [\r\n {\r\n \"start_time\": \"2025-10-01T21:00:00\",\r\n \"end_time\": \"2025-10-01T22:00:00\",\r\n \"quantity\": 1,\r\n \"percentage\": 6,\r\n \"payment\": \"15625.00\"\r\n }\r\n ],\r\n \"HRNDFs\": [\r\n {\r\n \"start_time\": \"2025-10-01T21:00:00\",\r\n \"end_time\": \"2025-10-01T22:00:00\",\r\n \"quantity\": 1,\r\n \"percentage\": 7,\r\n \"payment\": \"13125.00\"\r\n }\r\n ],\r\n \"common_vacation\": [\r\n {\r\n \"start_date\": \"2025-10-01\",\r\n \"end_date\": \"2025-10-10\",\r\n \"quantity\": 10,\r\n \"payment\": \"500000.00\"\r\n }\r\n ],\r\n \"paid_vacation\": [\r\n {\r\n \"quantity\": 5,\r\n \"payment\": \"250000.00\"\r\n }\r\n ],\r\n \"service_bonus\": [\r\n {\r\n \"quantity\": 365,\r\n \"payment\": \"1500000.00\",\r\n \"paymentNS\": \"250000.00\"\r\n }\r\n ],\r\n \"severance\": [\r\n {\r\n \"payment\": \"1500000.00\",\r\n \"percentage\": \"12\",\r\n \"interest_payment\": \"180000.00\"\r\n }\r\n ],\r\n \"work_disabilities\": [\r\n {\r\n \"start_date\": \"2025-10-05\",\r\n \"end_date\": \"2025-10-10\",\r\n \"type\": 3,\r\n \"quantity\": 5,\r\n \"payment\": \"250000.00\"\r\n },\r\n {\r\n \"start_date\": \"2025-10-11\",\r\n \"end_date\": \"2025-10-15\",\r\n \"type\": 3,\r\n \"quantity\": 5,\r\n \"payment\": \"250000.00\"\r\n }\r\n ],\r\n \"maternity_leave\": [\r\n {\r\n \"start_date\": \"2025-10-11\",\r\n \"end_date\": \"2025-10-15\",\r\n \"quantity\": 5,\r\n \"payment\": \"250000.00\"\r\n }\r\n ],\r\n \"paid_leave\": [\r\n {\r\n \"start_date\": \"2025-10-11\",\r\n \"end_date\": \"2025-10-15\",\r\n \"quantity\": 5,\r\n \"payment\": \"250000.00\"\r\n }\r\n ],\r\n \"non_paid_leave\": [\r\n {\r\n \"start_date\": \"2025-10-11\",\r\n \"end_date\": \"2025-10-15\",\r\n \"quantity\": 5\r\n }\r\n ],\r\n \"bonuses\": [\r\n {\r\n \"salary_bonus\": \"100000.00\"\r\n },\r\n {\r\n \"salary_bonus\": \"95000.00\",\r\n \"non_salary_bonus\": \"50000.00\"\r\n }\r\n ],\r\n \"aid\": [\r\n {\r\n \"salary_assistance\": \"95000.00\",\r\n \"non_salary_assistance\": \"50000.00\"\r\n }\r\n ],\r\n \"legal_strike\": [\r\n {\r\n \"start_date\": \"2025-10-01\",\r\n \"end_date\": \"2025-10-10\",\r\n \"quantity\": 10\r\n }\r\n ],\r\n \"other_concepts\": [\r\n {\r\n \"salary_concept\": \"35000\",\r\n \"non_salary_concept\": \"50000\",\r\n \"description_concept\": \"INGRESO POR OTROS CONCEPTOS\"\r\n }\r\n ],\r\n \"compensations\": [\r\n {\r\n \"ordinary_compensation\": \"135000\",\r\n \"extraordinary_compensation\": \"250000\"\r\n }\r\n ],\r\n \"epctv_bonuses\": [\r\n {\r\n \"paymentS\": \"135000\",\r\n \"paymentNS\": \"250000\",\r\n \"salary_food_payment\": \"135000\",\r\n \"non_salary_food_payment\": \"250000\"\r\n }\r\n ],\r\n \"commissions\": [\r\n {\r\n \"commission\": \"135000\"\r\n },\r\n {\r\n \"commission\": \"155000\"\r\n }\r\n ],\r\n \"third_party_payments\": [\r\n {\r\n \"third_party_payment\": \"155000\"\r\n }\r\n ],\r\n \"advances\": [\r\n {\r\n \"advance\": \"135000\"\r\n },\r\n {\r\n \"advance\": \"50000\"\r\n }\r\n ],\r\n \"endowment\": \"250000.00\",\r\n \"sustenance_support\": \"1350000.00\",\r\n \"telecommuting\": \"250000.00\",\r\n \"withdrawal_bonus\": \"250000.00\",\r\n \"compensation\": \"135000.00\",\r\n \"accrued_total\": \"5145562.50\"\r\n },\r\n \"deductions\": {\r\n \"eps_type_law_deductions_id\": 1,\r\n \"eps_deduction\": \"60000.00\",\r\n \"pension_type_law_deductions_id\": 5,\r\n \"pension_deduction\": \"60000.00\",\r\n \"labor_union\": [\r\n {\r\n \"percentage\": \"2.00\",\r\n \"deduction\": \"30000.00\"\r\n }\r\n ],\r\n \"sanctions\": [\r\n {\r\n \"public_sanction\": \"300000.00\",\r\n \"private_sanction\": \"130000.00\"\r\n }\r\n ],\r\n \"orders\": [\r\n {\r\n \"description\": \"LIBRANZA POR PEDIDO NRO 34256 GRUPO EXITO\",\r\n \"deduction\": \"13000.00\"\r\n }\r\n ],\r\n \"third_party_payments\": [\r\n {\r\n \"third_party_payment\": \"155000\"\r\n },\r\n {\r\n \"third_party_payment\": \"59000\"\r\n }\r\n ],\r\n \"advances\": [\r\n {\r\n \"advance\": \"255000\"\r\n },\r\n {\r\n \"advance\": \"79000\"\r\n }\r\n ],\r\n \"other_deductions\": [\r\n {\r\n \"other_deduction\": \"133000\"\r\n }\r\n ],\r\n \"voluntary_pension\": \"158000.00\",\r\n \"withholding_at_source\": \"65000.00\",\r\n \"afc\": \"33500.00\",\r\n \"cooperative\": \"25000.00\",\r\n \"tax_liens\": \"38500.00\",\r\n \"supplementary_plan\": \"65000.00\",\r\n \"education\": \"59000.00\",\r\n \"refund\": \"47000.00\",\r\n \"debt\": \"39000\",\r\n \"deductions_total\": \"120000.00\"\r\n }\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/payroll-adjust-note/38490179-23a6-4ce5-b7ec-7fb92588b3e6", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "payroll-adjust-note", "38490179-23a6-4ce5-b7ec-7fb92588b3e6" ] }, "description": "# 🔄 NOTA DE AJUSTE DE NOMINA - REEMPLAZAR\n\n## 📄 Descripción General\n\nEste ejemplo demuestra cómo emitir una **Nota de Ajuste de Nómina para Reemplazar** (`type_document_id: 10`, `type_note: 1`) una nómina individual previamente emitida con errores o datos incorrectos.\n\nLa Nota de Ajuste tipo **REEMPLAZAR** anula la nómina original y genera una nueva nómina completa con los datos corregidos. Este documento es obligatorio cuando se detectan errores en salarios, horas extras, deducciones o cualquier otro concepto de la nómina original.\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/payroll-adjust-note/{{testSetId}}\n```\n\n**Características del Endpoint:**\n- **Modo**: Solo asíncrono (testSetId obligatorio)\n- **Autenticación**: Bearer token en header\n- **Content-Type**: application/json\n- **Controlador**: `PayrollController@storeAdjustNote`\n- **Validación**: `PayrollAdjustNoteRequest`\n- **Tabla**: `documents` (type_document_id = 10)\n\n---\n\n## 🔑 Campos Principales del Ejemplo\n\n### Datos de la Nota de Ajuste\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **type_document_id** | 10 | Nota de Ajuste de Nómina |\n| **type_note** | 1 | **REEMPLAZAR** (genera nueva nómina corregida) |\n| **prefix** | NA | Prefijo para Nota de Ajuste |\n| **consecutive** | 2 | Número consecutivo de la nota |\n| **worker_code** | 41946692 | Código del trabajador (mismo de la original) |\n| **payroll_period_id** | 4 | Período de pago (mensual) |\n| **notes** | PRUEBA DE ENVIO... | Observaciones del ajuste |\n\n### Estructura predecessor (Nómina Original a Reemplazar)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **predecessor_number** | 5 | Número consecutivo de la nómina original |\n| **predecessor_cune** | 3c9596d08f883c780b8e... | CUNE completo de la nómina a reemplazar |\n| **predecessor_issue_date** | 2025-10-31 | Fecha de emisión de la nómina original |\n\n---\n\n## 🔐 type_note: Diferencia entre Reemplazar y Eliminar\n\n| type_note | Acción | Estructura Requerida |\n|-----------|--------|----------------------|\n| **1** (REEMPLAZAR) | Anula la nómina original y genera una nueva completa con datos corregidos | Debe incluir: `period`, `worker`, `accrued`, `deductions`, `payment`, `predecessor` |\n| **2** (ELIMINAR) | Anula la nómina original sin generar reemplazo | Solo requiere: `period`, `predecessor`, datos básicos (sin `accrued`/`deductions`) |\n\n**En este ejemplo (type_note: 1)**, se debe enviar una nómina completa con todos los campos corregidos, incluyendo devengos, deducciones, datos del trabajador y forma de pago.\n\n---\n\n## 🏢 Datos del Trabajador (worker)\n\nLos datos del trabajador deben ser **idénticos a la nómina original**, excepto los campos que se estén corrigiendo:\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **identification_number** | 41946692 | Cédula del trabajador |\n| **first_name** | ELIZABETH | Primer nombre |\n| **surname** | CARDONA | Primer apellido |\n| **second_surname** | VILLADA | Segundo apellido |\n| **address** | BRR LIMONAR MZ 6... | Dirección residencia |\n| **municipality_id** | 822 | ID del municipio |\n| **type_worker_id** | 1 | Tipo de trabajador (empleado) |\n| **sub_type_worker_id** | 1 | Subtipo de trabajador |\n| **type_contract_id** | 1 | Tipo de contrato laboral |\n| **salary** | 1.500.000,00 | Salario mensual base |\n| **integral_salarary** | false | No es salario integral |\n| **high_risk_pension** | false | No cotiza pensión alto riesgo |\n\n---\n\n## 💰 Devengos - Accrued (VALORES CORREGIDOS)\n\nEn este ejemplo, se corrigen los valores de devengos de la nómina original:\n\n### Conceptos Básicos Corregidos\n\n| Concepto | Valor Original | Valor Corregido | Diferencia |\n|----------|----------------|-----------------|------------|\n| **worked_days** | 30 | 30 | Sin cambio |\n| **salary** | 750.000,00 | 750.000,00 | Sin cambio |\n| **transportation_allowance** | 109.000,00 | 109.000,00 | Sin cambio |\n| **HEDs** (Extras Diurnas) | 15.625,00 | 15.625,00 | Sin cambio |\n| **HENs** (Extras Nocturnas) | 10.937,50 | 10.937,50 | Sin cambio |\n| **service_bonus** | 1.750.000,00 | 1.750.000,00 | Sin cambio |\n| **severance** | 1.680.000,00 | 1.680.000,00 | Sin cambio |\n| **bonuses** | 245.000,00 | 245.000,00 | Sin cambio |\n\n### Total Devengado\n\n| **ACCRUED_TOTAL** | **5.145.562,50** |\n|-------------------|------------------|\n\n---\n\n## 📊 Deducciones - Deductions (VALORES CORREGIDOS)\n\n### Deducciones de Ley\n\n| Concepto | Valor Original | Valor Corregido | Diferencia |\n|----------|----------------|-----------------|------------|\n| **eps_deduction** | 60.000,00 | 60.000,00 | Sin cambio |\n| **pension_deduction** | 60.000,00 | 60.000,00 | Sin cambio |\n| **labor_union** | 30.000,00 | 30.000,00 | Sin cambio |\n| **withholding_at_source** | 65.000,00 | 65.000,00 | Sin cambio |\n\n### Total Deducciones\n\n| **DEDUCTIONS_TOTAL** | **120.000,00** |\n|----------------------|----------------|\n\n---\n\n## 🧮 Comparación: Original vs Reemplazada\n\n| Concepto | Nómina Original (NI-5) | Nota de Ajuste (NA-2) | Diferencia |\n|----------|------------------------|------------------------|------------|\n| **Total Devengado** | 5.145.562,50 | 5.145.562,50 | 0,00 |\n| **Total Deducciones** | 120.000,00 | 120.000,00 | 0,00 |\n| **Neto a Pagar** | 5.025.562,50 | 5.025.562,50 | 0,00 |\n| **Estado DIAN** | Anulada por ajuste | Válida (reemplazo) | - |\n| **CUNE** | 3c9596d08f883c... | (Nuevo CUNE generado) | - |\n\n**Nota**: En este ejemplo de prueba, los valores son idénticos. En un caso real de ajuste, los valores corregidos serían diferentes de los originales.\n\n---\n\n## 💳 Forma de Pago (payment)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **payment_method_id** | 10 | Transferencia bancaria |\n| **bank_name** | BANCO DAVIVIENDA | Entidad bancaria |\n| **account_type** | AHORROS | Tipo de cuenta |\n| **account_number** | 126070603280 | Número de cuenta del trabajador |\n\n### Fechas de Pago Corregidas\n\n| Fecha | Descripción |\n|-------|-------------|\n| **2025-10-01** | Primer pago corregido |\n| **2025-10-30** | Segundo pago corregido |\n\n---\n\n## 📝 Notas Importantes sobre Notas de Ajuste - REEMPLAZAR\n\n### 📌 1. Cuándo Usar type_note = 1 (Reemplazar)\nUse **REEMPLAZAR** cuando necesite:\n- Corregir errores en cálculos de salarios o prestaciones\n- Ajustar valores de horas extras mal liquidadas\n- Corregir deducciones incorrectas (salud, pensión, retenciones)\n- Agregar conceptos omitidos en la nómina original\n- Corregir datos del trabajador (dirección, banco, cuenta)\n\n### 📌 2. Estructura predecessor Obligatoria\nToda Nota de Ajuste **DEBE** incluir el objeto `predecessor` con:\n- `predecessor_number`: Consecutivo de la nómina original\n- `predecessor_cune`: CUNE completo (96 caracteres) de la nómina original\n- `predecessor_issue_date`: Fecha de emisión de la nómina original\n\nSin estos datos, la DIAN rechazará la nota de ajuste.\n\n### 📌 3. Nueva Nómina Completa\nAl usar `type_note: 1`, debe enviar una nómina **completa** con:\n- Todos los campos de `accrued` (devengos corregidos)\n- Todos los campos de `deductions` (deducciones corregidas)\n- Estructura `worker` completa\n- Estructura `payment` completa\n- Estructura `period` (mismo período de la original)\n\n**No se pueden omitir secciones**. La DIAN considera esta nota como una nómina nueva que reemplaza la original.\n\n### 📌 4. Efecto en la Nómina Original\nCuando se aprueba una Nota de Ajuste REEMPLAZAR:\n- La nómina original cambia su estado a **\"ANULADA POR AJUSTE\"**\n- El CUNE original queda invalidado\n- Se genera un nuevo CUNE para la nómina de reemplazo\n- El trabajador recibe la nueva nómina por email\n- La diferencia de pago (si existe) debe gestionarse por nómina adicional\n\n### 📌 5. Plazo para Emitir Nota de Ajuste\nSegún la Resolución 000013 de 2021, las Notas de Ajuste pueden emitirse:\n- Durante el **mismo mes** de la nómina original, o\n- Hasta el **último día del mes siguiente**\n\nDespués de este plazo, debe coordinarse directamente con la DIAN.\n\n### 📌 6. Diferencia con Nómina de Eliminación\nNo confundir:\n- **type_note: 1 (REEMPLAZAR)**: Genera nueva nómina corregida (caso más común)\n- **type_note: 2 (ELIMINAR)**: Solo anula sin reemplazo (nómina duplicada o errónea)\n\n### 📌 7. Prefijo NA (Nota de Ajuste)\nLas Notas de Ajuste usan el prefijo **NA** (Nota de Ajuste), **NO** el prefijo NI (Nómina Individual) de la original. Este prefijo debe estar habilitado en el software de nómina.\n\n### 📌 8. Consecutivo Independiente\nLas Notas de Ajuste tienen su **propio consecutivo**, independiente del consecutivo de nóminas individuales:\n- Nómina Individual: NI-5, NI-6, NI-7...\n- Notas de Ajuste: NA-1, NA-2, NA-3...\n\n### 📌 9. Validación de accrued_total y deductions_total\nLa API valida que los totales cuadren:\n- `accrued_total` = suma de todos los devengos\n- `deductions_total` = suma de todas las deducciones\n\nSi los totales no coinciden, la nota de ajuste será rechazada.\n\n### 📌 10. Período Idéntico a la Original\nEl objeto `period` debe tener **las mismas fechas** que la nómina original:\n- `admision_date`: Igual\n- `settlement_start_date`: Igual\n- `settlement_end_date`: Igual\n- `issue_date`: **Puede ser diferente** (fecha de emisión de la nota)\n\nSolo cambia `issue_date`, que es la fecha de la nota de ajuste.\n\n### 📌 11. CUNE de la Nómina Original\nPara obtener el `predecessor_cune`, debe consultar la nómina original:\n- Usando el endpoint `/api/ubl2.1/status/document/{prefix}/{number}`\n- Desde la base de datos, tabla `documents`, campo `cufe` (en nóminas se llama CUNE pero se almacena en campo `cufe`)\n- Desde el PDF o XML de la nómina original\n\n### 📌 12. Modo Asíncrono Obligatorio\nAl igual que las nóminas individuales, las Notas de Ajuste **solo se envían en modo asíncrono**. El `testSetId` es obligatorio en la URL. La respuesta incluye un `zip_key` que debe consultarse con `/api/ubl2.1/status/zip`.\n\n### 📌 13. Email al Trabajador\nCuando la Nota de Ajuste es aprobada por la DIAN:\n- El trabajador recibe email con la nueva nómina (reemplazo)\n- El email debe incluir explicación del ajuste realizado\n- Se recomienda adjuntar ambos PDFs: original y ajustada\n\n### 📌 14. Diferencia de Pago\nSi la nómina de reemplazo tiene un **neto a pagar diferente** a la original:\n- **Mayor**: Debe pagarse la diferencia al trabajador\n- **Menor**: Debe descontarse la diferencia en nómina siguiente (con autorización del trabajador)\n\nEstas diferencias deben documentarse en el campo `notes` de la nota de ajuste.\n\n### 📌 15. Casos Comunes de Reemplazo\n- **Error en horas extras**: Se liquidaron HED (25%) en lugar de HEN (75%)\n- **Olvido de prestaciones**: No se incluyó prima de servicios o cesantías\n- **Deducción incorrecta**: Se descontó más salud/pensión del permitido (4%)\n- **Error en salario base**: Se usó salario incorrecto para cálculos\n- **Datos bancarios erróneos**: Se especificó cuenta bancaria incorrecta\n- **Días trabajados incorrectos**: Se liquidaron 30 días cuando fueron 28" }, "response": [] }, { "name": "SendpayrollNoteEliminar-TestSetId Sencilla", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"type_document_id\": 10,\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"CLL 11 NRO 21-73 BRR LA CABAÑA\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"establishment_email\": \"alternate_email@alternate.com\",\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"type_note\": 2,\r\n \"predecessor\": {\r\n \"predecessor_number\": 5,\r\n \"predecessor_cune\": \"3c9596d08f883c780b8e02205549328da4edc71befa9de3737de39ad7679dbf43b526b8bca1e35b7a8a2624f987edada\",\r\n \"predecessor_issue_date\": \"2025-10-31\"\r\n },\r\n \"period\":{\r\n \"admision_date\": \"2025-01-01\",\r\n \"settlement_start_date\": \"2025-09-01\",\r\n \"settlement_end_date\": \"2025-09-30\",\r\n \"worked_time\": 1735,\r\n \"issue_date\": \"2025-10-31\"\r\n },\r\n \"prefix\": \"NA\",\r\n \"consecutive\": 3,\r\n \"payroll_period_id\": 4,\r\n \"notes\": \"PRUEBA DE ENVIO DE NOMINA DE AJUSTE ELECTRONICA - ELIMINAR\"\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/payroll-adjust-note/38490179-23a6-4ce5-b7ec-7fb92588b3e6", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "payroll-adjust-note", "38490179-23a6-4ce5-b7ec-7fb92588b3e6" ] }, "description": "# ❌ NOTA DE AJUSTE DE NOMINA - ELIMINAR\n\n## 📄 Descripción General\n\nEste ejemplo demuestra cómo emitir una **Nota de Ajuste de Nómina para Eliminar** (`type_document_id: 10`, `type_note: 2`) una nómina individual previamente emitida que debe ser **anulada sin reemplazo**.\n\nLa Nota de Ajuste tipo **ELIMINAR** anula completamente la nómina original sin generar una nueva. Se usa cuando la nómina fue emitida por error, está duplicada, o no debe existir. A diferencia del tipo REEMPLAZAR, **NO** requiere estructura completa de devengos, deducciones ni datos del trabajador.\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/payroll-adjust-note/{{testSetId}}\n```\n\n**Características del Endpoint:**\n- **Modo**: Solo asíncrono (testSetId obligatorio)\n- **Autenticación**: Bearer token en header\n- **Content-Type**: application/json\n- **Controlador**: `PayrollController@storeAdjustNote`\n- **Validación**: `PayrollAdjustNoteRequest`\n- **Tabla**: `documents` (type_document_id = 10)\n\n---\n\n## 🔑 Campos Principales del Ejemplo\n\n### Datos de la Nota de Eliminación\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **type_document_id** | 10 | Nota de Ajuste de Nómina |\n| **type_note** | 2 | **ELIMINAR** (anula sin reemplazo) |\n| **prefix** | NA | Prefijo para Nota de Ajuste |\n| **consecutive** | 3 | Número consecutivo de la nota |\n| **payroll_period_id** | 4 | Período de pago (mensual) |\n| **notes** | PRUEBA DE ENVIO DE NOMINA... | Observaciones del ajuste |\n\n### Estructura predecessor (Nómina Original a Eliminar)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **predecessor_number** | 5 | Número consecutivo de la nómina original |\n| **predecessor_cune** | 3c9596d08f883c780b8e... | CUNE completo de la nómina a eliminar |\n| **predecessor_issue_date** | 2025-10-31 | Fecha de emisión de la nómina original |\n\n---\n\n## 🔐 type_note: 2 (ELIMINAR) - Estructura Simplificada\n\n### Campos Requeridos\n\n| Campo | ¿Requerido? | Descripción |\n|-------|-------------|-------------|\n| **type_document_id** | ✅ Sí | Siempre 10 |\n| **type_note** | ✅ Sí | Siempre 2 (Eliminar) |\n| **prefix** | ✅ Sí | Prefijo autorizado (NA) |\n| **consecutive** | ✅ Sí | Consecutivo de la nota |\n| **payroll_period_id** | ✅ Sí | Período de pago |\n| **notes** | ✅ Sí | Motivo de la eliminación |\n| **predecessor** | ✅ Sí | Datos de la nómina a eliminar |\n| **period** | ✅ Sí | Mismo período de la original |\n| **establishment_name** | ✅ Sí | Nombre del establecimiento |\n| **establishment_address** | ✅ Sí | Dirección del establecimiento |\n| **establishment_phone** | ✅ Sí | Teléfono del establecimiento |\n| **establishment_municipality** | ✅ Sí | ID del municipio |\n| **establishment_email** | ✅ Sí | Email del establecimiento |\n\n### Campos NO Requeridos (Omitidos)\n\n| Campo | ¿Requerido? | Razón |\n|-------|-------------|-------|\n| **worker_code** | ❌ No | No se requiere identificar trabajador |\n| **worker** | ❌ No | No se envía estructura de trabajador |\n| **accrued** | ❌ No | No se envían devengos |\n| **deductions** | ❌ No | No se envían deducciones |\n| **payment** | ❌ No | No se envía forma de pago |\n| **payment_dates** | ❌ No | No se envían fechas de pago |\n\n**Importante**: Al usar `type_note: 2`, la estructura es **mínima**. Solo se requieren datos básicos del establecimiento, el período y la referencia a la nómina a eliminar.\n\n---\n\n## 📊 Comparación: ELIMINAR vs REEMPLAZAR\n\n| Aspecto | type_note: 1 (REEMPLAZAR) | type_note: 2 (ELIMINAR) |\n|---------|---------------------------|-------------------------|\n| **Acción** | Anula original + Genera nueva | Solo anula (sin reemplazo) |\n| **worker** | ✅ Requerido | ❌ NO requerido |\n| **accrued** | ✅ Requerido | ❌ NO requerido |\n| **deductions** | ✅ Requerido | ❌ NO requerido |\n| **payment** | ✅ Requerido | ❌ NO requerido |\n| **predecessor** | ✅ Requerido | ✅ Requerido |\n| **period** | ✅ Requerido | ✅ Requerido |\n| **Uso típico** | Corregir valores erróneos | Nómina duplicada o errónea |\n| **Genera nuevo CUNE** | ✅ Sí (para el reemplazo) | ❌ No |\n| **Tamaño JSON** | ~300 líneas | ~40 líneas |\n\n---\n\n## 🧮 Efecto de la Eliminación\n\n### Antes de la Eliminación\n\n| Nómina | Estado | CUNE | Trabajador |\n|--------|--------|------|------------|\n| **NI-5** | Válida | 3c9596d08f883c... | ELIZABETH CARDONA |\n| **NI-6** | Válida | 7f2a3b9e5c1d... | JUAN PEREZ |\n\n### Después de la Eliminación (NA-3)\n\n| Nómina | Estado | CUNE | Trabajador |\n|--------|--------|------|------------|\n| **NI-5** | **Anulada** (por NA-3) | ~~3c9596d08f883c...~~ | ELIZABETH CARDONA |\n| **NI-6** | Válida | 7f2a3b9e5c1d... | JUAN PEREZ |\n| **NA-3** | Válida (eliminación) | (Nuevo CUNE) | - |\n\n**Resultado**: La nómina NI-5 queda completamente anulada. No existe nómina válida para ese período del trabajador.\n\n---\n\n## 📝 Notas Importantes sobre Notas de Ajuste - ELIMINAR\n\n### 📌 1. Cuándo Usar type_note = 2 (Eliminar)\nUse **ELIMINAR** cuando:\n- La nómina fue emitida por **error** (trabajador equivocado, período incorrecto)\n- La nómina está **duplicada** (se envió dos veces por error)\n- El trabajador **no debía recibir pago** en ese período (suspensión, licencia no remunerada)\n- Se emitió nómina a trabajador que ya **no pertenece a la empresa**\n- La nómina fue creada en el **período incorrecto** (debe reemitirse en otro período)\n\n**NO use ELIMINAR** para corregir valores erróneos. En ese caso, use `type_note: 1` (REEMPLAZAR).\n\n### 📌 2. Sin worker_code\nA diferencia de la Nota de Ajuste REEMPLAZAR, al eliminar **NO** se requiere el campo `worker_code`. La identificación del trabajador se obtiene de la nómina original mediante el `predecessor`.\n\n### 📌 3. Estructura Mínima\nLa estructura JSON para ELIMINAR es **muy simple**:\n```json\n{\n \"type_document_id\": 10,\n \"type_note\": 2,\n \"prefix\": \"NA\",\n \"consecutive\": 3,\n \"payroll_period_id\": 4,\n \"notes\": \"Motivo de eliminación\",\n \"establishment_name\": \"...\",\n \"establishment_address\": \"...\",\n \"establishment_phone\": \"...\",\n \"establishment_municipality\": 600,\n \"establishment_email\": \"...\",\n \"predecessor\": {\n \"predecessor_number\": 5,\n \"predecessor_cune\": \"...\",\n \"predecessor_issue_date\": \"2025-10-31\"\n },\n \"period\": {\n \"admision_date\": \"2025-01-01\",\n \"settlement_start_date\": \"2025-09-01\",\n \"settlement_end_date\": \"2025-09-30\",\n \"worked_time\": 1735,\n \"issue_date\": \"2025-10-31\"\n }\n}\n```\n\n### 📌 4. Campo notes es Crítico\nEl campo `notes` debe explicar **claramente el motivo de la eliminación**:\n- ✅ \"Nómina duplicada - Ya existe NI-4 para el mismo período\"\n- ✅ \"Nómina emitida a trabajador equivocado - Debe ser para CC 123456\"\n- ✅ \"Trabajador en suspensión - No corresponde pago en este período\"\n- ❌ \"Eliminar\" (demasiado genérico)\n- ❌ \"Error\" (no explica el error)\n\n### 📌 5. Efecto Irreversible\nUna vez aprobada la Nota de Ajuste ELIMINAR:\n- La nómina original queda **anulada permanentemente**\n- El CUNE original queda **invalidado**\n- **NO se puede revertir** la eliminación\n- Si fue un error, debe emitirse una **nueva nómina individual** (con nuevo consecutivo)\n\n### 📌 6. Diferencia de Pago ya Realizado\nSi la nómina a eliminar **ya fue pagada al trabajador**:\n- La eliminación **NO revierte el pago bancario**\n- El empleador debe gestionar la **devolución del dinero** fuera del sistema de nómina electrónica\n- Se recomienda documentar la devolución con recibo firmado por el trabajador\n\n### 📌 7. Período Idéntico a la Original\nEl objeto `period` debe tener **exactamente las mismas fechas** que la nómina original:\n- `admision_date`: Igual\n- `settlement_start_date`: Igual\n- `settlement_end_date`: Igual\n- `worked_time`: Igual\n- `issue_date`: **Puede ser diferente** (fecha de emisión de la nota)\n\n### 📌 8. predecessor_cune Obligatorio\nEl CUNE de la nómina original (`predecessor_cune`) es **absolutamente obligatorio**. Sin este campo, la DIAN rechazará la nota de eliminación porque no puede identificar cuál nómina anular.\n\nEl CUNE debe ser el código completo de **96 caracteres hexadecimales**.\n\n### 📌 9. Plazo para Eliminar\nSegún la Resolución 000013 de 2021, las Notas de Ajuste (incluyendo eliminación) pueden emitirse:\n- Durante el **mismo mes** de la nómina original, o\n- Hasta el **último día del mes siguiente**\n\nDespués de este plazo, debe coordinarse directamente con la DIAN.\n\n### 📌 10. Email al Trabajador\nCuando la Nota de Ajuste ELIMINAR es aprobada:\n- El trabajador recibe email notificando la **anulación de la nómina**\n- El email debe incluir explicación del motivo\n- Si ya se pagó, debe indicarse el procedimiento de devolución\n- El PDF de la nómina original aparece marcado como \"ANULADO\"\n\n### 📌 11. No Genera Reemplazo\nAl usar `type_note: 2`, **NO** se genera una nueva nómina. Si después de eliminar se requiere una nómina correcta:\n1. Primero emitir la Nota de Ajuste ELIMINAR\n2. Esperar aprobación de la DIAN\n3. Emitir una **nueva nómina individual** (con nuevo consecutivo NI-X)\n\n**NO** es posible eliminar y reemplazar en un solo paso. Para eso existe `type_note: 1` (REEMPLAZAR).\n\n### 📌 12. Validación de Existencia\nAntes de emitir una Nota de Ajuste ELIMINAR, el sistema valida que:\n- La nómina original (`predecessor_number`) exista\n- El CUNE (`predecessor_cune`) coincida con el de la base de datos\n- La nómina original esté en estado **VÁLIDA** (no se puede eliminar una nómina ya anulada)\n- El trabajador corresponda a la empresa emisora\n\n### 📌 13. Modo Asíncrono Obligatorio\nAl igual que todas las nóminas, las Notas de Ajuste ELIMINAR **solo se envían en modo asíncrono**. El `testSetId` es obligatorio. La respuesta incluye un `zip_key` para consultar el resultado.\n\n### 📌 14. Impacto en Reportes Contables\nLa eliminación de una nómina afecta:\n- Reportes de nómina mensual (se resta el valor eliminado)\n- Provisiones de prestaciones sociales\n- Base de cálculo de parafiscales\n- Certificados de ingresos y retenciones\n\nSe recomienda generar reportes **después** de que la DIAN apruebe la eliminación.\n\n### 📌 15. Casos Comunes de Eliminación\n- **Nómina duplicada**: Se envió dos veces la misma nómina (NI-5 y NI-6 con mismos datos)\n- **Trabajador equivocado**: Se generó nómina para CC 41946692 cuando era para CC 12345678\n- **Período incorrecto**: Se emitió nómina de septiembre en agosto por error\n- **Trabajador retirado**: Se emitió nómina a empleado que ya no trabaja en la empresa\n- **Suspensión sin pago**: Trabajador estuvo suspendido sin remuneración todo el período\n- **Error sistémico**: Fallo del software generó nómina sin datos reales" }, "response": [] }, { "name": "Enviar Pendientes Nomina", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/payroll/send_pendings", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "payroll", "send_pendings" ] }, "description": "# ENVIAR NÓMINAS PENDIENTES\n\n## 📋 Descripción\nEnvía a la DIAN todas las nóminas individuales que quedaron **pendientes de transmisión** (estado `state_document_id` = 2). Útil cuando hubo fallas de conexión o errores temporales al crear nóminas con `dont_send_yet: true`.\n\n**Request Handler:** `PayrollController@send_pendings`\n\n---\n\n## 🔗 URL\n```\nPOST /api/ubl2.1/payroll/send_pendings\nPOST /api/ubl2.1/payroll/send_pendings/{prefix}\nPOST /api/ubl2.1/payroll/send_pendings/{prefix}/{number}\n```\n\n---\n\n## 📤 Body\n**Vacío** - No requiere parámetros en el body.\n\n---\n\n## 🔧 Parámetros URL (Opcionales)\n\n| Parámetro | Tipo | Descripción | Ejemplo |\n|-----------|------|-------------|---------|\n| **prefix** | string | Filtrar por prefijo específico | `NI`, `NIM` |\n| **number** | string | Filtrar por número específico (requiere prefix) | `125` |\n\n**Ejemplos de uso:**\n```\n# Enviar todas las nóminas pendientes de la empresa\nPOST /api/ubl2.1/payroll/send_pendings\n\n# Enviar todas las nóminas con prefijo \"NI\"\nPOST /api/ubl2.1/payroll/send_pendings/NI\n\n# Enviar nómina específica NI-125\nPOST /api/ubl2.1/payroll/send_pendings/NI/125\n\n# Enviar TODAS las nóminas pendientes del sistema (solo admin)\nPOST /api/ubl2.1/payroll/send_pendings/ALL/ALL\n```\n\n---\n\n## ⚙️ Comportamiento\n\n1. **Busca** nóminas individuales con `type_document_id = 9` y `state_document_id = 2` (Pendiente)\n2. **Filtra** por company_id del usuario autenticado (o todas si ALL/ALL)\n3. **Aplica filtros** de prefix/number si fueron proporcionados\n4. **Lee archivos** XML y ZIP previamente generados\n5. **Firma y envía** cada documento a DIAN (modo síncrono)\n6. **Actualiza** estado según respuesta:\n - Si éxito: `state_document_id = 1` (Enviado) + guarda CUNE\n - Si falla: Permanece en 2 (Pendiente)\n7. **Retorna** resumen de envíos (exitosos/fallidos)\n\n---\n\n## 🔄 Flujo: Generación Offline → Envío Diferido\n\n### **Paso 1: Crear Nómina sin enviar a DIAN**\n```json\nPOST /api/ubl2.1/payroll/{{testSetId}}\n{\n \"dont_send_yet\": true,\n \"type_document_id\": 9,\n \"prefix\": \"NI\",\n \"consecutive\": 123,\n \"worker_code\": \"41946692\",\n \"period\": {...},\n \"worker\": {...},\n \"accrued\": {...},\n \"deductions\": {...}\n}\n```\n\n**Resultado:**\n- Documento guardado en BD con `state_document_id: 2`\n- CUNE generado localmente\n- XML y ZIP creados pero NO enviados a DIAN\n- Sin validación DIAN aún\n\n### **Paso 2: Enviar pendientes cuando hay conexión**\n```bash\nPOST /api/ubl2.1/payroll/send_pendings\n```\n\n**Resultado:**\n- Envía todas las nóminas pendientes a DIAN\n- Actualiza estados\n- Genera ApplicationResponse\n\n---\n\n## ✅ Respuesta Exitosa\n\n```json\n{\n \"success\": true,\n \"message\": \"Envios de documentos pendientes realizados con exito.\",\n \"responses\": [\n {\n \"document\": \"NI-123\",\n \"Envelope\": {\n \"Body\": {\n \"SendNominaSyncResponse\": {\n \"SendNominaSyncResult\": {\n \"IsValid\": \"true\",\n \"StatusCode\": \"00\",\n \"StatusDescription\": \"Procesado Correctamente.\",\n \"XmlDocumentKey\": \"abc123...xyz789\"\n }\n }\n }\n }\n },\n {\n \"document\": \"NI-124\",\n \"Envelope\": {...}\n }\n ]\n}\n```\n\n---\n\n## 📋 Sin Documentos Pendientes\n\n```json\n{\n \"success\": true,\n \"message\": \"No existen registros de documentos pendientes para realizar envios....\"\n}\n```\n\n---\n\n## ❌ Respuesta con Error\n\n```json\n{\n \"success\": false,\n \"message\": \"El servicio DIAN no se encuentra disponible en el momento, reintente mas tarde...\"\n}\n```\n\n---\n\n## 🎯 Casos de Uso\n\n### **Caso 1: Conexión Inestable**\n```\nProblema:\n- Internet intermitente durante el día\n- Necesitas emitir nóminas pero DIAN no responde\n\nSolución:\n1. Crear nóminas con dont_send_yet: true\n2. Acumular documentos localmente\n3. Al final del día: send_pendings\n4. Todas las nóminas se envían en lote\n```\n\n### **Caso 2: Procesamiento Nocturno**\n```\nProblema:\n- Alto volumen de nóminas diarias\n- No quieres esperar DIAN en cada operación\n\nSolución:\n1. Durante el día: dont_send_yet: true\n2. A las 11 PM: Ejecutar send_pendings\n3. Transmisión en horario de bajo tráfico\n```\n\n### **Caso 3: Recuperación de Fallas**\n```\nProblema:\n- Hubo caída de servidor DIAN\n- Quedaron nóminas sin enviar\n\nSolución:\n1. Ejecutar send_pendings\n2. Sistema reintenta automáticamente\n3. Actualiza estados según respuesta\n```\n\n---\n\n## 📌 Consideraciones Importantes\n\n1. **dont_send_yet: true** → Marca el documento como `state_document_id = 2` (Pendiente)\n\n2. **Filtros opcionales:**\n - Sin parámetros: Envía todos los pendientes de la empresa\n - Con prefix: Solo nóminas con ese prefijo\n - Con prefix/number: Nómina específica\n\n3. **ALL/ALL:** Requiere permisos de administrador, envía pendientes de TODAS las empresas\n\n4. **Archivos requeridos:** Los XML y ZIP deben existir desde la creación original (NIS-{prefix}{consecutive}.xml y .zip)\n\n5. **CUNE:** Se actualiza con el valor retornado por DIAN al validar\n\n6. **Timeout:** Configurado para 24 horas (86400 seg) para lotes grandes\n\n7. **Memory limit:** 4GB para manejar múltiples documentos\n\n8. **Certificado:** Verifica vigencia antes de enviar\n\n9. **Empresa activa:** Solo envía si `company.state = true`\n\n10. **S3 compatible:** Funciona con archivos en almacenamiento local o S3\n\n11. **Modo síncrono:** Las nóminas se envían síncronamente a DIAN, NO en modo asíncrono\n\n12. **Prefijos de archivos:** NIS-{prefix}{consecutive}.xml (signed), ReqNI-{prefix}{consecutive}.xml (request), RptaNI-{prefix}{consecutive}.xml (response)\n\n---\n\n## 🔑 Diferencias con Facturas y Notas\n\n| Aspecto | Facturas | Notas | Nóminas |\n|---------|----------|-------|----------|\n| **Endpoint** | `/invoice/send_pendings` | `/credit-note/send_pendings` | `/payroll/send_pendings` |\n| **type_document_id** | 1 | 4, 5 | 9 |\n| **Prefijos XML** | `FES-`, `ReqFE-`, `RptaFE-` | `NCS-`, `ReqNC-`, `RptaNC-` | `NIS-`, `ReqNI-`, `RptaNI-` |\n| **Campo clave** | `cufe` | `cude` | `cune` |\n| **Controlador** | InvoiceController | CreditNoteController, DebitNoteController | PayrollController |\n| **Modo envío** | Sync/Async | Sync/Async | Solo Sync |\n\n---\n\n## 💡 Recomendaciones\n\n✅ Usar `dont_send_yet: true` cuando:\n- Conexión inestable\n- Alto volumen de operaciones\n- Procesamiento en lote preferido\n\n✅ Programar `send_pendings` en:\n- Horarios de baja carga (noche/madrugada)\n- Después de verificar conectividad\n- Con monitoreo de resultados\n\n✅ Validar respuestas:\n- Verificar `IsValid = 'true'`\n- Guardar logs de errores\n- Reintentar documentos fallidos\n\n---\n\n## 🔐 Seguridad\n\n- Requiere **Bearer Token** válido\n- Filtra por empresa del token (excepto ALL/ALL)\n- Valida certificado digital vigente\n- Verifica estado activo de la empresa" }, "response": [] }, { "name": "Enviar Pendientes Nota Ajuste Nomina", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/payroll-adjust-note/send_pendings", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "payroll-adjust-note", "send_pendings" ] }, "description": "# ENVIAR NOTAS DE AJUSTE DE NÓMINA PENDIENTES\n\n## 📋 Descripción\nEnvía a la DIAN todas las notas de ajuste de nómina que quedaron **pendientes de transmisión** (estado `state_document_id` = 2). Útil cuando hubo fallas de conexión o errores temporales al crear notas de ajuste con `dont_send_yet: true`.\n\n**Request Handler:** `PayrollAdjustNoteController@send_pendings`\n\n---\n\n## 🔗 URL\n```\nPOST /api/ubl2.1/payroll-adjust-note/send_pendings\nPOST /api/ubl2.1/payroll-adjust-note/send_pendings/{prefix}\nPOST /api/ubl2.1/payroll-adjust-note/send_pendings/{prefix}/{number}\n```\n\n---\n\n## 📤 Body\n**Vacío** - No requiere parámetros en el body.\n\n---\n\n## 🔧 Parámetros URL (Opcionales)\n\n| Parámetro | Tipo | Descripción | Ejemplo |\n|-----------|------|-------------|---------|\n| **prefix** | string | Filtrar por prefijo específico | `NA`, `NAR` |\n| **number** | string | Filtrar por número específico (requiere prefix) | `125` |\n\n**Ejemplos de uso:**\n```\n# Enviar todas las notas de ajuste pendientes de la empresa\nPOST /api/ubl2.1/payroll-adjust-note/send_pendings\n\n# Enviar todas las notas con prefijo \"NA\"\nPOST /api/ubl2.1/payroll-adjust-note/send_pendings/NA\n\n# Enviar nota específica NA-125\nPOST /api/ubl2.1/payroll-adjust-note/send_pendings/NA/125\n\n# Enviar TODAS las notas pendientes del sistema (solo admin)\nPOST /api/ubl2.1/payroll-adjust-note/send_pendings/ALL/ALL\n```\n\n---\n\n## ⚙️ Comportamiento\n\n1. **Busca** notas de ajuste con `type_document_id = 10` y `state_document_id = 2` (Pendiente)\n2. **Filtra** por company_id del usuario autenticado (o todas si ALL/ALL)\n3. **Aplica filtros** de prefix/number si fueron proporcionados\n4. **Lee archivos** XML y ZIP previamente generados\n5. **Firma y envía** cada documento a DIAN (modo síncrono)\n6. **Actualiza** estado según respuesta:\n - Si éxito: `state_document_id = 1` (Enviado) + guarda CUNE\n - Si falla: Permanece en 2 (Pendiente)\n7. **Retorna** resumen de envíos (exitosos/fallidos)\n\n---\n\n## 🔄 Flujo: Generación Offline → Envío Diferido\n\n### **Paso 1: Crear Nota de Ajuste sin enviar a DIAN**\n```json\nPOST /api/ubl2.1/payroll-adjust-note/{{testSetId}}\n{\n \"dont_send_yet\": true,\n \"type_document_id\": 10,\n \"type_note\": 1,\n \"prefix\": \"NA\",\n \"consecutive\": 123,\n \"predecessor\": {...},\n \"period\": {...},\n \"worker\": {...},\n \"accrued\": {...},\n \"deductions\": {...}\n}\n```\n\n**Resultado:**\n- Documento guardado en BD con `state_document_id: 2`\n- CUNE generado localmente\n- XML y ZIP creados pero NO enviados a DIAN\n- Sin validación DIAN aún\n\n### **Paso 2: Enviar pendientes cuando hay conexión**\n```bash\nPOST /api/ubl2.1/payroll-adjust-note/send_pendings\n```\n\n**Resultado:**\n- Envía todas las notas de ajuste pendientes a DIAN\n- Actualiza estados\n- Genera ApplicationResponse\n\n---\n\n## ✅ Respuesta Exitosa\n\n```json\n{\n \"success\": true,\n \"message\": \"Envios de documentos pendientes realizados con exito.\",\n \"responses\": [\n {\n \"document\": \"NA-123\",\n \"Envelope\": {\n \"Body\": {\n \"SendNominaSyncResponse\": {\n \"SendNominaSyncResult\": {\n \"IsValid\": \"true\",\n \"StatusCode\": \"00\",\n \"StatusDescription\": \"Procesado Correctamente.\",\n \"XmlDocumentKey\": \"abc123...xyz789\"\n }\n }\n }\n }\n },\n {\n \"document\": \"NA-124\",\n \"Envelope\": {...}\n }\n ]\n}\n```\n\n---\n\n## 📋 Sin Documentos Pendientes\n\n```json\n{\n \"success\": true,\n \"message\": \"No existen registros de documentos pendientes para realizar envios....\"\n}\n```\n\n---\n\n## ❌ Respuesta con Error\n\n```json\n{\n \"success\": false,\n \"message\": \"El servicio DIAN no se encuentra disponible en el momento, reintente mas tarde...\"\n}\n```\n\n---\n\n## 🎯 Casos de Uso\n\n### **Caso 1: Correcciones Masivas**\n```\nProblema:\n- Se detectaron errores en múltiples nóminas\n- Necesitas emitir varias notas de ajuste\n- DIAN tiene problemas de conectividad\n\nSolución:\n1. Crear notas de ajuste con dont_send_yet: true\n2. Acumular documentos localmente\n3. Cuando DIAN esté disponible: send_pendings\n4. Todas las notas se envían en lote\n```\n\n### **Caso 2: Ajustes Fin de Mes**\n```\nProblema:\n- Múltiples correcciones al cierre del mes\n- No quieres esperar DIAN en cada operación\n\nSolución:\n1. Durante el día: dont_send_yet: true\n2. Al final del día: Ejecutar send_pendings\n3. Transmisión ordenada de todos los ajustes\n```\n\n### **Caso 3: Recuperación de Fallas**\n```\nProblema:\n- Hubo caída de servidor DIAN\n- Quedaron notas de ajuste sin enviar\n\nSolución:\n1. Ejecutar send_pendings\n2. Sistema reintenta automáticamente\n3. Actualiza estados según respuesta\n```\n\n---\n\n## 📌 Consideraciones Importantes\n\n1. **dont_send_yet: true** → Marca el documento como `state_document_id = 2` (Pendiente)\n\n2. **Filtros opcionales:**\n - Sin parámetros: Envía todos los pendientes de la empresa\n - Con prefix: Solo notas con ese prefijo\n - Con prefix/number: Nota específica\n\n3. **ALL/ALL:** Requiere permisos de administrador, envía pendientes de TODAS las empresas\n\n4. **Archivos requeridos:** Los XML y ZIP deben existir desde la creación original (NAS-{prefix}{consecutive}.xml y .zip)\n\n5. **CUNE:** Se actualiza con el valor retornado por DIAN al validar\n\n6. **Timeout:** Configurado para 24 horas (86400 seg) para lotes grandes\n\n7. **Memory limit:** 4GB para manejar múltiples documentos\n\n8. **Certificado:** Verifica vigencia antes de enviar\n\n9. **Empresa activa:** Solo envía si `company.state = true`\n\n10. **S3 compatible:** Funciona con archivos en almacenamiento local o S3\n\n11. **Modo síncrono:** Las notas se envían síncronamente a DIAN, NO en modo asíncrono\n\n12. **Prefijos de archivos:** NAS-{prefix}{consecutive}.xml (signed), ReqNA-{prefix}{consecutive}.xml (request), RptaNA-{prefix}{consecutive}.xml (response)\n\n13. **type_note:** Puede ser 1 (Reemplazar) o 2 (Eliminar), el endpoint maneja ambos tipos\n\n---\n\n## 🔑 Diferencias con Nóminas Individuales\n\n| Aspecto | Nóminas Individuales | Notas de Ajuste |\n|---------|---------------------|------------------|\n| **Endpoint** | `/payroll/send_pendings` | `/payroll-adjust-note/send_pendings` |\n| **type_document_id** | 9 | 10 |\n| **Prefijos XML** | `NIS-`, `ReqNI-`, `RptaNI-` | `NAS-`, `ReqNA-`, `RptaNA-` |\n| **Campo clave** | `cune` | `cune` |\n| **Controlador** | PayrollController | PayrollAdjustNoteController |\n| **Tipos** | Solo individual | Reemplazar (1) o Eliminar (2) |\n\n---\n\n## 💡 Recomendaciones\n\n✅ Usar `dont_send_yet: true` cuando:\n- Múltiples correcciones al cierre de período\n- Conexión inestable\n- Procesamiento en lote preferido\n\n✅ Programar `send_pendings` en:\n- Después de verificar todas las correcciones\n- Horarios de baja carga\n- Con monitoreo de resultados\n\n✅ Validar respuestas:\n- Verificar `IsValid = 'true'`\n- Confirmar que se anuló la nómina original\n- Guardar logs de errores\n\n---\n\n## 🔐 Seguridad\n\n- Requiere **Bearer Token** válido\n- Filtra por empresa del token (excepto ALL/ALL)\n- Valida certificado digital vigente\n- Verifica estado activo de la empresa\n- Valida que las nóminas originales existan antes de enviar notas de ajuste" }, "response": [] } ] }, { "name": "Documento Soporte", "item": [ { "name": "SendISupportDocument -TestSetId Sencilla", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"number\": 984000003,\r\n\t\"type_document_id\": 11,\r\n\t\"date\": \"2025-11-04\",\r\n\t\"time\": \"12:09:38\",\r\n\t\"notes\": \"SIN OBSERVACIONES\",\r\n\t\"sendmail\": true,\r\n\t\"sendmailtome\": true,\r\n\t\"resolution_number\": \"18760000001\",\r\n\t\"prefix\": \"SEDS\",\r\n \"establishment_name\": \"ALEXANDER OBANDO LONDOÑO\",\t\r\n \"tarifaica\": \"0\",\r\n \"actividadeconomica\": \"6201\",\r\n\t\"seller\": {\r\n\t\t\"identification_number\": \"41946692\",\r\n \"dv\": \"6\",\r\n\t\t\"name\": \"ELIZABETH CARDONA VILLADA\",\r\n\t\t\"phone\": \"3226563672\",\r\n\t\t\"address\": \"LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n\t\t\"email\": \"alexander_obando@hotmail.com\",\r\n\t\t\"merchant_registration\": \"0000-00\",\r\n \"postal_zone_code\": 630001,\r\n\t\t\"type_document_identification_id\": 3,\r\n\t\t\"type_organization_id\": 2,\r\n\t\t\"municipality_id\": 820,\r\n\t\t\"type_liability_id\": 117,\r\n\t\t\"type_regime_id\": 1\r\n\t},\r\n\t\"payment_form\": {\r\n\t\t\"payment_form_id\": 1,\r\n\t\t\"payment_method_id\": 10,\r\n\t\t\"payment_due_date\": \"2025-11-04\",\r\n\t\t\"duration_measure\": \"0\"\r\n\t},\t\r\n\t\"allowance_charges\": [\r\n\t\t{\r\n\t\t\t\"discount_id\": 10,\r\n\t\t\t\"charge_indicator\": false,\r\n\t\t\t\"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n\t\t\t\"amount\": \"0.00\",\r\n\t\t\t\"base_amount\": \"200.00\"\r\n\t\t}\r\n\t],\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"200.00\",\r\n\t\t\"tax_exclusive_amount\": \"200.00\",\r\n\t\t\"tax_inclusive_amount\": \"200.00\",\r\n\t\t\"allowance_total_amount\": \"0.00\",\r\n\t\t\"charge_total_amount\": \"0.00\",\r\n\t\t\"payable_amount\": \"200.00\"\r\n\t},\r\n\t\"tax_totals\": \r\n\t[\r\n\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"0.00\",\r\n\t\t\t\"percent\": \"0\",\r\n\t\t\t\"taxable_amount\": \"200.00\"\r\n\t\t}\r\n\t\r\n\t],\r\n\t\"invoice_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"2.00\",\r\n\t\t\t\"line_extension_amount\": \"200.00\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"allowance_charges\": [{\r\n\t\t\t\t\t\"charge_indicator\": false,\r\n\t\t\t\t\t\"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n\t\t\t\t\t\"amount\": \"0.00\",\r\n\t\t\t\t\t\"base_amount\": \"200.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"tax_totals\": \r\n\t\t\t[{\r\n\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\"tax_amount\": \"0.00\",\r\n\t\t\t\t\"percent\": \"0.00\",\r\n\t\t\t\t\"taxable_amount\": \"200.00\"\r\n\t\t\t}],\r\n\t\t\t\"description\": \"ARTICULO DE PRUEBAS\",\r\n \"notes\": \"\",\r\n\t\t\t\"code\": \"PRUEBA\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"100.00\",\r\n\t\t\t\"base_quantity\": \"2.00\",\r\n\t\t \"type_generation_transmition_id\": 1,\r\n\t\t\t\"start_date\": \"2025-11-04\"\r\n\t\t}\r\n\r\n\t],\r\n \"logo_empresa_emisora\": \"/9j/4AAQSkZJRgABAQEAYABgAAD/4QBaRXhpZgAATU0AKgAAAAgABQMBAAUAAAABAAAASgMDAAEAAAABAAAAAFEQAAEAAAABAQAAAFERAAQAAAABAAAOw1ESAAQAAAABAAAOwwAAAAAAAYagAACxj//bAEMAAgEBAgEBAgICAgICAgIDBQMDAwMDBgQEAwUHBgcHBwYHBwgJCwkICAoIBwcKDQoKCwwMDAwHCQ4PDQwOCwwMDP/bAEMBAgICAwMDBgMDBgwIBwgMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDP/AABEIAC4AdgMBIgACEQEDEQH/xAAfAAABBQEBAQEBAQAAAAAAAAAAAQIDBAUGBwgJCgv/xAC1EAACAQMDAgQDBQUEBAAAAX0BAgMABBEFEiExQQYTUWEHInEUMoGRoQgjQrHBFVLR8CQzYnKCCQoWFxgZGiUmJygpKjQ1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoOEhYaHiImKkpOUlZaXmJmaoqOkpaanqKmqsrO0tba3uLm6wsPExcbHyMnK0tPU1dbX2Nna4eLj5OXm5+jp6vHy8/T19vf4+fr/xAAfAQADAQEBAQEBAQEBAAAAAAAAAQIDBAUGBwgJCgv/xAC1EQACAQIEBAMEBwUEBAABAncAAQIDEQQFITEGEkFRB2FxEyIygQgUQpGhscEJIzNS8BVictEKFiQ04SXxFxgZGiYnKCkqNTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqCg4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2dri4+Tl5ufo6ery8/T19vf4+fr/2gAMAwEAAhEDEQA/AP38qn4h8QWfhXQ7rUr+Zbezs4zLLI38Kj+vt3NXK8F/4KP+Jbzwz+zVNJa+YVudStoJwo6oSzD/AMfVKzqRrSg44ZXnZ8qezfS/zPH4hzeOV5ZXzGauqUXK3ov6uDfFfxZ8YrK61HSb6x8J+F4ZDEL27lEJk/4Gcnd7LgDpk0sGreOvCGmtq2leJdO8Zaba/Ncxwyi4aNfUj7wH+6cjrjFeKDxHY618dPhr4E8TXFxo/hmLQrKVYJibbzp5rbzW3ZwVZ5j5Z75GBg817L8SP2bvEPgnxlp+r/C1k03dE8d3BLdZRDxggSbtwbJypyAVBr8LzPgXiCE3jKletOppeca0ozTet6dJJUnCL05H8Sv7yvp8VlPElTMKVXEUYyn7KShPlb51KybtDblV9LvVJv09h+HHj60+JPhS31S1Bj8zKSxE5aGQdVP6EHuCDW9XhvwM0bxB+z/pfifVvHUunaboCwfbprlJQ0dsUJ3sVQfKu05OBgBRXe+Av2jPA/xP8Iap4g0HxNpeo6JopYX18khWC1KrvO5mAAwpBPoCK/WuE62Z4nKaVbNKbjWStPSyck7X7LmVpW6Xstj7XA5tSqQhHEPkqNN8srRlZbvlettL32O1or5Z1r/gsX8FNH8Qy2K6jr19HDIYzeW2mM1u2DjILEMR7hea9mtf2pvh9efCCPx9H4p03/hEZHEX9pEsI43LbNjjG5G3YGGAPI9RX1FTA4inZzg1fbRnPguKsmxcpxw2KpycE3K01olu3rsur28z0CivIbn9vj4PWWn213N490WG1vd32eZ/MWOfacNsYrhtp4OOhosP2+fg3qd/a2sPxC8PtNfOscAaVlEhZtowSoGN3Gc44NT9Tr/yP7mbf6yZTe31qnf/ABx67dep69RXD/Fv9pPwH8B7uyt/GHijStAn1FGkto7qQh5VUgFgACcZIGT159DWtb/FvwzP4At/FT65p1p4buoxNFqN5KLW3dD91t0m0bW6gngggjIINZ+xnZSs7PbTc7lmOEdWdFVY88FeS5leK7tXul6nRUV5j4R/bO+Fnj7xna+HdD8caFq2s30hit7a0mMrTMAWO0qMHABOQcYFenUVKc4O00166FYTHYbFRc8LUjNJ2bi1JJ9tG9QooorM6gpk1vHcqFkjSRVYMAy5wQcg/UHmn18sf8Fjbfx1Y/sR6x4i+H+seINH1fwfdw6zdnR72W1uLixRXSdSY2BKIsnnMDxiDPUCtKMOeai3a/U8/NsZLCYOpiYwc+RN8q3duiPQ/wBrn9jTQv2q9AhaaZtJ8SafGUsdTjTdheT5Uq/xx5JOMgqSSDywPz7+zn+0j8RP2UvjnpHwl+LCvd6Xq0iWukam8nm+XubZEY5f+WkLNhSH+ZMj7oG2vlz9nv4o/GKx+Engb48fDHxt4w+Nlvp8stv4x8K3F3cXVxos23a0bwCV3kjdWZ1kC5UbHx1x13ir47fED9un4zeGfHvjrwfN8JfhT8OZhd3mpasskEUMYkSSVUllRDcXEhjSNI4kJBK8dSfpsLpTeGryU6dn6xfS3Xf5P8/58zzGRq42nn2VUKmGzByhdR1p16T5eZ1ZL3LRje7bUota7Xj+gv7c3/JnXxM/7F28/wDRTV+df7P3gnxL4+/4JW/E6z8M29xeTw+KoLq9toAWlntY4YWkCgcnaQrkDshr6mf9tnT/ANuP9gD4yeINJ8O6toen6Xpd5YpNdujx3beSzEIV/iVShYYwPMABPOPHP+Cb7/EC3/YB+JFx8MZo4/GFn4hWe0R4Y5TcIsEBkjVZAVLlN23I5IA71OXxnRwslKyanHfbpuz1eLMRhM3z2hUoOU6VTC17OCfM1aS92MrXfZO19up86fA34r/BXRfhBfeHPHnw51nUNdvJJMeI9Nv83NsrD5DHC7KgKf3SSH7+le5eJvh98PfCP/BL74hah8OfF+teJtM1jVtMN5balCkE2m3Ec6AgxqAQWVlycspCDB4Ncb40/a7j1L9naeH4kfCrwn4m8b6xqGp6WNYutPj0u+sJIo7aQO6wxI7MDdYwGjP7sEkkmqXgT4GeKPhv/wAE2vit4i12xvdL0/xPf6MmnW9yhjecQ3Tb5th5CnzAFPG7BPIwa9qqm7Tk3H346c11LVbdVb5eh+X5fUhTVTC0IwrKOGq3mqTp1KSdKTXtLe7Jyuk23PV/Fffkvhr45+B+vfBrQNF+JEfxWXWdAmu/Kfw0tgLV4ppA43G4JYsMdgB9a+kv2pP+Cevh3Xf2EfB/i74aw69eS6DpY1eJdU8uTULvTLrN20cnlAJvhMzOAoPBkGW4Nbv/AATE/Ys+F/x1/ZVs9e8WeEbPWNXbUbqA3Mk80bFFYbQQjqOMnnGa+y/G3hix8E/s/avoul262emaR4emsrOBSWWGGO2ZEQEkk4VQOSTxXk5hmip4lQoOV4yd09vl97P0Tg7w/ljckniM1jScK1CKhKCaqKyTi5Nq11yx2vt2PzU/Yz+B/wDw8W+KGg6t4q1i4vP+EDtrez162upHkbUbSMH7GIichdxV0lGR93eNzSsV1P2tn8Qft2/8FCrf4R6ffR6R4d8N3D6ZaRIN1vZrDEXuLgxggF/lZAOOFRcjk103/BBj/kbPiV/16WH/AKHPTP2/f2e/iF+zD+1mvxw+HlneahY3UwvriWGDzxp9yy+VLHNGvPkyqfvesjKSDtJ7JVrZhOjdJxjaF9k2k/68tD53D5a6vBmGzJ05TjVrKWJ5buc6cJSj62Vk3/efNpufQH7PX/BJbwD+zx8S9B8YWGveMNQ1zQnaRBcT262srNG0ZzGsO8DDnjf1xya+pq+Ff2UP+Cu2uftCfHHwx4H1DwXpemza3M8M97DfSMIykbyErEy552YwXOM55xivuqvmczhio1EsW/etps9Pkfu3AeK4er4GcuHIqNJStKykve5Y3vzat2trt5hRRRXmn2wU24gju4HiljWSORSjo43K4PBBHcGnUUAfnL8cv+CBp0D4rXfjj9nX4oa58F9WvizT6bbPMLLLHJWGSF0kiiP/ADyYSLzgbVAUc5oP/BBr4nfHHxFp958f/wBorxL4y03TZQ6aXZS3Fzkd9k1y+2EkcErCSc9a/T2iulYuquv+f3nzNTg/Kqkm5U/dbu4qUlFv/Cnb5Wt5HMfDD4M+F/g18NNN8H+G9FstL8N6TCIbaxRN0ajO4lt2S7FssWYlmYkkknNb9hpFppW77La29t5mN3lRBN2OmcD3P51YorByb3PoqdGnBKMIpJKystl2XZFG78M6bqGpR3lxp9jNeQ8RzyQK0kf0YjI6Dp6VYvtNt9UhEd1bw3EancFlQOoPrg/U1NWf4a8J6X4L06Sz0fTNP0mzmu7m/kgs7dII3uLmeS4uJiqgAySzyyyu55eSR2YlmJKuyvZx10338y1Y6bb6XCY7W3ht42O4rEgRSfXA+gqSaFbiFo5FWSOQFWVhlWB6ginUUh8qSsirY6FY6XMZLWztbeRhtLRQqjEemQPYVaoooFGKirJFNvD2nvefaGsbNrjcH80wrv3DvnGc+9XKKKLsIxS2QUUUUFH/2Q==\" \r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/support-document", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "support-document" ] }, "description": "# 📄 DOCUMENTO SOPORTE - SENCILLO SIN DESCUENTOS\n\n## 📄 Descripción General\n\nEste ejemplo demuestra la emisión de un **Documento Soporte Electrónico** (`type_document_id: 11`) para soportar adquisiciones efectuadas a **sujetos no obligados a facturar electrónicamente** (personas naturales, informales, ventas sin documentación formal).\n\nEl Documento Soporte es un comprobante electrónico que permite al comprador (empresa obligada a facturar) documentar sus costos y deducciones ante la DIAN sin que el vendedor emita factura electrónica. Es obligatorio desde agosto de 2020 para compras superiores a determinado monto según normativa vigente.\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/support-document\n```\n\n**Características del Endpoint:**\n- **Modo**: Síncrono (respuesta inmediata) o asíncrono con testSetId\n- **Autenticación**: Bearer token en header\n- **Content-Type**: application/json\n- **Controlador**: `SupportDocumentController@store`\n- **Validación**: `SupportDocumentRequest`\n- **Tabla**: `documents` (type_document_id = 11)\n- **CUDE**: Código Único de Documento Equivalente (similar a CUFE en facturas)\n\n---\n\n## 🔑 Campos Principales del Ejemplo\n\n### Datos del Documento\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **type_document_id** | 11 | Documento Soporte Electrónico |\n| **prefix** | SEDS | Prefijo autorizado para doc. soporte |\n| **number** | 984000003 | Número consecutivo |\n| **resolution_number** | 18760000001 | Resolución 1876 DIAN |\n| **date** | 2025-11-04 | Fecha del documento |\n| **time** | 12:09:38 | Hora de emisión |\n| **notes** | SIN OBSERVACIONES | Observaciones generales |\n\n### Datos del Vendedor (seller) - Proveedor No Obligado\n\nEn Documento Soporte, el \"seller\" es en realidad el **proveedor que vende** (quien NO factura electrónicamente):\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **identification_number** | 41946692 | Cédula del proveedor |\n| **name** | ELIZABETH CARDONA VILLADA | Nombre proveedor |\n| **phone** | 3226563672 | Teléfono |\n| **address** | LIMONAR MZ 6 CS 3 ET 1 PISO 2 | Dirección |\n| **email** | alexander_obando@hotmail.com | Email proveedor |\n| **type_document_identification_id** | 3 | Cédula de ciudadanía |\n| **type_organization_id** | 2 | Persona natural |\n| **municipality_id** | 820 | Municipio de residencia |\n| **type_liability_id** | 117 | No responsable tributario |\n| **type_regime_id** | 1 | Régimen simplificado |\n\n---\n\n## 💳 Forma de Pago (payment_form)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **payment_form_id** | 1 | Pago al contado |\n| **payment_method_id** | 10 | Transferencia bancaria |\n| **payment_due_date** | 2025-11-04 | Fecha de pago |\n\n---\n\n## 💰 Línea de Detalle (invoice_lines)\n\n| Concepto | Valor | Descripción |\n|----------|-------|-------------| \n| **description** | ARTICULO DE PRUEBAS | Descripción del bien/servicio |\n| **code** | PRUEBA | Código interno del artículo |\n| **unit_measure_id** | 70 | Unidad de medida (UNIDAD) |\n| **invoiced_quantity** | 2.00 | Cantidad |\n| **price_amount** | 100.00 | Precio unitario |\n| **line_extension_amount** | 200.00 | Subtotal línea (2 × 100) |\n| **free_of_charge_indicator** | false | No es bonificación |\n\n---\n\n## 🧮 Cálculo de Totales\n\n| Concepto | Valor |\n|----------|-------| \n| **line_extension_amount** | 200,00 |\n| **tax_exclusive_amount** | 200,00 |\n| **tax_inclusive_amount** | 200,00 |\n| **allowance_total_amount** | 0,00 |\n| **charge_total_amount** | 0,00 |\n| **Impuesto Total (IVA 0%)** | 0,00 |\n| **PAYABLE_AMOUNT** | **200,00** |\n\n---\n\n## 🏢 Datos de Establecimiento\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **establishment_name** | ALEXANDER OBANDO LONDOÑO | Nombre comercial |\n| **tarifaica** | 0 | Tarifa ICA municipal |\n| **actividadeconomica** | 6201 | Actividad económica (consultoría) |\n| **postal_zone_code** | 630001 | Código postal del establecimiento |\n\n---\n\n## 📝 Notas Importantes sobre Documento Soporte\n\n### 📌 1. Diferencia: Documento Soporte vs Factura Electrónica\nEl Documento Soporte **NO es una factura**. Se emite por el COMPRADOR (la empresa obligada a facturar) cuando compra a un proveedor no obligado:\n- **Factura Electrónica**: Emite el vendedor obligado a facturar\n- **Documento Soporte**: Emite el comprador para soportar su costo/deducción\n\n### 📌 2. CUDE vs CUFE\nLos Documentos Soporte generan un **CUDE** (Código Único de Documento Equivalente), NO un CUFE:\n- **CUFE**: Facturas electrónicas (96 caracteres)\n- **CUDE**: Documentos Soporte/Equivalentes (96 caracteres, similar formato)\n\n### 📌 3. El Rol de \"seller\" en Documento Soporte\nEn Documento Soporte, el campo \"seller\" representa al **PROVEEDOR** que vende (no obligado a facturar):\n- **NO es el comprador** (eso lo identifica el software/empresa emisora)\n- Datos del proveedor: identificación, nombre, contacto\n- Aunque en factura normal \"seller\" = empresa que vende obligadamente\n\n### 📌 4. type_document_id Obligatorio\nSiempre Especificar `type_document_id: 11` para Documentos Soporte. Otros valores:\n- `12`: Documento Equivalente (similar a soporte pero con variantes)\n- `13`: Nota de Ajuste de Documento Soporte (para anular/corregir)\n\n### 📌 5. Resolución 1876 DIAN\nEl campo `resolution_number` debe referenciarse al **Documento 1876** de la DIAN que autoriza el rango de numeración para documentos soporte. Este documento contiene:\n- Rango autorizado (desde-hasta)\n- Fecha de vigencia\n- Prefijo autorizado (ej: SEDS, DS, SOPORTE)\n- Debe registrarse previamente en Config Company\n\n### 📌 6. Consecutivos Monótonicos\nLos números de Documento Soporte deben ser **consecutivos sin saltos**:\n- 984000003, 984000004, 984000005... (correcto)\n- 984000003, 984000005, 984000007... (incorrecto, DIAN rechaza)\n- Si se requiere reiniciar, solicitar nueva resolución a DIAN\n\n### 📌 7. Proveedores No Obligados: Características\nEl proveedor (seller) **NO obligado a facturar** típicamente es:\n- Persona natural (sin registro mercantil)\n- Pequeño comerciante informal\n- Profesional independiente (honorarios)\n- Empresa extranjera sin sucursal en Colombia\n- Agricultor o productor primario\n\nSU `type_regime_id` usualmente es `1` (régimen simplificado) o `2` (común).\n\n### 📌 8. Fecha y Hora en Zona Bogotá\nLos campos `date` y `time` deben estar en zona horaria **America/Bogota** (UTC-5):\n- `date`: YYYY-MM-DD (ej: 2025-11-04)\n- `time`: HH:MM:SS en formato 24h (ej: 12:09:38)\n- No pueden ser mayores a 48 horas en el futuro\n\n### 📌 9. Impuestos en Documento Soporte\nLos impuestos son válidos (IVA 0%, 5%, 19%), pero algunos son particulares:\n- **IVA (tax_id: 1)**: Impuesto al Valor Agregado\n- **INC (tax_id: 4)**: Impuesto Nacional al Consumo (restaurantes, bares)\n- **IEPS (tax_id: 5)**: Impuesto Especial a Productos\n- En este ejemplo: 0% (sin IVA = base exenta)\n\n### 📌 10. Validación de Totales\nLa API valida que los totales cuadren:\n```\npayable_amount = line_extension_amount - descuentos + cargos + impuestos\n```\nSi no coinciden, rechaza con error 422 \"Totals do not match\".\n\n### 📌 11. Envío de Email (sendmail/sendmailtome)\nCampos opcionales para notificación:\n- `sendmail: true`: Envía PDF al email del proveedor (seller.email)\n- `sendmailtome: true`: Envía copia al email del emisor\n- Requiere configuración de mail.php en el sistema\n\n### 📌 12. Modalidades de Envío\n**Síncrono** (sin testSetId en URL):\n```\nPOST /api/ubl2.1/support-document\n```\n- Responde inmediatamente con CUDE\n- No consume set de pruebas\n- Válido en producción\n\n**Asíncrono** (con testSetId):\n```\nPOST /api/ubl2.1/support-document/{testSetId}\n```\n- Retorna zip_key para consulta posterior\n- Consume set de pruebas DIAN\n- Requiere consultar `/api/ubl2.1/status/zip/{zip_key}`\n\n### 📌 13. Referencia a Documento Original\nEl Documento Soporte **NO tiene** billing_reference (a diferencia de Notas de Ajuste). Es un documento independiente que soporta un gasto/costo en el período tributario.\n\n### 📌 14. Prefijo SEDS: Significado\nSEDS = **Soporte Electrónico de Documento Soporte** (nomenclatura DIAN). Otros prefijos válidos:\n- SEDS: Prefijo estándar\n- DS: Abreviatura documento soporte\n- Dep: Depósito/compra\n- SOPORTE: Completo\n\nEl prefijo se autoriza en la resolución 1876.\n\n### 📌 15. Casos de Uso Comunes\n- **Compras a vendedores informales**: Tienda de barrio, pequeño productor\n- **Servicios profesionales**: Consultor, asesor, instructor sin RUT\n- **Importaciones de terceros**: Compra a proveedor extranjero\n- **Gastos de representación**: Comidas de cliente sin factura formal\n- **Mercados locales**: Frutas, verduras, productos agrícolas\n- **Combustible y peajes**: Gasolinera informal, casetas sin factura\n- **Honorarios freelance**: Diseñador, traductor, programador independiente" }, "response": [] }, { "name": "SendISupportDocument -TestSetId Sencilla Con Descuento", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"number\": 984000004,\r\n\t\"type_document_id\": 11,\r\n\t\"date\": \"2025-11-04\",\r\n\t\"time\": \"12:09:38\",\r\n\t\"notes\": \"SIN OBSERVACIONES\",\r\n\t\"foot_note\": \"Modalidad de Emision de Facturas Electronicas: SOFTWARE PROPIO - Fabricante Software: TORRE SOFTWARE - Nit: 89008003-2\",\r\n\t\"sendmail\": false,\r\n\t\"sendmailtome\": false,\r\n\t\"resolution_number\": \"18760000001\",\r\n\t\"prefix\": \"SEDS\",\r\n \"establishment_name\": \"ALEXANDER OBANDO LONDOÑO\",\t\r\n\t\"seller\": {\r\n\t\t\"identification_number\": \"41946692\",\r\n \"dv\": \"6\",\r\n\t\t\"name\": \"ELIZABETH CARDONA VILLADA\",\r\n\t\t\"phone\": \"3226563672\",\r\n\t\t\"address\": \"LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n\t\t\"email\": \"elizabethcardonav@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000-00\",\r\n \"postal_zone_code\": 630001,\r\n\t\t\"type_document_identification_id\": 3,\r\n\t\t\"type_organization_id\": 2,\r\n\t\t\"municipality_id\": 820,\r\n\t\t\"type_liability_id\": 117,\r\n\t\t\"type_regime_id\": 1\r\n\t},\r\n \"payment_form\": {\r\n \"payment_form_id\": \"1\",\r\n \"payment_method_id\": \"42\",\r\n \"payment_due_date\": \"2025-11-04\",\r\n \"duration_measure\": \"0\"\r\n },\r\n \"allowance_charges\":\r\n [{\r\n \"discount_id\": 1,\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"Descuento general\",\r\n \"amount\": \"1.00\",\r\n \"base_amount\": \"10.00\"\r\n }\r\n ],\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"10.00\",\r\n \"tax_exclusive_amount\": \"0.00\",\r\n \"tax_inclusive_amount\": \"10.00\",\r\n \"allowance_total_amount\": \"1.00\",\r\n \"charge_total_amount\": \"0.00\",\r\n \"payable_amount\": \"9.00\"\r\n },\r\n \"invoice_lines\":\r\n [{\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1.00\",\r\n \"line_extension_amount\": \"10.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\":\r\n [{\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"Descuento general\",\r\n \"amount\": \"1.00\",\r\n \"base_amount\": \"10.00\"\r\n }\r\n ],\r\n \"description\": \"DSE EL676 PRUEBA\",\r\n \"code\": \"51959501\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"10.00\",\r\n \"base_quantity\": \"1\",\r\n \"type_generation_transmition_id\": 1,\r\n \"start_date\": \"2025-11-04\"\r\n }\r\n ]\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/support-document", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "support-document" ] }, "description": "# 📄 DOCUMENTO SOPORTE - CON DESCUENTO UNITARIO\n\n## 📄 Descripción General\n\nEste ejemplo demuestra un **Documento Soporte Electrónico** con **descuento general** aplicado a nivel de línea y nivel de documento. Muestra cómo reducir el monto a pagar mediante campos `allowance_charges` estructurados correctamente.\n\nEs frecuente otorgar descuentos en compras a proveedores no obligados (por cantidad, pronto pago, clientela, etc.), y el Documento Soporte debe reflejar estos descuentos de manera auditoria en el sistema de la DIAN.\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/support-document\n```\n\n**Características:**\n- Modo Síncrono (sin testSetId en URL)\n- Método de pago: **42 (PSE)** - Pago Electrónico\n- Descuentos: 1.00 unidad (10% de base 10.00)\n- Sin envío de email (sendmail: false)\n\n---\n\n## 🔑 Campos Principales\n\n### Datos del Documento\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **type_document_id** | 11 | Documento Soporte Electrónico |\n| **prefix** | SEDS | Prefijo autorizado |\n| **number** | 984000004 | Número consecutivo |\n| **resolution_number** | 18760000001 | Resolución DIAN 1876 |\n| **date** | 2025-11-04 | Fecha de emisión |\n| **time** | 12:09:38 | Hora de emisión (Bogotá UTC-5) |\n\n### Forma de Pago (payment_form)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **payment_form_id** | 1 | Contado |\n| **payment_method_id** | **42** | **PSE (Pago Electrónico)** |\n| **payment_due_date** | 2025-11-04 | Fecha de pago |\n\n**Tipos de Método de Pago Comunes:**\n- `1`: Efectivo\n- `2`: Cheque\n- `10`: Transferencia/Depósito bancario\n- `20`: Tarjeta de Débito\n- `30`: Tarjeta de Crédito\n- `42`: PSE (Sistema de Pagos Electrónicos)\n- `47`: Billetera digital\n\n---\n\n## 💳 Estructura de Descuentos (allowance_charges)\n\n### A Nivel de Documento (Bloque Principal)\n\n```json\n\"allowance_charges\": [{\n \"discount_id\": 1,\n \"charge_indicator\": false,\n \"allowance_charge_reason\": \"Descuento general\",\n \"amount\": \"1.00\",\n \"base_amount\": \"10.00\"\n}]\n```\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **discount_id** | 1 | Código descuento (1=por volumen, 2=comercial, etc.) |\n| **charge_indicator** | false | `false` = Descuento, `true` = Cargo |\n| **allowance_charge_reason** | Descuento general | Motivo legible para auditoría |\n| **amount** | 1.00 | Valor absoluto del descuento (no porcentaje) |\n| **base_amount** | 10.00 | Base sobre la cual se aplica |\n\n### A Nivel de Línea (invoice_lines)\n\nLa misma estructura se repite en cada línea de detalle:\n\n```json\n\"allowance_charges\": [{\n \"charge_indicator\": false,\n \"allowance_charge_reason\": \"Descuento general\",\n \"amount\": \"1.00\",\n \"base_amount\": \"10.00\"\n}]\n```\n\n---\n\n## 💰 Línea de Detalle con Descuento\n\n| Concepto | Valor | Descripción |\n|----------|-------|-------------| \n| **description** | DSE EL676 PRUEBA | Descripción del bien/servicio |\n| **code** | 51959501 | Código de identificación |\n| **unit_measure_id** | 70 | Unidad de medida (UNIDAD) |\n| **invoiced_quantity** | 1.00 | Cantidad |\n| **price_amount** | 10.00 | Precio unitario |\n| **line_extension_amount** | 10.00 | Subtotal línea (antes de desc) |\n| **allowance_charge (línea)** | 1.00 | Descuento en línea |\n| **base_quantity** | 1 | Cantidad base |\n\n---\n\n## 🧮 Cálculo de Totales CON Descuento\n\n| Concepto | Valor | Fórmula |\n|----------|-------|----------| \n| **Subtotal (line_extension_amount)** | 10,00 | 1 × 10 |\n| **Menos: Descuento General** | (1,00) | Base 10 × 10% |\n| **Subtotal Neto (tax_exclusive_amount)** | 9,00 | 10 - 1 |\n| **Impuesto (IVA 0%)** | 0,00 | 0% |\n| **Total con Impuesto** | 9,00 | 9 + 0 |\n| **PAYABLE_AMOUNT** | **9,00** | Monto a pagar |\n\n### Validación de legal_monetary_totals\n\n```json\n\"legal_monetary_totals\": {\n \"line_extension_amount\": \"10.00\",\n \"tax_exclusive_amount\": \"0.00\",\n \"tax_inclusive_amount\": \"10.00\",\n \"allowance_total_amount\": \"1.00\",\n \"charge_total_amount\": \"0.00\",\n \"payable_amount\": \"9.00\"\n}\n```\n\n- `allowance_total_amount`: Suma de todos los descuentos (1.00)\n- `charge_total_amount`: Suma de todos los cargos (0.00)\n- `payable_amount`: Debe cuadrar con: 10.00 - 1.00 + 0.00 = **9.00** ✓\n\n---\n\n## 📝 Notas Importantes sobre Descuentos en Documento Soporte\n\n### 📌 1. Descuentos: Valores Absolutos, NO Porcentajes\nLa API espera el **monto absoluto** del descuento, no el porcentaje:\n- ❌ INCORRECTO: `\"amount\": \"10\"` (significaría 10%)\n- ✓ CORRECTO: `\"amount\": \"1.00\"` (1.00 unidades de moneda)\n- La DIAN necesita el valor exacto para auditoría\n\n### 📌 2. Descuentos en Dos Niveles: Documento + Línea\nPuede haber descuentos en ambos niveles:\n- **allowance_charges (principal)**: Descuentos globales del documento\n- **allowance_charges (por línea)**: Descuentos específicos de cada línea\n- **Efecto acumulativo**: Se restan ambos para calcular el total\n\n### 📌 3. Razón del Descuento (allowance_charge_reason)\nEs obligatorio documentar por qué se descuenta:\n- \"Descuento por volumen\"\n- \"Pronto pago\"\n- \"Bonificación comercial\"\n- \"Descuento por cliente frecuente\"\n- \"Error en facturación anterior\"\n- Facilita auditoría interna y externa\n\n### 📌 4. Descuentos vs Cargos (charge_indicator)\nEl campo `charge_indicator` define el tipo:\n- `false`: Es un **descuento** (reduce el total)\n- `true`: Es un **cargo** (aumenta el total)\n- Ejemplo de cargo: Comisión, impuesto municipal, flete adicional\n\n### 📌 5. Diferencia: Descuento en Factura vs Documento Soporte\n**Factura Electrónica (type_document_id 1):**\n- Descuentos autorizados por DIAN (códigos standardizados)\n- Cliente ve el descuento en el PDF\n- Impacta el IVA y otros impuestos\n\n**Documento Soporte (type_document_id 11):**\n- Descuentos flexibles (cualquier razón empresarial)\n- El descuento se aplica al soporte de gasto/deducción\n- También impacta impuestos si aplican\n\n### 📌 6. Método de Pago 42 (PSE)\nPSE = **Plataforma de Pagos Electrónicos Segura**:\n- Sistema de transferencia instantánea en Colombia\n- Vinculación directa a cuenta bancaria\n- Usado para B2B, nómina, servicios\n- Requiere que el banco del pagador soporte PSE\n- En Documento Soporte: facilita trazabilidad de pagos\n\n### 📌 7. Validación de Descuentos por la DIAN\nEl Servicio Web de la DIAN valida:\n- ✓ Que `allowance_total_amount` = suma de todos descuentos\n- ✓ Que `payable_amount` = base - desc + cargos + imptos\n- ✓ Que no haya descuentos mayores que el subtotal (validación lógica)\n- ✗ Si NO cuadra: Error 422 \"Legal Monetary Totals do not match\"\n\n### 📌 8. Descuentos en Múltiples Líneas\nSi el documento tiene varias líneas, cada una puede tener descuento diferente:\n```json\n\"invoice_lines\": [\n {\n \"description\": \"Producto A\",\n \"line_extension_amount\": \"100.00\",\n \"allowance_charges\": [{\"amount\": \"10.00\"}]\n },\n {\n \"description\": \"Producto B\",\n \"line_extension_amount\": \"200.00\",\n \"allowance_charges\": [{\"amount\": \"20.00\"}]\n }\n]\n```\nTotal descuentos = 10 + 20 = 30.00\n\n### 📌 9. Descuentos Negativos (Efectivamente Cargos)\nTécnicamente, `amount: -1.00` con `charge_indicator: false` sería un cargo:\n- NO RECOMENDADO: Usar este truco\n- CORRECTO: Usar `charge_indicator: true` con `amount: 1.00`\n- Facilita lectura y auditoría\n\n### 📌 10. Sin Envío de Email en Este Ejemplo\n- `sendmail: false`: NO envía PDF al email del proveedor\n- `sendmailtome: false`: NO envía copia al emisor\n- Útil para pruebas o cuando se envía por otro medio\n- Si requiere notificación: cambiar a `true` (requiere mail.php configurado)\n\n### 📌 11. Documentación de Descuentos Auditoria\nGuardar en ERP:\n- Número de Documento Soporte (984000004)\n- CUDE generado por la DIAN\n- Motivo del descuento\n- Autorización (si requiere supervisión)\n- Referencia al contrato o acuerdo comercial\n\n### 📌 12. Cálculo Inverso: Porcentaje desde Valor Absoluto\nSi conoce el porcentaje, calcule:\n```\namount (absoluto) = base_amount × (porcentaje / 100)\nEjemplo: 10.00 × (10 / 100) = 1.00\n```\n\nEsta fórmula se invierte para validar:\n```\nporcentaje = (amount / base_amount) × 100\nEjemplo: (1.00 / 10.00) × 100 = 10%\n```\n\n### 📌 13. Integración con Contabilidad\nEn el registro contable del gasto:\n- Cuenta de Gasto: Monto neto pagado (9.00)\n- No se registra por separado descuento (ya está incluido)\n- La DIAN valida que descuentos sean coherentes con documentación\n\n### 📌 14. Casos de Uso de Descuentos en Documento Soporte\n- **Compra a minorista**: \"Pronto pago me deja en 9.00 en lugar de 10.00\"\n- **Negociación posterior**: \"Acordamos descuento por volumen: -1.00\"\n- **Corrección parcial**: \"Error en cantidad; descuentamos diferencia\"\n- **Liquidación de evento**: \"Descuento por compra de lote\"\n\n### 📌 15. Consistencia: allowance_total_amount Debe Cuadrar\n\nValidación crítica:\n\n```\nallowance_total_amount (2.00 en este ejemplo) debe ser:\nSuma de allowance_charges[].amount en nivel principal\n+ Suma de todos invoice_lines[x].allowance_charges[].amount\n= 1.00 (principal) + 1.00 (línea) = 2.00 ✓\n```\n\nSi no cuadra, la DIAN rechaza el documento." }, "response": [] }, { "name": "SendISupportDocument -TestSetId Sencilla Con Descuento Nro 2", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"number\": 984000005,\r\n\t\"type_document_id\": 11,\r\n\t\"date\": \"2025-11-04\",\r\n\t\"time\": \"12:09:38\",\r\n\t\"notes\": \"SIN OBSERVACIONES\",\r\n\t\"foot_note\": \"Modalidad de Emision de Facturas Electronicas: SOFTWARE PROPIO - Fabricante Software: TORRE SOFTWARE - Nit: 89008003-2\",\r\n\t\"sendmail\": false,\r\n\t\"sendmailtome\": false,\r\n\t\"resolution_number\": \"18760000001\",\r\n\t\"prefix\": \"SEDS\",\r\n \"establishment_name\": \"ALEXANDER OBANDO LONDOÑO\",\t\r\n\t\"seller\": {\r\n\t\t\"identification_number\": \"41946692\",\r\n \"dv\": \"6\",\r\n\t\t\"name\": \"ELIZABETH CARDONA VILLADA\",\r\n\t\t\"phone\": \"3226563672\",\r\n\t\t\"address\": \"LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n\t\t\"email\": \"elizabethcardonav@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000-00\",\r\n \"postal_zone_code\": 630001,\r\n\t\t\"type_document_identification_id\": 3,\r\n\t\t\"type_organization_id\": 2,\r\n\t\t\"municipality_id\": 820,\r\n\t\t\"type_liability_id\": 117,\r\n\t\t\"type_regime_id\": 1\r\n\t},\r\n \"payment_form\": {\r\n \"payment_form_id\": \"1\",\r\n \"payment_method_id\": \"20\",\r\n \"payment_due_date\": \"2025-11-04\",\r\n \"duration_measure\": \"0\"\r\n },\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"15997.00\",\r\n \"tax_exclusive_amount\": \"0.00\",\r\n \"tax_inclusive_amount\": \"15997.00\",\r\n \"allowance_total_amount\": \"0.00\",\r\n \"charge_total_amount\": \"0.00\",\r\n \"payable_amount\": \"15997.00\"\r\n },\r\n \"invoice_lines\":\r\n [{\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1.00\",\r\n \"line_extension_amount\": \"2660.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\":\r\n [{\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"Descuento por pronto pago\",\r\n \"amount\": \"140.00\",\r\n \"base_amount\": \"2800.00\"\r\n }\r\n ],\r\n \"description\": \"DSE EL680 PRUEBA SOPORTE PALMETTO\",\r\n \"code\": \"51251001\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"2800.00\",\r\n \"base_quantity\": \"1\",\r\n \"type_generation_transmition_id\": 1,\r\n \"start_date\": \"2025-11-04\"\r\n }, {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1.00\",\r\n \"line_extension_amount\": \"5158.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\":\r\n [{\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"Descuento por pronto pago\",\r\n \"amount\": \"272.00\",\r\n \"base_amount\": \"5430.00\"\r\n }\r\n ],\r\n \"description\": \"DSE EL680 PRUEBA SOPORTE PALMETTO\",\r\n \"code\": \"51251001\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"5430.00\",\r\n \"base_quantity\": \"1\",\r\n \"type_generation_transmition_id\": 1,\r\n \"start_date\": \"2025-11-04\"\r\n }, {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1.00\",\r\n \"line_extension_amount\": \"8179.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\":\r\n [{\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"Descuento por pronto pago\",\r\n \"amount\": \"431.00\",\r\n \"base_amount\": \"8610.00\"\r\n }\r\n ],\r\n \"description\": \"DSE EL680 PRUEBA SOPORTE PALMETTO\",\r\n \"code\": \"51251001\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"8610.00\",\r\n \"base_quantity\": \"1\",\r\n \"type_generation_transmition_id\": 1,\r\n \"start_date\": \"2025-11-04\"\r\n }\r\n ]\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/support-document", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "support-document" ] }, "description": "# 📄 DOCUMENTO SOPORTE - MULTI-LÍNEA CON DESCUENTOS PROPORCIONALES\n\n## 📄 Descripción General\n\nEste ejemplo demuestra un **Documento Soporte Electrónico** con **tres líneas de detalle**, cada una con **descuentos porcentuales distintos** aplicados a nivel de línea individual.\n\nEs la variante más común en operaciones complejas: compra a un proveedor no obligado de múltiples productos/servicios, cada uno con condiciones de descuento particulares (según cantidad, línea de negocios, acuerdo comercial, etc.).\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/support-document\n```\n\n**Características:**\n- Modo Síncrono\n- **3 líneas de detalle** con descuentos independientes\n- Método de pago: **20 (Tarjeta de Débito)**\n- Descuentos aplicados a nivel de línea (no a nivel de documento)\n- Total final: 15.997,00 COP\n\n---\n\n## 🔑 Campos Principales\n\n### Datos del Documento\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **type_document_id** | 11 | Documento Soporte |\n| **prefix** | SEDS | Prefijo |\n| **number** | 984000005 | Número consecutivo |\n| **resolution_number** | 18760000001 | Resolución 1876 |\n| **date** | 2025-11-04 | Fecha |\n| **time** | 12:09:38 | Hora |\n\n### Método de Pago (payment_form)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **payment_form_id** | 1 | Contado |\n| **payment_method_id** | **20** | **Tarjeta de Débito** |\n| **payment_due_date** | 2025-11-04 | Fecha |\n\n---\n\n## 📊 Estructura de Tres Líneas de Detalle\n\n### LÍNEA 1: Producto PALMETTO (Base 2.800,00)\n\n```json\n{\n \"description\": \"DSE EL680 PRUEBA SOPORTE PALMETTO\",\n \"code\": \"51251001\",\n \"unit_measure_id\": 70,\n \"invoiced_quantity\": \"1.00\",\n \"price_amount\": \"2800.00\",\n \"line_extension_amount\": \"2800.00\",\n \"allowance_charges\": [{\n \"charge_indicator\": false,\n \"allowance_charge_reason\": \"Descuento por pronto pago\",\n \"amount\": \"140.00\",\n \"base_amount\": \"2800.00\"\n }]\n}\n```\n\n**Cálculo Línea 1:**\n- Precio: 2.800,00\n- Descuento: 140,00 (5% de 2.800)\n- Neto: 2.660,00\n\n---\n\n### LÍNEA 2: Producto PALMETTO (Base 5.430,00)\n\n```json\n{\n \"description\": \"DSE EL680 PRUEBA SOPORTE PALMETTO\",\n \"code\": \"51251001\",\n \"unit_measure_id\": 70,\n \"invoiced_quantity\": \"1.00\",\n \"price_amount\": \"5430.00\",\n \"line_extension_amount\": \"5430.00\",\n \"allowance_charges\": [{\n \"charge_indicator\": false,\n \"allowance_charge_reason\": \"Descuento por pronto pago\",\n \"amount\": \"272.00\",\n \"base_amount\": \"5430.00\"\n }]\n}\n```\n\n**Cálculo Línea 2:**\n- Precio: 5.430,00\n- Descuento: 272,00 (5% de 5.430)\n- Neto: 5.158,00\n\n---\n\n### LÍNEA 3: Producto PALMETTO (Base 8.610,00)\n\n```json\n{\n \"description\": \"DSE EL680 PRUEBA SOPORTE PALMETTO\",\n \"code\": \"51251001\",\n \"unit_measure_id\": 70,\n \"invoiced_quantity\": \"1.00\",\n \"price_amount\": \"8610.00\",\n \"line_extension_amount\": \"8610.00\",\n \"allowance_charges\": [{\n \"charge_indicator\": false,\n \"allowance_charge_reason\": \"Descuento por pronto pago\",\n \"amount\": \"431.00\",\n \"base_amount\": \"8610.00\"\n }]\n}\n```\n\n**Cálculo Línea 3:**\n- Precio: 8.610,00\n- Descuento: 431,00 (5% de 8.610)\n- Neto: 8.179,00\n\n---\n\n## 🧮 Cálculo de Totales Multi-Línea\n\n| Concepto | Línea 1 | Línea 2 | Línea 3 | Total |\n|----------|---------|---------|---------|-------| \n| **Precio Unitario** | 2.800,00 | 5.430,00 | 8.610,00 | 16.840,00 |\n| **Menos: Descuento (5%)** | (140,00) | (272,00) | (431,00) | (843,00) |\n| **Neto por Línea** | 2.660,00 | 5.158,00 | 8.179,00 | 15.997,00 |\n\n### legal_monetary_totals Final\n\n```json\n\"legal_monetary_totals\": {\n \"line_extension_amount\": \"16840.00\",\n \"tax_exclusive_amount\": \"0.00\",\n \"tax_inclusive_amount\": \"16840.00\",\n \"allowance_total_amount\": \"843.00\",\n \"charge_total_amount\": \"0.00\",\n \"payable_amount\": \"15997.00\"\n}\n```\n\n**Validación:**\n- `line_extension_amount`: 2.800 + 5.430 + 8.610 = 16.840,00 ✓\n- `allowance_total_amount`: 140 + 272 + 431 = 843,00 ✓\n- `payable_amount`: 16.840 - 843 = 15.997,00 ✓\n\n---\n\n## 📝 Notas Importantes sobre Multi-Línea con Descuentos\n\n### 📌 1. Descuentos Independientes por Línea\nCada línea tiene su propio bloque `allowance_charges`:\n- Línea 1: 140,00 (descuento 1)\n- Línea 2: 272,00 (descuento 2)\n- Línea 3: 431,00 (descuento 3)\n- **NO hay allowance_charges a nivel de encabezado** (es decir, nivel principal del documento)\n- Esto es diferente del ejemplo anterior que tenía descuentos en ambos niveles\n\n### 📌 2. Razón del Descuento: Consistencia Recomendada\nEn este ejemplo, todas las líneas usan la misma razón:\n```\n\"Descuento por pronto pago\"\n```\n\nPueden ser diferentes si aplica:\n```\nLínea 1: \"Descuento por volumen\"\nLínea 2: \"Descuento por volumen\"\nLínea 3: \"Descuento por cliente frecuente\"\n```\n\n### 📌 3. Porcentaje vs Valor Absoluto: Cálculo de 5%\n\nPara 5% en cada línea:\n- Línea 1: 2.800 × 0.05 = 140,00 ✓\n- Línea 2: 5.430 × 0.05 = 271,50 ≈ 272,00 (redondeo)\n- Línea 3: 8.610 × 0.05 = 430,50 ≈ 431,00 (redondeo)\n\nLa DIAN acepta redondeos por centavos.\n\n### 📌 4. Método de Pago 20 (Tarjeta de Débito)\nEste ejemplo usa `payment_method_id: 20`, que significa:\n- Pago con tarjeta de débito\n- Transferencia inmediata de fondos\n- Disponible en la mayoría de bancos colombianos\n- Diferente del PSE (42) que requiere autenticación en portal del banco\n\n### 📌 5. Validación de allowance_total_amount\nCrítica para aprobación DIAN:\n\n```\nallowance_total_amount debe ser:\nSuma de invoice_lines[0].allowance_charges[].amount\n+ invoice_lines[1].allowance_charges[].amount\n+ invoice_lines[2].allowance_charges[].amount\n\n= 140.00 + 272.00 + 431.00 = 843.00 ✓\n```\n\nSi la DIAN cuenta 843,00 pero el JSON dice 843,01, rechaza el documento.\n\n### 📌 6. Sin Descuentos a Nivel de Documento\nEste ejemplo NO tiene `allowance_charges` en el nivel principal:\n\n```json\n// ESTO NO EXISTE EN ESTE EJEMPLO:\n// \"allowance_charges\": [{...}] // <-- No hay aquí\n\n// LOS DESCUENTOS ESTÁN SOLO EN LÍNEAS:\ninvoice_lines: [\n { \"allowance_charges\": [{...}] },\n { \"allowance_charges\": [{...}] },\n { \"allowance_charges\": [{...}] }\n]\n```\n\nEsto es una variante válida y muy usada en operaciones complejas.\n\n### 📌 7. Comparación: Descuentos en Documento vs Líneas\n\n**OPCIÓN A: Descuento en Documento (ejemplo 2)**\n```json\n\"allowance_charges\": [{\"amount\": \"1.00\"}], // Nivel principal\n\"invoice_lines\": [{\n \"allowance_charges\": [{\"amount\": \"1.00\"}] // Y en línea\n}]\n```\n- Descuento total: 2,00\n- Usado cuando hay descuentos mixtos (global + por línea)\n\n**OPCIÓN B: Descuentos Solo en Líneas (este ejemplo)**\n```json\n// NO hay allowance_charges en nivel principal\n\"invoice_lines\": [\n {\"allowance_charges\": [{\"amount\": \"140.00\"}]},\n {\"allowance_charges\": [{\"amount\": \"272.00\"}]},\n {\"allowance_charges\": [{\"amount\": \"431.00\"}]}\n]\n```\n- Descuento total: 843,00 (suma de líneas)\n- Usado cuando cada línea tiene su descuento específico\n\n### 📌 8. Redondeo de Cálculos\nEn operaciones con dinero:\n- La DIAN acepta variaciones por centavos (máx ±0,01 por línea)\n- Si usa 5% en varias líneas, redondee a 2 decimales\n- Valide que la suma cuadre (843,00 exacto)\n\n### 📌 9. Auditoria de Multi-Línea\nGuardar en ERP:\n- Número de Documento Soporte: 984000005\n- 3 líneas de detalle con sus descuentos\n- CUDE generado\n- Método de pago: Tarjeta de Débito\n- Total descuentos: 843,00\n- Total a pagar: 15.997,00\n\n### 📌 10. Tarjeta de Débito vs Crédito\n\n| Aspecto | Débito (20) | Crédito (30) |\n|---------|------------|-------------|\n| Fondos | Inmediatos | A 30-60 días |\n| Cuota | No | Sí |\n| Intereses | No | Sí (si aplica) |\n| Rechazo | Por fondos insuficientes | Por límite |\n| En Documento Soporte | Válido (crédito 0 días) | Válido (múltiples cuotas) |\n\n### 📌 11. XML Generado para Multi-Línea\nCada línea genera un nodo ``:\n\n```xml\n\n 1\n 1.00\n 2800.00\n \n false\n Descuento por pronto pago\n 140.00\n 2800.00\n \n \n DSE EL680 PRUEBA SOPORTE PALMETTO\n \n 51251001\n \n \n \n 2800.00\n \n\n```\n\n### 📌 12. Casos de Uso: Cuándo Usar Multi-Línea\n- **Compra de servicios variados**: Consultoría (línea 1), viáticos (línea 2), materiales (línea 3)\n- **Compra de productos mixtos**: Insumo A, Insumo B, Insumo C (cada uno con descuento diferente)\n- **Reparaciones y mantenimiento**: Labor (línea 1), repuestos (línea 2), servicio (línea 3)\n- **Eventos y catering**: Alquiler salón, comida, bebidas (descuentos distintos)\n\n### 📌 13. Validación Automatizada de Descuentos\nLa DIAN valida automáticamente:\n- ✓ Que cada `line_extension_amount` = `price_amount` × `invoiced_quantity`\n- ✓ Que cada descuento ≤ línea_extension_amount\n- ✓ Que `allowance_total_amount` = suma de todos descuentos\n- ✓ Que `payable_amount` cuadre exactamente\n\n### 📌 14. Descuentos No Deben Ser Negativos\nEn líneas de \"crédito\" o \"devolución\":\n- NO usar: `\"amount\": \"-843.00\"` (descuento negativo)\n- SÍ usar: `\"charge_indicator\": true` con `\"amount\": \"843.00\"` (cargo positivo)\n- Facilita auditoria y es coherente con estructura XML\n\n### 📌 15. Total Descuentos: 843,00 es Crítico\nEn este ejemplo:\n- Si intenta enviar 842,99 o 843,01: La DIAN rechaza\n- Si intenta enviar 843,00: Aprobado ✓\n- La validación es **exacta**, no por rangos\n- Por eso es importante redondear correctamente (≤2 decimales)" }, "response": [] }, { "name": "SendISupportDocument -TestSetId Sencilla No Residente", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"number\": 984000006,\r\n\t\"type_document_id\": 11,\r\n\t\"date\": \"2025-11-04\",\r\n\t\"time\": \"12:09:38\",\r\n\t\"notes\": \"SIN OBSERVACIONES\",\r\n\t\"foot_note\": \"Modalidad de Emision de Facturas Electronicas: SOFTWARE PROPIO - Fabricante Software: TORRE SOFTWARE - Nit: 89008003-2\",\r\n\t\"sendmail\": true,\r\n\t\"sendmailtome\": true,\r\n\t\"resolution_number\": \"18760000001\",\r\n\t\"prefix\": \"SEDS\",\r\n \"establishment_name\": \"ALEXANDER OBANDO LONDOÑO\",\t\r\n \"type_operation_id\": 24,\r\n\t\"seller\": {\r\n\t\t\"identification_number\": \"899212809099911\",\r\n \"dv\": \"0\",\r\n\t\t\"name\": \"BLANCA NUBIA ALVAREZ ALZATE \",\r\n\t\t\"phone\": \"3148931130\",\r\n\t\t\"address\": \"CR 14 BIS 31 B 37 BRR SAN NICOLAS\",\r\n\t\t\"email\": \"blancanubiaa@hotmail.com\",\r\n\t\t\"merchant_registration\": \"0000-00\",\r\n\t\t\"type_document_identification_id\": 8,\r\n\t\t\"type_organization_id\": 2,\r\n \"country_id\": 65,\r\n \"municipality_name\": \"MIAMI\",\r\n \"state_name\": \"FLORIDA\",\r\n\t\t\"type_liability_id\": 117,\r\n\t\t\"type_regime_id\": 2,\r\n \"postal_zone_code\": \"630001\"\r\n\t},\r\n\t\"payment_form\": {\r\n\t\t\"payment_form_id\": 2,\r\n\t\t\"payment_method_id\": 10,\r\n\t\t\"payment_due_date\": \"2025-12-04\",\r\n\t\t\"duration_measure\": \"30\"\r\n\t},\t\r\n\t\"allowance_charges\": [\r\n\t\t{\r\n\t\t\t\"discount_id\": 10,\r\n\t\t\t\"charge_indicator\": false,\r\n\t\t\t\"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n\t\t\t\"amount\": \"0.00\",\r\n\t\t\t\"base_amount\": \"200.00\"\r\n\t\t}\r\n\t],\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"200.00\",\r\n\t\t\"tax_exclusive_amount\": \"200.00\",\r\n\t\t\"tax_inclusive_amount\": \"200.00\",\r\n\t\t\"allowance_total_amount\": \"0.00\",\r\n\t\t\"charge_total_amount\": \"0.00\",\r\n\t\t\"payable_amount\": \"200.00\"\r\n\t},\r\n\t\"tax_totals\": \r\n\t[\r\n\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"0.00\",\r\n\t\t\t\"percent\": \"0\",\r\n\t\t\t\"taxable_amount\": \"200.00\"\r\n\t\t}\r\n\t\r\n\t],\r\n\t\"invoice_lines\": \r\n\t[\r\n\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"2.00\",\r\n\t\t\t\"line_extension_amount\": \"200.00\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"allowance_charges\": [{\r\n\t\t\t\t\t\"charge_indicator\": false,\r\n\t\t\t\t\t\"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n\t\t\t\t\t\"amount\": \"0.00\",\r\n\t\t\t\t\t\"base_amount\": \"200.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"tax_totals\": \r\n\t\t\t[{\r\n\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\"tax_amount\": \"0.00\",\r\n\t\t\t\t\"percent\": \"0.00\",\r\n\t\t\t\t\"taxable_amount\": \"200.00\"\r\n\t\t\t}],\r\n\t\t\t\"description\": \"ARTICULO DE PRUEBAS\",\r\n \"notes\": \"\",\r\n\t\t\t\"code\": \"PRUEBA\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"100.00\",\r\n\t\t\t\"base_quantity\": \"2.00\",\r\n\t\t \"type_generation_transmition_id\": 1,\r\n\t\t\t\"start_date\": \"2025-11-04\"\r\n\t\t}\r\n\r\n\t]\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/support-document", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "support-document" ] }, "description": "# 📄 DOCUMENTO SOPORTE - PROVEEDOR NO RESIDENTE (EXTRANJERO)\n\n## 📄 Descripción General\n\nEste ejemplo demuestra cómo registrar un **Documento Soporte Electrónico** cuando el **proveedor (seller) NO reside en Colombia** (es una persona natural o empresa extranjera).\n\nEs muy común que empresas colombianas compren servicios a proveedores extranjeros (consultoría, software, licencias, etc.). El Documento Soporte permite documentar estos gastos para deducibilidad fiscal, especialmente para operaciones de importación o servicios técnicos desde el exterior.\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/support-document\n```\n\n**Características:**\n- Proveedor: Extranjero (USA)\n- `type_operation_id: 24` (Operación con no residente)\n- Pago a **30 días** (modalidad crédito)\n- Envío de email activado (sendmail: true, sendmailtome: true)\n- Importación de servicios internacionales\n\n---\n\n## 🔑 Campos Clave del Documento\n\n### Datos del Documento\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **type_document_id** | 11 | Documento Soporte |\n| **type_operation_id** | **24** | **Operación con No Residente** |\n| **prefix** | SEDS | Prefijo |\n| **number** | 984000006 | Número consecutivo |\n| **resolution_number** | 18760000001 | Resolución 1876 |\n| **date** | 2025-11-04 | Fecha de operación |\n| **time** | 12:09:38 | Hora (Bogotá UTC-5) |\n\n---\n\n## 🏢 Datos del Proveedor NO RESIDENTE (seller)\n\n### Identificación Internacional\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **identification_number** | 899212809099911 | Número de Pasaporte/ID extranjero |\n| **dv** | 0 | Dígito verificador (si aplica) |\n| **type_document_identification_id** | **8** | **Pasaporte/Documento Internacional** |\n| **name** | BLANCA NUBIA ALVAREZ ALZATE | Nombre del proveedor |\n| **type_organization_id** | 2 | Persona natural |\n\n### Ubicación Internacional\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **country_id** | **65** | **Estados Unidos (USA)** |\n| **municipality_name** | **MIAMI** | Municipio/ciudad (texto libre) |\n| **state_name** | **FLORIDA** | Estado/provincia (texto libre) |\n| **address** | CR 14 BIS 31 B 37 BRR SAN NICOLAS | Dirección |\n| **postal_zone_code** | 630001 | Código postal (formato local) |\n\n### Contacto Internacional\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **phone** | 3148931130 | Teléfono (puede ser prefijo +1 para USA) |\n| **email** | blancanubiaa@hotmail.com | Email de notificación |\n\n### Régimen Fiscal Extranjero\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **type_liability_id** | 117 | No responsable de IVA (en Colombia) |\n| **type_regime_id** | 2 | Régimen común (el que aplica en su país) |\n| **merchant_registration** | 0000-00 | Matrícula mercantil (N/A para extranjero) |\n\n---\n\n## 💳 Modalidad de Pago: A 30 Días\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **payment_form_id** | **2** | **Crédito** (pago diferido) |\n| **payment_method_id** | 10 | Transferencia bancaria |\n| **payment_due_date** | 2025-12-04 | Vencimiento (30 días después) |\n| **duration_measure** | 30 | Plazo en días |\n\n---\n\n## 💰 Línea de Detalle: Servicio de Consultoría Extranjera\n\n| Concepto | Valor | Descripción |\n|----------|-------|-------------| \n| **description** | ARTICULO DE PRUEBAS | Servicio adquirido |\n| **code** | PRUEBA | Código interno |\n| **unit_measure_id** | 70 | Unidad de medida (UNIDAD) |\n| **invoiced_quantity** | 2.00 | Cantidad (ej: 2 horas/sesiones) |\n| **price_amount** | 100.00 | Precio unitario |\n| **line_extension_amount** | 200.00 | Subtotal (2 × 100) |\n| **type_item_identification_id** | 4 | Código de producto/servicio |\n| **type_generation_transmition_id** | 1 | Tipo de generación estándar |\n| **start_date** | 2025-11-04 | Fecha de prestación |\n\n---\n\n## 🧮 Cálculo de Totales: Servicio Internacional\n\n| Concepto | Valor | Nota |\n|----------|-------|------| \n| **Cantidad** | 2.00 | Unidades de servicio |\n| **Precio Unitario** | 100,00 | USD o COP |\n| **Subtotal** | 200,00 | 2 × 100 |\n| **Descuento** | 0,00 | No aplica |\n| **Base IVA** | 200,00 | Base gravable |\n| **IVA (0%)** | 0,00 | No se cobra IVA a extranjero |\n| **PAYABLE_AMOUNT** | **200,00** | Total a pagar |\n\n### Notas en legal_monetary_totals\n\n```json\n\"legal_monetary_totals\": {\n \"line_extension_amount\": \"200.00\",\n \"tax_exclusive_amount\": \"200.00\",\n \"tax_inclusive_amount\": \"200.00\",\n \"allowance_total_amount\": \"0.00\",\n \"charge_total_amount\": \"0.00\",\n \"payable_amount\": \"200.00\"\n}\n```\n\n- Sin descuentos (allowance_total_amount: 0.00)\n- Sin cargos adicionales (charge_total_amount: 0.00)\n- IVA 0% (impuesto sobre importación de servicios)\n\n---\n\n## 📝 Notas Importantes: Documento Soporte con No Residente\n\n### 📌 1. type_operation_id: 24 es Obligatorio\nIdentifica que la operación involucra un **no residente**:\n\n| Código | Descripción | Aplica |\n|--------|-------------|--------| \n| 1 | Venta de mercancías | No residente ✗ |\n| 8 | Suministro de servicios | No residente ✓ |\n| 10 | Importación de servicios | No residente ✓ |\n| **24** | **Operación No Residente** | **Siempre usar** |\n| 30 | Compra a no obligado | No residente ✓ |\n\n**Si olvida type_operation_id: 24**, la DIAN puede rechazar el documento.\n\n### 📌 2. country_id: Código del País del Proveedor\n\nCódigos principales de países (ISO 3166-1):\n\n| country_id | País | Sigla |\n|-----------|------|-------| \n| 3 | Albania | AL |\n| 7 | Argentina | AR |\n| 14 | Bahamas | BS |\n| 26 | Brasil | BR |\n| **65** | **Estados Unidos** | **US** |\n| 72 | Canadá | CA |\n| 76 | China | CN |\n| 100 | España | ES |\n| 108 | Francia | FR |\n| 124 | India | IN |\n| 156 | Italia | IT |\n| 170 | México | MX |\n| 191 | Paraguay | PY |\n| 218 | Reino Unido | GB |\n\nEl `country_id: 65` corresponde a **USA**.\n\n### 📌 3. type_document_identification_id: 8 para Documentos Extranjeros\n\n| Código | Tipo de Documento | Uso |\n|--------|------|-----| \n| 3 | Cédula Colombiana | Residente (cédula local) |\n| 4 | Tarjeta de Identidad | Residente (ID colombiano) |\n| 5 | Cédula de Extranjería | Residente (extranjero en Col) |\n| **8** | **Pasaporte/ID Internacional** | **No Residente (en su país)** |\n| 6 | NIT | Empresa registrada |\n\nUse `type_document_identification_id: 8` para pasaportes o documentos de identificación del país de origen.\n\n### 📌 4. municipality_name y state_name: Texto Libre\n\nPara **no residentes**, NO use `municipality_id` (que es código DANE de Colombia).\n\nEn su lugar, use texto libre:\n\n```json\n\"municipality_name\": \"MIAMI\", // Texto: ciudad donde está\n\"state_name\": \"FLORIDA\", // Texto: estado/provincia\n\n// NO use:\n// \"municipality_id\": 820, // Esto es para Colombia\n```\n\nEsto permite registrar ubicaciones internacionales sin codificación DANE.\n\n### 📌 5. IVA en Operaciones con No Residentes\n\nPrincipios generales:\n\n| Escenario | IVA | Justificación |\n|-----------|-----|----------------| \n| Compra a residente obligado | 19% o 5% | IVA estándar |\n| Compra a no obligado (informal en Col) | 0% | No hay IVA en soporte |\n| Compra a no residente en USA | **0%** | **Exención exportación servicios** |\n| Importación de servicios | 0%-19% | Según tipo (información técnica 0%, licencias 0-19%) |\n\nEn este ejemplo: **0% de IVA** porque es servicio desde extranjero.\n\n### 📌 6. Válida: Envío de Email a Extranjero\n\nEn este ejemplo:\n- `sendmail: true` → Envía PDF al email del proveedor extranjero\n- `sendmailtome: true` → Envía copia al emisor (empresa colombiana)\n- Email destino: `blancanubiaa@hotmail.com` (puede ser desde cualquier país)\n\nLa API DIAN soporta emails internacionales sin restricción.\n\n### 📌 7. Formato de Teléfono Internacional\n\nEn `seller.phone`:\n- Actual: `3148931130` (sin prefijo internacional)\n- Mejor: `+13148931130` (con prefijo +1 para USA)\n- Aceptado: Ambos formatos (la DIAN es flexible)\n\nPara operaciones recurrentes, use prefijo `+` para claridad de auditoria.\n\n### 📌 8. Modalidad de Pago: Crédito a 30 Días\n\nEste ejemplo usa `payment_form_id: 2` (crédito):\n\n```json\n\"payment_form\": {\n \"payment_form_id\": 2, // Crédito (no contado)\n \"payment_method_id\": 10, // Transferencia bancaria\n \"payment_due_date\": \"2025-12-04\", // Vencimiento\n \"duration_measure\": \"30\" // Plazo en días\n}\n```\n\n**Interpretación:**\n- Documento emitido: 2025-11-04\n- Vencimiento: 2025-12-04\n- Plazo: 30 días\n- Se espera pago en 30 días (común en transacciones internacionales)\n\n### 📌 9. Impuestos: Declarar Incluso si son 0%\n\nObligatorio incluir `tax_totals` aun sin IVA:\n\n```json\n\"tax_totals\": [{\n \"tax_id\": 1,\n \"tax_amount\": \"0.00\", // Monto de IVA (cero)\n \"percent\": \"0\", // Porcentaje (0%)\n \"taxable_amount\": \"200.00\" // Base gravable\n}]\n```\n\n**Nunca omita `tax_totals`** aunque sea 0%. La DIAN valida que exista.\n\n### 📌 10. Diferencia: No Residente vs Residente Informal\n\n| Aspecto | Residente Informal | No Residente |\n|---------|---|---| \n| **country_id** | 47 (Colombia) | 65 (USA, etc.) |\n| **municipality_id** | Código DANE | NO se usa |\n| **municipality_name** | No necesario | MIAMI |\n| **type_operation_id** | 1-30 (según tipo) | **24 (No Residente)** |\n| **type_document_identification_id** | 3-6 (local) | **8 (Extranjero)** |\n| **IVA** | 0% o 19% | Usualmente 0% |\n| **Transferencia** | Dentro de Colombia | Internacional (swift, etc.) |\n\n### 📌 11. Validación DIAN para No Residente\n\nLa DIAN valida:\n- ✓ Que `country_id` sea válido\n- ✓ Que si `country_id ≠ 47`, entonces `type_operation_id = 24`\n- ✓ Que `municipality_name` y `state_name` estén diligenciados (texto)\n- ✓ Que `type_document_identification_id = 8` para extranjeros\n- ✓ Que no haya `municipality_id` cuando `country_id ≠ 47`\n- ✓ Que `tax_totals` exista (aunque IVA sea 0%)\n\n### 📌 12. Auditoría de Compras a Extranjeros\n\nGuardar en ERP:\n- Número de Documento Soporte: 984000006\n- CUDE generado\n- Datos proveedor: Blanca Nubia Alvarez (USA)\n- Monto: 200,00 COP\n- Modalidad pago: Transferencia a 30 días\n- Justificación: Servicio internacional de consultoría\n- Email confirmación: blancanubiaa@hotmail.com\n\n### 📌 13. Equivalencia de Moneda\n\nEn el JSON, todas las cantidades están en COP (Pesos Colombianos):\n- Si el proveedor cotiza en USD, **convierta a COP** antes de enviar\n- Ejemplo: 100 USD × 4.000 COP/USD = 400.000 COP (use este valor)\n- La DIAN espera moneda local (COP) en `legal_monetary_totals`\n\n### 📌 14. Casos de Uso Comunes: Compras a Extranjeros\n\n- **Software/SaaS**: Licencias de empresas USA, licencias cloud\n- **Consultoría técnica**: Asesoría de especialistas internacionales\n- **Capacitación**: Cursos online de proveedores extranjeros\n- **Licencias intelectuales**: Marcas, patentes, derechos de autor\n- **Servicios financieros**: Auditoría, contabilidad internacional\n- **Importación de servicios**: Hosting, dominios, APIs externas\n\n### 📌 15. CUDE vs CUFE en Documento Soporte a Extranjeros\n\nDocumento Soporte **SIEMPRE genera CUDE**, igual que en otros Documentos Soporte:\n- **CUDE**: Código Único de Documento Equivalente (96 caracteres)\n- No es CUFE (que es para facturas)\n- Se incluye en la respuesta del API: `{\"cuds\": \"...CUDE...\"}`\n- Es el identificador único ante DIAN para este documento soporte\n- Válido para auditoría interna y externa" }, "response": [] }, { "name": "Nota Ajuste Documento Soporte", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"billing_reference\": {\r\n\t\t\"number\": \"SEDS3\",\r\n\t\t\"uuid\": \"0b156c027e3116e4ff96c24f6c03a62e1c7fde27a6137e54bd2827a47b6c3cd6ef3f1e3b13b7919784eb63cb6d0406fe\",\r\n\t\t\"issue_date\": \"2022-09-01\"\r\n\t},\r\n\t\"discrepancyresponsecode\": 2,\r\n\t\"discrepancyresponsedescription\": \"PRUEBA DE MOTIVO NOTA CREDITO\",\r\n \"notes\": \"PRUEBA DE NOTA CREDITO\",\r\n \"prefix\": \"NDS\",\r\n\t\"number\": 4,\r\n\t\"type_document_id\": 13,\r\n\t\"date\": \"2025-11-04\",\r\n\t\"time\": \"06:00:13\",\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"sendmail\": true,\r\n \"sendmailtome\": true,\r\n \"seze\": \"2021-2017\",\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n\t\"seller\": {\r\n\t\t\"identification_number\": \"41946692\",\r\n \"dv\": \"6\",\r\n\t\t\"name\": \"ELIZABETH CARDONA VILLADA\",\r\n\t\t\"phone\": \"3226563672\",\r\n\t\t\"address\": \"LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n\t\t\"email\": \"elizabethcardonav@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000-00\",\r\n \"postal_zone_code\": 630001,\r\n\t\t\"type_document_identification_id\": 3,\r\n\t\t\"type_organization_id\": 2,\r\n\t\t\"municipality_id\": 820,\r\n\t\t\"type_liability_id\": 117,\r\n\t\t\"type_regime_id\": 1\r\n\t},\r\n \t\"tax_totals\": [{\r\n\t\t\"tax_id\": 1,\r\n\t\t\"tax_amount\": \"0.00\",\r\n\t\t\"taxable_amount\": \"200.00\",\r\n\t\t\"percent\": \"0.00\"\r\n\t}],\r\n \"allowance_charges\": [{\r\n \"discount_id\": 1,\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"200.00\"\r\n }],\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"200.00\",\r\n \"tax_exclusive_amount\": \"200.00\",\r\n \"tax_inclusive_amount\": \"200.00\",\r\n \"allowance_total_amount\": \"0.00\",\r\n \"charge_total_amount\": \"0.00\",\r\n \"payable_amount\": \"200.00\"\r\n },\r\n\t\"credit_note_lines\": [{\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"200.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [{\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"200.00\"\r\n }],\r\n \t\"tax_totals\": [{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"0.00\",\r\n\t\t\t\"taxable_amount\": \"200.00\",\r\n\t\t\t\"percent\": \"0.00\"\r\n\t\t}],\r\n \"description\": \"COMISION POR SERVICIOS\",\r\n \"code\": \"COMISION\",\r\n\t\t\"brandname\": \"FULLFIT\",\r\n \t\"modelname\": \"1088\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"200.00\",\r\n \"base_quantity\": \"1\"\r\n }]\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/sd-credit-note/01234567890-abcdefghijk", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "sd-credit-note", "01234567890-abcdefghijk" ] }, "description": "# 📄 NOTA DE AJUSTE DE DOCUMENTO SOPORTE (CRÉDITO/ANULACIÓN)\n\n## 📄 Descripción General\n\nEste ejemplo demuestra cómo emitir una **Nota de Ajuste de Documento Soporte** (`type_document_id: 13`) para anular, corregir o devolver un Documento Soporte (`type_document_id: 11`) previamente emitido.\n\nEs un documento de **ajuste inverso** que permite:\n- **Anular totalmente** un Documento Soporte emitido por error\n- **Devolver parcialmente** bienes/servicios adquiridos\n- **Corregir discrepancias** encontradas después de la emisión\n\nLa Nota de Ajuste referencia el documento original mediante `billing_reference` (número, UUID/CUDE, fecha) y especifica el motivo mediante `discrepancyresponsecode`.\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/sd-credit-note/{TestSetId}\n```\n\n**Características:**\n- Tipo: Nota de Crédito de Documento Soporte\n- Referencia: Documento Soporte original (SEDS3, CUDE...)\n- Motivo: Código de discrepancia (1=anulación, 2=devolución, etc.)\n- Efecto: Revierte/Anula el documento original\n\n---\n\n## 🔑 Campos Principales\n\n### Datos del Documento de Ajuste\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **type_document_id** | **13** | **Nota de Ajuste/Crédito** |\n| **prefix** | NDS | Prefijo para Notas de Documento Soporte |\n| **number** | 4 | Número consecutivo de la nota |\n| **date** | 2025-11-04 | Fecha de emisión de la nota |\n| **time** | 06:00:13 | Hora de emisión |\n\n### Referencia al Documento Original (billing_reference)\n\n**Estructura crítica para vincular la nota al documento original:**\n\n```json\n\"billing_reference\": {\n \"number\": \"SEDS3\",\n \"uuid\": \"0b156c027e3116e4ff96c24f6c03a62e1c7fde27a6137e54bd2827a47b6c3cd6ef3f1e3b13b7919784eb63cb6d0406fe\",\n \"issue_date\": \"2022-09-01\"\n}\n```\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **number** | SEDS3 | Identificador completo (prefix + consecutivo) del documento original |\n| **uuid** | 0b156c027... (96 caracteres) | **CUDE** del Documento Soporte original |\n| **issue_date** | 2022-09-01 | Fecha de emisión del documento original |\n\n**Nota Importante:** El `uuid` es el **CUDE** devuelto en la respuesta del Documento Soporte original. Debe ser exacto o la DIAN rechaza la nota.\n\n---\n\n## 🎯 Motivo del Ajuste: Códigos de Discrepancia\n\n### discrepancyresponsecode\n\n| Código | Significado | Uso | Efecto |\n|--------|------------|-----|--------| \n| **1** | **Anulación** | Error administrativo en documento original | Revierte completamente; NO hay devolución de bienes |\n| **2** | **Devolución** | Cliente devuelve bienes/rechaza servicio | Revierte parcial/total; cliente regresa producto |\n| **3** | Corrección de precio | Diferencia de precio descubierta | Ajusta solo monto |\n| **4** | Rectificación | Corrección de datos administrativos | Enmienda datos |\n| **5** | Descuento por error | Descuento no registrado originalmente | Rebaja posterior |\n\nEn este ejemplo: **discrepancyresponsecode: 2** (Devolución)\n\n### discrepancyresponsedescription\n\nDescripción legible del motivo:\n```\n\"discrepancyresponsedescription\": \"PRUEBA DE MOTIVO NOTA CREDITO\"\n```\n\nPuede ser:\n- \"Cliente devuelve artículo defectuoso\"\n- \"Error en cantidad facturada\"\n- \"Anulación por error administrativo\"\n- \"Devolución de servicio no prestado\"\n- \"Corrección de precio acordada\"\n\n---\n\n## 💳 Datos del Documento de Ajuste\n\n### Establecimiento (emission details)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **establishment_name** | TORRE SOFTWARE | Nombre del establecimiento |\n| **establishment_address** | BRR LIMONAR MZ 6 CS 3... | Dirección |\n| **establishment_phone** | 3226563672 | Teléfono |\n| **establishment_municipality** | 600 | Código municipio (Medellín) |\n\n### Proveedor (seller) en la Nota\n\nSe repite el mismo proveedor del documento original:\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **identification_number** | 41946692 | Cédula del proveedor |\n| **name** | ELIZABETH CARDONA VILLADA | Nombre |\n| **phone** | 3226563672 | Teléfono |\n| **type_document_identification_id** | 3 | Cédula de ciudadanía |\n| **type_organization_id** | 2 | Persona natural |\n| **municipality_id** | 820 | Municipio |\n\n---\n\n## 💰 Línea de Detalle de la Nota: credit_note_lines\n\n**IMPORTANTE:** Usa `credit_note_lines` (NO `invoice_lines`)\n\n### Estructura de la Línea de Crédito\n\n```json\n\"credit_note_lines\": [{\n \"unit_measure_id\": 70,\n \"invoiced_quantity\": \"1\",\n \"line_extension_amount\": \"200.00\",\n \"free_of_charge_indicator\": false,\n \"description\": \"COMISION POR SERVICIOS\",\n \"code\": \"COMISION\",\n \"price_amount\": \"200.00\",\n \"base_quantity\": \"1\",\n \"brandname\": \"FULLFIT\",\n \"modelname\": \"1088\",\n \"allowance_charges\": [...],\n \"tax_totals\": [...]\n}]\n```\n\n| Concepto | Valor | Descripción |\n|----------|-------|-------------| \n| **description** | COMISION POR SERVICIOS | Bien/servicio original |\n| **code** | COMISION | Código del artículo |\n| **unit_measure_id** | 70 | Unidad (UNIDAD) |\n| **invoiced_quantity** | 1 | Cantidad (total a devolver) |\n| **price_amount** | 200,00 | Precio unitario (del original) |\n| **line_extension_amount** | 200,00 | Subtotal a acreditar (debe coincidir) |\n| **type_item_identification_id** | 4 | Código de identificación |\n| **brandname** | FULLFIT | Marca (opcional, del original) |\n| **modelname** | 1088 | Modelo (opcional, del original) |\n\n---\n\n## 🧮 Cálculo de Totales de la Nota\n\n### Totales que Reversan el Original\n\n| Concepto | Valor | Interpretación |\n|----------|-------|----------| \n| **line_extension_amount** | 200,00 | Total a devolver (copia del original) |\n| **tax_exclusive_amount** | 200,00 | Base sin impuesto |\n| **tax_inclusive_amount** | 200,00 | Total con impuesto (aquí 0% = 200) |\n| **allowance_total_amount** | 0,00 | Sin descuentos adicionales |\n| **charge_total_amount** | 0,00 | Sin cargos |\n| **payable_amount** | **200,00** | Monto a acreditar/revertir |\n\n### Impuestos en la Nota\n\n```json\n\"tax_totals\": [{\n \"tax_id\": 1,\n \"tax_amount\": \"0.00\",\n \"taxable_amount\": \"200.00\",\n \"percent\": \"0.00\"\n}]\n```\n\nEl IVA (o cualquier impuesto) también se revierte con la cantidad acreditada.\n\n---\n\n## 📝 Notas Importantes sobre Nota de Ajuste de Documento Soporte\n\n### 📌 1. Nota de Ajuste vs Nota de Crédito de Factura\n\n| Aspecto | Doc. Soporte (13) | Factura (2) |\n|---------|---|---| \n| **Referencia** | `billing_reference` con CUDE | `billing_reference` con CUFE |\n| **Estructura líneas** | `credit_note_lines` | `invoice_lines` |\n| **Efecto** | Revierte compra a no obligado | Revierte venta a cliente |\n| **Autorización** | Resolución 1876 DIAN | Resolución factura estándar |\n| **Endpoint** | `/api/ubl2.1/sd-credit-note` | `/api/ubl2.1/credit-note` |\n| **prefix** | NDS, ND, etc. | NC, NCD, etc. |\n\n### 📌 2. CUDE del Documento Original es Obligatorio\n\nSin el UUID/CUDE exacto en `billing_reference.uuid`:\n- ❌ La DIAN rechaza: \"billing_reference.uuid does not match any document\"\n- ✓ Obténgalo de la respuesta del Documento Soporte original\n- ✓ Debe ser exacto (96 caracteres hexadecimales)\n\n### 📌 3. billing_reference.number: Formato Completo\n\nDebe incluir **prefix + número**:\n- ✓ CORRECTO: `\"number\": \"SEDS3\"` (SEDS = prefix, 3 = número)\n- ❌ INCORRECTO: `\"number\": \"3\"` (solo número)\n- ❌ INCORRECTO: `\"number\": \"SEDS\"` (solo prefix)\n\n### 📌 4. billing_reference.issue_date: Fecha del Original\n\nLa fecha debe coincidir con la del documento original:\n- Original: 2022-09-01\n- Nota: Debe usar `\"issue_date\": \"2022-09-01\"` (igual)\n- No puede ser diferente o la DIAN puede rechazar por inconsistencia\n\n### 📌 5. Códigos de Discrepancia: Elija el Correcto\n\n**Anulación (código 1):**\n```\n\"discrepancyresponsecode\": 1,\n\"discrepancyresponsedescription\": \"Documento emitido por error administrativo\"\n```\n→ Se cancela totalmente, NO hay devolución de bienes.\n\n**Devolución (código 2):**\n```\n\"discrepancyresponsecode\": 2,\n\"discrepancyresponsedescription\": \"Cliente devuelve artículo defectuoso\"\n```\n→ Se revierte parcial/total, cliente regresa bienes.\n\n**Error de Precio (código 3):**\n```\n\"discrepancyresponsecode\": 3,\n\"discrepancyresponsedescription\": \"Corrección de precio: acuerdo posterior\"\n```\n→ Solo se ajusta el monto; bienes/servicios se mantienen.\n\n### 📌 6. credit_note_lines vs invoice_lines\n\nDiferencia crítica:\n\n```json\n// INCORRECTO - Usar invoice_lines en nota de soporte:\n\"invoice_lines\": [{...}] // ❌ Falla\n\n// CORRECTO - Usar credit_note_lines:\n\"credit_note_lines\": [{...}] // ✓ Válido\n```\n\n### 📌 7. Cantidad en credit_note_lines: Total a Devolver\n\nSi el documento original tiene 5 unidades y devuelven 2:\n- Original: `invoiced_quantity: 5`, `line_extension_amount: 1000`\n- Nota (devolución parcial): `invoiced_quantity: 2`, `line_extension_amount: 400`\n\nEn este ejemplo (devolución total):\n- Original: 1 unidad, 200,00\n- Nota: 1 unidad, 200,00 (todo se revierte)\n\n### 📌 8. Impuestos en la Nota: Reversan Automáticamente\n\nSi el original tenía:\n```\n\"tax_totals\": [{\n \"tax_id\": 1,\n \"tax_amount\": \"38.00\",\n \"percent\": \"19.00\"\n}]\n```\n\nLa nota con el mismo line_extension_amount calcula:\n```\n\"tax_totals\": [{\n \"tax_id\": 1,\n \"tax_amount\": \"38.00\", // Se revierte proporcionalmente\n \"percent\": \"19.00\"\n}]\n```\n\n### 📌 9. Envío de Email de la Nota\n\n```json\n\"sendmail\": true,\n\"sendmailtome\": true,\n\"head_note\": \"AJUSTE DE DOCUMENTO SOPORTE\",\n\"foot_note\": \"PRUEBA DE TEXTO LIBRE EN PIE DE PÁGINA\"\n```\n\n- `sendmail: true`: Envía PDF de la nota al email del proveedor\n- `sendmailtome: true`: Envía copia al email del emisor\n- `head_note`: Encabezado personalizado en PDF\n- `foot_note`: Pie de página con observaciones\n\n### 📌 10. SEZE: Serie Especial Zona de Extraterritorialidad (Opcional)\n\n```\n\"seze\": \"2021-2017\"\n```\n\nRequerido solo para:\n- Documentos emitidos en **zonas de extraterritorialidad** (puertos libres, zonas francas)\n- Formato: Año autorización - Año zona\n- Omitible para operaciones normales (use \"\" si no aplica)\n\n### 📌 11. Validación de Totales en la Nota\n\nLa DIAN valida:\n- ✓ `payable_amount` = `line_extension_amount` - desc + cargos + imptos\n- ✓ `tax_total_amount` en línea = suma de todos `tax_totals[].tax_amount`\n- ✓ Que `billing_reference.uuid` exista y sea válido\n- ✓ Que `discrepancyresponsecode` sea válido (1-5)\n- ✓ Consistencia de números y prefijos\n\n### 📌 12. Flujo de Anulación Completo\n\n**Paso 1: Enviar Documento Soporte Original**\n```\nPOST /api/ubl2.1/support-document\n→ Respuesta: CUDE = 0b156c027e31...\n```\n\n**Paso 2: Descubrir Error**\n```\nNotamos que se emitió por error → Necesitamos anular\n```\n\n**Paso 3: Enviar Nota de Ajuste**\n```\nPOST /api/ubl2.1/sd-credit-note\nbilling_reference.uuid = 0b156c027e31... (del paso 1)\ndiscrepancyresponsecode = 1 (anulación)\n→ Respuesta: Nota emitida con su propio CUDE\n```\n\n**Resultado**: Original + Nota neutralizan el efecto.\n\n### 📌 13. Devolución Parcial: Múltiples Notas\n\nSi hay devoluciones escalonadas (cliente devuelve gradualmente):\n\n**Original**: 100 unidades, 10.000,00\n\n**Nota 1**: 40 unidades, 4.000,00 (primer envío del cliente)\n- `billing_reference.uuid`: CUDE original\n- `line_extension_amount`: 4.000,00\n\n**Nota 2**: 30 unidades, 3.000,00 (segundo envío del cliente)\n- `billing_reference.uuid`: CUDE original (mismo)\n- `line_extension_amount`: 3.000,00\n\n**Saldo**: 30 unidades, 3.000,00 (cliente mantiene por falta de devolución)\n\n### 📌 14. Auditoria de Nota de Ajuste\n\nGuardar en ERP:\n- Número de Nota: NDS4\n- CUDE de la Nota: [nuevo CUDE generado]\n- Referencia: SEDS3 (original)\n- CUDE Original: 0b156c027e31...\n- Motivo: Devolución (código 2)\n- Monto revertido: 200,00\n- Fecha: 2025-11-04\n- Email notificación: elizabethcardonav@gmail.com\n\n### 📌 15. Casos de Uso de Notas de Ajuste\n\n- **Cancelación por error administrativo**: Se emitió documento, pero no fue la transacción real\n- **Devolución de bienes**: Cliente devuelve producto defectuoso dentro de plazo\n- **Corrección de precio**: Se descubre error de cálculo en la compra\n- **Cambio de especificaciones**: Lo acordado no coincide, cliente rechaza\n- **Evento mercancía dañada**: Bienes recibidos en mal estado\n- **Acuerdo comercial**: Bonificación/descuento post-venta\n- **Cancelación parcial**: Cliente rechaza solo parte del servicio\n- **Error de facturación**: Se emitió a nombre equivocado o cantidad errada" }, "response": [] }, { "name": "Send Pendings - Documento Soporte", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{token}}", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "{{url}}/api/ubl2.1/support-document/send_pendings/{{prefix}}/{{number}}", "host": [ "{{url}}" ], "path": [ "api", "ubl2.1", "support-document", "send_pendings", "{{prefix}}", "{{number}}" ] }, "description": "# 📤 ENVIAR DOCUMENTOS SOPORTE PENDIENTES\n\n## Descripción\nEste endpoint permite enviar a la DIAN los Documentos Soporte que fueron creados con `dont_send_yet: true` (estado pendiente) para transmitirlos posteriormente.\n\n## URL del Endpoint\n```\nPOST {{url}}/api/ubl2.1/support-document/send_pendings/{prefix?}/{number?}\n```\n\n## Parámetros\n- **prefix** (opcional): Filtrar por prefijo específico (ej: \"SEDS\")\n- **number** (opcional): Filtrar por número específico (ej: \"150\")\n- Si no se especifican, procesa TODOS los documentos pendientes\n\n## Ejemplos de Uso\n\n### Enviar documento específico:\n```\nPOST /api/ubl2.1/support-document/send_pendings/SEDS/150\n```\n\n### Enviar todos los documentos con prefijo SEDS:\n```\nPOST /api/ubl2.1/support-document/send_pendings/SEDS\n```\n\n### Enviar TODOS los documentos pendientes:\n```\nPOST /api/ubl2.1/support-document/send_pendings\n```" }, "response": [] }, { "name": "Send Pendings - Nota Ajuste DS", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{token}}", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "{{url}}/api/ubl2.1/sd-credit-note/send_pendings/{{prefix}}/{{number}}", "host": [ "{{url}}" ], "path": [ "api", "ubl2.1", "sd-credit-note", "send_pendings", "{{prefix}}", "{{number}}" ] }, "description": "# 📤 ENVIAR NOTAS DE AJUSTE DS PENDIENTES\n\n## Descripción\nEste endpoint permite enviar a la DIAN las Notas de Ajuste de Documento Soporte que fueron creadas con `dont_send_yet: true` (estado pendiente) para transmitirlas posteriormente.\n\n## URL del Endpoint\n```\nPOST {{url}}/api/ubl2.1/sd-credit-note/send_pendings/{prefix?}/{number?}\n```\n\n## Parámetros\n- **prefix** (opcional): Filtrar por prefijo específico (ej: \"NDS\")\n- **number** (opcional): Filtrar por número específico (ej: \"50\")\n- Si no se especifican, procesa TODAS las notas pendientes\n\n## Ejemplos de Uso\n\n### Enviar nota específica:\n```\nPOST /api/ubl2.1/sd-credit-note/send_pendings/NDS/50\n```\n\n### Enviar todas las notas con prefijo NDS:\n```\nPOST /api/ubl2.1/sd-credit-note/send_pendings/NDS\n```\n\n### Enviar TODAS las notas pendientes:\n```\nPOST /api/ubl2.1/sd-credit-note/send_pendings\n```" }, "response": [] } ] }, { "name": "Documentos Equivalentes", "item": [ { "name": "POS", "item": [ { "name": "Una Linea, Sin Descuentos, Una Tarifa de IVA", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "host", "value": "apidian2026-8.oo", "type": "text", "disabled": true } ], "body": { "mode": "raw", "raw": "{\r\n\t\"number\": 12,\r\n\t\"type_document_id\": 15,\r\n\t\"date\": \"2025-11-05\",\r\n\t\"time\": \"04:08:12\",\r\n \"postal_zone_code\": \"630003\",\r\n\t\"resolution_number\": \"18760000001\",\r\n \"query_uuid\": false,\r\n \"dont_send_yet\": true,\r\n\t\"prefix\": \"EPOS\",\r\n \"notes\": \"ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA\",\r\n\t\"sendmail\": true,\r\n \"sendmailtome\": false,\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"software_manufacturer\":{\r\n \"name\": \"ALEXANDER OBANDO LONDONO\",\r\n \"business_name\": \"TORRE SOFTWARE\",\r\n \"software_name\": \"BABEL\"\r\n },\r\n \"buyer_benefits\":{\r\n \"code\": \"89008003\",\r\n \"name\": \"INVERSIONES DAVAL SAS\",\r\n \"points\": \"100\"\r\n },\r\n \"cash_information\":{\r\n \"plate_number\": \"DF-000-12345\",\r\n \"location\": \"HOTEL OVERLOOK RECEPCION\",\r\n \"cashier\": \"JACK TORRANCE\",\r\n \"cash_type\": \"CAJA PRINCIPAL\",\r\n \"sales_code\": \"EPOS1\",\r\n \"subtotal\": \"1000000.00\"\r\n },\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 89008003,\r\n\t\t\"dv\": 2,\r\n\t\t\"name\": \"INVERSIONES DAVAL SAS\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexanderobandolondono@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 6,\r\n\t\t\"type_organization_id\": 1,\r\n \"type_liability_id\": 7,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1\r\n\t},\r\n\t\"payment_form\": {\r\n\t\t\"payment_form_id\": 1,\r\n\t\t\"payment_method_id\": 30,\r\n\t\t\"payment_due_date\": \"2025-11-05\",\r\n\t\t\"duration_measure\": \"0\"\r\n\t},\t\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\"tax_exclusive_amount\": \"840336.134\",\r\n\t\t\"tax_inclusive_amount\": \"1000000.00\",\r\n\t\t\"payable_amount\": \"1000000.00\"\r\n\t},\r\n\t\"tax_totals\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\"percent\": \"19.00\",\r\n\t\t\t\"taxable_amount\": \"840336.134\"\r\n\t\t}\r\n\t],\r\n\t\"invoice_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\t\t\"taxable_amount\": \"840336.134\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"COMISION POR SERVICIOS\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"COMISION\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"1000000.00\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/eqdoc", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "eqdoc" ] }, "description": "# 💳 DOCUMENTO EQUIVALENTE POS - IVA 19% (Punto de Venta)\n\n## 📄 Descripción General\n\nEste ejemplo demuestra la emisión de un **Documento Equivalente para Punto de Venta (POS)** (`type_document_id: 15`) con **IVA 19% estándar**. Es el tipo de documento más común en comercio minorista (tiendas, supermercados, farmacias, etc.).\n\nEs un **Documento Equivalente Electrónico** autorizado por la DIAN como alternativa a la factura electrónica tradicional para sistemas POS. Mantiene la misma validez legal y tributaria pero con estructura simplificada y datos obligatorios específicos del punto de venta (identificación de caja, cajero, software POS, etc.).\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/eqdoc\n```\n\n**Características:**\n- Tipo: Documento Equivalente - Punto de Venta\n- Modo: Síncrono (sin testSetId en URL)\n- Software POS: TORRE SOFTWARE - BABEL\n- Impuesto: IVA 19% (Régimen estándar)\n- Almacenamiento: `dont_send_yet: true` (modo offline)\n\n---\n\n## 🔑 Campos Principales del POS\n\n### Datos del Documento\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **type_document_id** | **15** | **Documento Equivalente - POS** |\n| **prefix** | EPOS | Prefijo autorizado para documentos POS |\n| **number** | 12 | Número consecutivo del comprobante |\n| **date** | 2025-11-05 | Fecha del documento |\n| **time** | 04:08:12 | Hora (Bogotá UTC-5) |\n| **resolution_number** | 18760000001 | Resolución DIAN 1876 (autorización) |\n| **postal_zone_code** | 630003 | Código postal del establecimiento |\n\n### Identificación del Software POS\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **software_manufacturer.name** | ALEXANDER OBANDO LONDONO | Nombre desarrollador software |\n| **software_manufacturer.business_name** | TORRE SOFTWARE | Razón social fabricante |\n| **software_manufacturer.software_name** | BABEL | Nombre comercial del POS |\n\n### Información de Caja/Operación\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **cash_information.plate_number** | DF-000-12345 | Identificador caja registradora |\n| **cash_information.location** | HOTEL OVERLOOK RECEPCION | Ubicación física de la caja |\n| **cash_information.cashier** | JACK TORRANCE | Nombre del operador/cajero |\n| **cash_information.cash_type** | CAJA PRINCIPAL | Tipo/clasificación de caja |\n| **cash_information.sales_code** | EPOS1 | Código interno de la transacción |\n| **cash_information.subtotal** | 1.000.000,00 | Subtotal antes de impuestos |\n\n### Programa de Fidelización (Opcional)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **buyer_benefits.code** | 89008003 | NIT/Cédula cliente en programa |\n| **buyer_benefits.name** | INVERSIONES DAVAL SAS | Nombre del cliente |\n| **buyer_benefits.points** | 100 | Puntos acumulados/redimidos |\n\n### Cliente (customer)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **identification_number** | 89008003 | NIT del cliente |\n| **type_document_identification_id** | 6 | Documento: NIT |\n| **type_organization_id** | 1 | Persona jurídica (empresa) |\n| **type_liability_id** | 7 | No responsable de IVA (retail típico) |\n| **type_regime_id** | 1 | Régimen simplificado |\n| **name** | INVERSIONES DAVAL SAS | Razón social cliente |\n\n### Forma de Pago\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **payment_form_id** | 1 | Contado (pago inmediato) |\n| **payment_method_id** | **30** | **Efectivo** |\n| **payment_due_date** | 2025-11-05 | Vencimiento (mismo día) |\n\n---\n\n## 💰 Línea de Detalle y Cálculo\n\n| Concepto | Valor | Descripción |\n|----------|-------|-------------| \n| **description** | COMISION POR SERVICIOS | Descripción del producto/servicio |\n| **code** | COMISION | Código interno del producto |\n| **unit_measure_id** | 70 | Unidad de medida (UNIDAD) |\n| **invoiced_quantity** | 1,00 | Cantidad vendida |\n| **price_amount** | 1.000.000,00 | Precio unitario |\n| **line_extension_amount** | 840.336,13 | Subtotal línea (sin IVA) |\n\n### Cálculo de Totales con IVA 19%\n\n| Componente | Valor | Fórmula |\n|------------|-------|----------| \n| **Subtotal (tax_exclusive)** | 840.336,13 | Base gravable |\n| **IVA (19%)** | 159.663,87 | 840.336,13 × 0,19 |\n| **TOTAL (tax_inclusive)** | 1.000.000,00 | 840.336,13 + 159.663,87 |\n| **PAYABLE_AMOUNT** | **1.000.000,00** | Monto a pagar |\n\n### Impuesto\n\n```json\n\"tax_totals\": [{\n \"tax_id\": 1,\n \"tax_amount\": \"159663.865\",\n \"percent\": \"19.00\",\n \"taxable_amount\": \"840336.134\"\n}]\n```\n\n---\n\n## 📝 Notas Importantes sobre POS - IVA Estándar\n\n### 📌 1. Documento Equivalente vs Factura Electrónica\n\n| Aspecto | Factura Electrónica | Documento Equivalente POS |\n|--------|---|---| \n| **Autorización** | Resolución general DIAN | Resolución específica 1876 |\n| **Software** | Cualquiera certificado | Specific to POS certification |\n| **Datos Caja** | No obligatorio | `cash_information` obligatorio |\n| **Validez Legal** | 100% equivalencia | 100% equivalencia tributaria |\n| **Consumidor** | Identificación opcional | Puede ser genérico (consumidor final) |\n| **Uso** | Venta B2B / B2C general | Retail de bajo valor + alto volumen |\n\n### 📌 2. type_document_id: 15 es Obligatorio para POS\n\n- `type_document_id: 15` = Documento Equivalente POS (tiendas, supermercados, cafés)\n- `type_document_id: 16` = Boleta cine (no es POS genérico)\n- `type_document_id: 19` = Transporte terrestre (tiquetes)\n- `type_document_id: 24` = Servicios públicos domiciliarios\n\nNo mezclando tipos evita rechazos DIAN.\n\n### 📌 3. software_manufacturer: DEBE Coincidir con Registro DIAN\n\nEl software POS debe estar registrado en DIAN con exactitud:\n- ❌ INCORRECTO: `\"business_name\": \"TORRE\"` (abreviado)\n- ✓ CORRECTO: `\"business_name\": \"TORRE SOFTWARE\"` (completo, como está registrado)\n- ❌ INCORRECTO: `\"software_name\": \"BABEL V2.0\"` (si está registrado como \"BABEL\")\n- ✓ CORRECTO: `\"software_name\": \"BABEL\"` (exacto)\n\nDiscrepancias = rechazo DIAN.\n\n### 📌 4. cash_information: Datos Operativos Obligatorios\n\nSin estos campos, la DIAN rechaza:\n- **plate_number**: Identificador de la terminal/caja (puede ser alfanumérico: DF-000-12345, CAJA-001)\n- **location**: Ubicación física dentro del establecimiento (\"RECEPCION\", \"PISO 2\", \"CAJA 1\")\n- **cashier**: Nombre del operador de caja (para auditoría y trazabilidad)\n- **cash_type**: Clasificación (\"CAJA PRINCIPAL\", \"CAJA RAPIDA\", \"MODULO DE SERVICIOS\")\n- **sales_code**: Referencia interna única de la transacción (para conciliación)\n- **subtotal**: Debe coincidir con `tax_exclusive_amount` de `legal_monetary_totals`\n\n### 📌 5. payment_method_id 30: Efectivo en POS\n\nMétodos de pago comunes en retail:\n- **30**: Efectivo (pago en moneda/billetes)\n- **40**: Tarjeta crédito (VISA, Mastercard, etc.)\n- **41**: Tarjeta débito\n- **42**: PSE (transferencia electrónica)\n- **47**: Billetera digital/app de pago\n\nEn este ejemplo: 30 (efectivo = contado inmediato).\n\n### 📌 6. dont_send_yet: Modo Offline POS\n\nEste campo es particular de sistemas POS:\n\n```json\n\"dont_send_yet\": true // Almacenar sin enviar aún a DIAN\n```\n\n**Casos de Uso:**\n- Red inestable durante el día → almacenar facturas localmente\n- Enviar en lote al final del turno → llamar `/eqdoc/send_pendings`\n- Procesamiento masivo nocturno → evitar congestión DIAN\n\n**Con dont_send_yet: false:**\n- Envía inmediatamente a DIAN\n- Requiere conexión estable\n- Ideal para POS con conectividad constante\n\n### 📌 7. query_uuid: False para Alto Volumen POS\n\n```json\n\"query_uuid\": false // NO validar UUID previo (más rápido)\n```\n\nEn POS de alto volumen (tiendas), `false` mejora performance:\n- No consulta si existe documento previo (es probable que sea nuevo)\n- Acelera procesamiento de transacciones\n- Válido si sistemas POS no pueden tener duplicados internos\n\nUsar `true` solo si:\n- Baja frecuencia de transacciones\n- Necesita detectar re-envíos accidentales\n\n### 📌 8. postal_zone_code: Obligatorio por DIAN\n\nCódigo postal del establecimiento (6 dígitos en Colombia):\n- `\"postal_zone_code\": \"630003\"` (formato string)\n- Debe corresponder a ubicación real del POS\n- Algunos municipios usan 5 dígitos: rellenar con cero a la izquierda\n- Afecta validaciones geográficas de DIAN\n\n### 📌 9. IVA 19%: Tarifa Estándar en Colombia\n\nTarifas IVA por tipo de bien:\n- **0%**: Alimentos básicos, medicinas, etc. (exento)\n- **5%**: Algunos alimentos procesados, libros, fertilizantes\n- **19%**: Tarifa general (ropa, electrónica, servicios, etc.) ← Este ejemplo\n\nCálculo:\n- Base gravable: 840.336,13\n- IVA aplicable: 840.336,13 × 0,19 = 159.663,87\n- Total a cobrar: 1.000.000,00\n\n### 📌 10. buyer_benefits: Programa de Fidelización (Opcional)\n\nSi el cliente está en programa de puntos:\n\n```json\n\"buyer_benefits\": {\n \"code\": \"89008003\", // NIT/cédula identificadora\n \"name\": \"INVERSIONES DAVAL SAS\", // Nombre del cliente\n \"points\": \"100\" // Puntos redimidos en esta compra\n}\n```\n\n**Efectos en PDF:**\n- Se muestra en representación gráfica\n- Auditoría de puntos gastados\n- Sincronización con programa de lealtad\n\nSin este campo = cliente ocasional sin programa.\n\n### 📌 11. type_liability_id 7: No Responsable IVA (Consumidor Final)\n\nEn POS retail, el cliente típico es **consumidor final** (type_liability_id 7 = no responsable):\n- No puede recuperar IVA\n- No es responsable de pagos a DIAN\n- Simplifica validaciones tributarias\n- Diferente de empresa (type_liability_id 14 = responsable IVA)\n\n### 📌 12. Validación de Totales: Crítica para Aprobación\n\nLa DIAN valida exactamente:\n\n```\npayable_amount = line_extension_amount + impuestos - descuentos + cargos\n1.000.000,00 = 840.336,13 + 159.663,87 ✓\n```\n\nSi no cuadra (ej: 1.000.000,01): Error 422 \"Legal Monetary Totals do not match\".\n\n### 📌 13. Flujo Operativo del POS\n\n**Secuencia típica:**\n1. Cliente llega a caja, realiza compra\n2. Sistema POS calcula: cantidad × precio + IVA\n3. Si `dont_send_yet: true`: almacena localmente\n4. Si `dont_send_yet: false`: envía inmediatamente a DIAN\n5. DIAN valida y retorna CUFE (aproximadamente 5-10 segundos)\n6. POS imprime recibo con CUFE y código QR\n7. Cliente recibe comprobante\n8. Si se almacenó (paso 3): más tarde POST `/eqdoc/send_pendings` → DIAN procesa en lote\n\n### 📌 14. Descuentos en POS: Aplicar Correctamente\n\nSi hay descuento (ej: 10% a cliente frecuente):\n\n```json\n\"allowance_charges\": [{\n \"charge_indicator\": false,\n \"allowance_charge_reason\": \"Descuento cliente frecuente\",\n \"amount\": \"100000.00\",\n \"base_amount\": \"1000000.00\"\n}]\n```\n\nRecalcular totales:\n- Nuevo subtotal: 900.000,00\n- IVA (19%): 171.000,00\n- Total: 1.071.000,00 ← INCORRECTO (cliente paga más)\n\n**Correcto: Descuento en base antes de IVA**\n- Subtotal original: 1.000.000,00\n- Menos descuento 10%: -100.000,00\n- Base neta: 900.000,00\n- IVA 19%: 171.000,00\n- Total a pagar: 1.071.000,00\n\n### 📌 15. Casos de Uso Comunes POS Retail\n\n- **Tienda de ropa**: 1 línea con lote de prendas, IVA 19%\n- **Supermercado**: Múltiples líneas (carnes 19%, frutas 5%, lacteos 5%), cálculo por línea\n- **Farmacia**: Medicinas (0% si control INVIMA), otros artículos 19%\n- **Restaurante/Café**: Servicio con INC 8% o 16% (NO IVA estándar)\n- **Gasolinera**: Combustible 0% + accesorios 19%\n- **Tienda 24h con red inestable**: `dont_send_yet: true`, enviar `/send_pendings` a las 3 AM" }, "response": [] }, { "name": "Una Linea, Impuesto Nacional Al Consumo", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "host", "value": "apidian2026-8.oo", "type": "text", "disabled": true } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": 17,\r\n \"type_document_id\": 15,\r\n \"date\": \"2025-11-27\",\r\n \"time\": \"04:08:12\",\r\n \"postal_zone_code\": \"630003\",\r\n \"resolution_number\": \"18760000001\",\r\n \"query_uuid\": false,\r\n \"dont_send_yet\": false,\r\n \"prefix\": \"EPOS\",\r\n \"notes\": \"ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA\",\r\n \"sendmail\": true,\r\n \"sendmailtome\": false,\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"software_manufacturer\": {\r\n \"name\": \"ALEXANDER OBANDO LONDONO\",\r\n \"business_name\": \"TORRE SOFTWARE\",\r\n \"software_name\": \"BABEL\"\r\n },\r\n \"buyer_benefits\": {\r\n \"code\": \"89008003\",\r\n \"name\": \"INVERSIONES DAVAL SAS\",\r\n \"points\": \"100\"\r\n },\r\n \"cash_information\": {\r\n \"plate_number\": \"DF-000-12345\",\r\n \"location\": \"HOTEL OVERLOOK RECEPCION\",\r\n \"cashier\": \"JACK TORRANCE\",\r\n \"cash_type\": \"CAJA PRINCIPAL\",\r\n \"sales_code\": \"EPOS1\",\r\n \"subtotal\": \"1000000.00\"\r\n },\r\n \"customer\": {\r\n \"identification_number\": 89008003,\r\n \"dv\": 2,\r\n \"name\": \"INVERSIONES DAVAL SAS\",\r\n \"phone\": \"3103891693\",\r\n \"address\": \"CLL 4 NRO 33-90\",\r\n \"email\": \"alexanderobandolondono@gmail.com\",\r\n \"merchant_registration\": \"0000000-00\",\r\n \"type_document_identification_id\": 6,\r\n \"type_organization_id\": 1,\r\n \"type_liability_id\": 7,\r\n \"municipality_id\": 822,\r\n \"type_regime_id\": 1\r\n },\r\n \"payment_form\": {\r\n \"payment_form_id\": 1,\r\n \"payment_method_id\": 30,\r\n \"payment_due_date\": \"2025-11-27\",\r\n \"duration_measure\": \"0\"\r\n },\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"925925.925925925\",\r\n \"tax_exclusive_amount\": \"925925.925925925\",\r\n \"tax_inclusive_amount\": \"1000000.00\",\r\n \"payable_amount\": \"1000000.00\"\r\n },\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 4,\r\n \"tax_amount\": \"74074.074074074\",\r\n \"taxable_amount\": \"925925.925925925\",\r\n \"percent\": \"8.00\"\r\n }\r\n ],\r\n \"invoice_lines\": [\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"925925.925925925\",\r\n \"free_of_charge_indicator\": false,\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 4,\r\n \"tax_amount\": \"74074.074074074\",\r\n \"taxable_amount\": \"925925.925925925\",\r\n \"percent\": \"8.00\"\r\n }\r\n ],\r\n \"description\": \"COMISION POR SERVICIOS\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n \"code\": \"COMISION\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"1000000.00\",\r\n \"base_quantity\": \"1\"\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/eqdoc", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "eqdoc" ] }, "description": "# 🍽️ DOCUMENTO EQUIVALENTE POS - INC 8% (Punto de Venta - Restaurante)\n\n## 📄 Descripción General\n\nEste ejemplo demuestra la emisión de un **Documento Equivalente para Punto de Venta (POS)** (`type_document_id: 15`) con **Impuesto Nacional al Consumo (INC) del 8%**. Es el tipo de documento requerido para establecimientos gastronómicos (restaurantes, bares, cafeterías, discotecas, etc.).\n\nEs un **Documento Equivalente Electrónico** autorizado por la DIAN como alternativa a la factura electrónica tradicional para sistemas POS. Mantiene la misma validez legal y tributaria pero con estructura simplificada y datos obligatorios específicos del punto de venta (identificación de caja, cajero, software POS, etc.).\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/eqdoc\n```\n\n**Características:**\n- Tipo: Documento Equivalente - Punto de Venta\n- Modo: Síncrono (sin testSetId en URL)\n- Software POS: TORRE SOFTWARE - BABEL\n- Impuesto: IVA 19% (Régimen estándar)\n- Almacenamiento: `dont_send_yet: true` (modo offline)\n\n---\n\n## 🔑 Campos Principales del POS\n\n### Datos del Documento\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **type_document_id** | **15** | **Documento Equivalente - POS** |\n| **prefix** | EPOS | Prefijo autorizado para documentos POS |\n| **number** | 12 | Número consecutivo del comprobante |\n| **date** | 2025-11-05 | Fecha del documento |\n| **time** | 04:08:12 | Hora (Bogotá UTC-5) |\n| **resolution_number** | 18760000001 | Resolución DIAN 1876 (autorización) |\n| **postal_zone_code** | 630003 | Código postal del establecimiento |\n\n### Identificación del Software POS\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **software_manufacturer.name** | ALEXANDER OBANDO LONDONO | Nombre desarrollador software |\n| **software_manufacturer.business_name** | TORRE SOFTWARE | Razón social fabricante |\n| **software_manufacturer.software_name** | BABEL | Nombre comercial del POS |\n\n### Información de Caja/Operación\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **cash_information.plate_number** | DF-000-12345 | Identificador caja registradora |\n| **cash_information.location** | HOTEL OVERLOOK RECEPCION | Ubicación física de la caja |\n| **cash_information.cashier** | JACK TORRANCE | Nombre del operador/cajero |\n| **cash_information.cash_type** | CAJA PRINCIPAL | Tipo/clasificación de caja |\n| **cash_information.sales_code** | EPOS1 | Código interno de la transacción |\n| **cash_information.subtotal** | 1.000.000,00 | Subtotal antes de impuestos |\n\n### Programa de Fidelización (Opcional)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **buyer_benefits.code** | 89008003 | NIT/Cédula cliente en programa |\n| **buyer_benefits.name** | INVERSIONES DAVAL SAS | Nombre del cliente |\n| **buyer_benefits.points** | 100 | Puntos acumulados/redimidos |\n\n### Cliente (customer)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **identification_number** | 89008003 | NIT del cliente |\n| **type_document_identification_id** | 6 | Documento: NIT |\n| **type_organization_id** | 1 | Persona jurídica (empresa) |\n| **type_liability_id** | 7 | No responsable de IVA (retail típico) |\n| **type_regime_id** | 1 | Régimen simplificado |\n| **name** | INVERSIONES DAVAL SAS | Razón social cliente |\n\n### Forma de Pago\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **payment_form_id** | 1 | Contado (pago inmediato) |\n| **payment_method_id** | **30** | **Efectivo** |\n| **payment_due_date** | 2025-11-05 | Vencimiento (mismo día) |\n\n---\n\n## 💰 Línea de Detalle y Cálculo\n\n| Concepto | Valor | Descripción |\n|----------|-------|-------------| \n| **description** | COMISION POR SERVICIOS | Descripción del producto/servicio |\n| **code** | COMISION | Código interno del producto |\n| **unit_measure_id** | 70 | Unidad de medida (UNIDAD) |\n| **invoiced_quantity** | 1,00 | Cantidad vendida |\n| **price_amount** | 1.000.000,00 | Precio unitario |\n| **line_extension_amount** | 840.336,13 | Subtotal línea (sin IVA) |\n\n### Cálculo de Totales con IVA 19%\n\n| Componente | Valor | Fórmula |\n|------------|-------|----------| \n| **Subtotal (tax_exclusive)** | 840.336,13 | Base gravable |\n| **IVA (19%)** | 159.663,87 | 840.336,13 × 0,19 |\n| **TOTAL (tax_inclusive)** | 1.000.000,00 | 840.336,13 + 159.663,87 |\n| **PAYABLE_AMOUNT** | **1.000.000,00** | Monto a pagar |\n\n### Impuesto\n\n```json\n\"tax_totals\": [{\n \"tax_id\": 1,\n \"tax_amount\": \"159663.865\",\n \"percent\": \"19.00\",\n \"taxable_amount\": \"840336.134\"\n}]\n```\n\n---\n\n## 📝 Notas Importantes sobre POS - IVA Estándar\n\n### 📌 1. Documento Equivalente vs Factura Electrónica\n\n| Aspecto | Factura Electrónica | Documento Equivalente POS |\n|--------|---|---| \n| **Autorización** | Resolución general DIAN | Resolución específica 1876 |\n| **Software** | Cualquiera certificado | Specific to POS certification |\n| **Datos Caja** | No obligatorio | `cash_information` obligatorio |\n| **Validez Legal** | 100% equivalencia | 100% equivalencia tributaria |\n| **Consumidor** | Identificación opcional | Puede ser genérico (consumidor final) |\n| **Uso** | Venta B2B / B2C general | Retail de bajo valor + alto volumen |\n\n### 📌 2. type_document_id: 15 es Obligatorio para POS\n\n- `type_document_id: 15` = Documento Equivalente POS (tiendas, supermercados, cafés)\n- `type_document_id: 16` = Boleta cine (no es POS genérico)\n- `type_document_id: 19` = Transporte terrestre (tiquetes)\n- `type_document_id: 24` = Servicios públicos domiciliarios\n\nNo mezclando tipos evita rechazos DIAN.\n\n### 📌 3. software_manufacturer: DEBE Coincidir con Registro DIAN\n\nEl software POS debe estar registrado en DIAN con exactitud:\n- ❌ INCORRECTO: `\"business_name\": \"TORRE\"` (abreviado)\n- ✓ CORRECTO: `\"business_name\": \"TORRE SOFTWARE\"` (completo, como está registrado)\n- ❌ INCORRECTO: `\"software_name\": \"BABEL V2.0\"` (si está registrado como \"BABEL\")\n- ✓ CORRECTO: `\"software_name\": \"BABEL\"` (exacto)\n\nDiscrepancias = rechazo DIAN.\n\n### 📌 4. cash_information: Datos Operativos Obligatorios\n\nSin estos campos, la DIAN rechaza:\n- **plate_number**: Identificador de la terminal/caja (puede ser alfanumérico: DF-000-12345, CAJA-001)\n- **location**: Ubicación física dentro del establecimiento (\"RECEPCION\", \"PISO 2\", \"CAJA 1\")\n- **cashier**: Nombre del operador de caja (para auditoría y trazabilidad)\n- **cash_type**: Clasificación (\"CAJA PRINCIPAL\", \"CAJA RAPIDA\", \"MODULO DE SERVICIOS\")\n- **sales_code**: Referencia interna única de la transacción (para conciliación)\n- **subtotal**: Debe coincidir con `tax_exclusive_amount` de `legal_monetary_totals`\n\n### 📌 5. payment_method_id 30: Efectivo en POS\n\nMétodos de pago comunes en retail:\n- **30**: Efectivo (pago en moneda/billetes)\n- **40**: Tarjeta crédito (VISA, Mastercard, etc.)\n- **41**: Tarjeta débito\n- **42**: PSE (transferencia electrónica)\n- **47**: Billetera digital/app de pago\n\nEn este ejemplo: 30 (efectivo = contado inmediato).\n\n### 📌 6. dont_send_yet: Modo Offline POS\n\nEste campo es particular de sistemas POS:\n\n```json\n\"dont_send_yet\": true // Almacenar sin enviar aún a DIAN\n```\n\n**Casos de Uso:**\n- Red inestable durante el día → almacenar facturas localmente\n- Enviar en lote al final del turno → llamar `/eqdoc/send_pendings`\n- Procesamiento masivo nocturno → evitar congestión DIAN\n\n**Con dont_send_yet: false:**\n- Envía inmediatamente a DIAN\n- Requiere conexión estable\n- Ideal para POS con conectividad constante\n\n### 📌 7. query_uuid: False para Alto Volumen POS\n\n```json\n\"query_uuid\": false // NO validar UUID previo (más rápido)\n```\n\nEn POS de alto volumen (tiendas), `false` mejora performance:\n- No consulta si existe documento previo (es probable que sea nuevo)\n- Acelera procesamiento de transacciones\n- Válido si sistemas POS no pueden tener duplicados internos\n\nUsar `true` solo si:\n- Baja frecuencia de transacciones\n- Necesita detectar re-envíos accidentales\n\n### 📌 8. postal_zone_code: Obligatorio por DIAN\n\nCódigo postal del establecimiento (6 dígitos en Colombia):\n- `\"postal_zone_code\": \"630003\"` (formato string)\n- Debe corresponder a ubicación real del POS\n- Algunos municipios usan 5 dígitos: rellenar con cero a la izquierda\n- Afecta validaciones geográficas de DIAN\n\n### 📌 9. IVA 19%: Tarifa Estándar en Colombia\n\nTarifas IVA por tipo de bien:\n- **0%**: Alimentos básicos, medicinas, etc. (exento)\n- **5%**: Algunos alimentos procesados, libros, fertilizantes\n- **19%**: Tarifa general (ropa, electrónica, servicios, etc.) ← Este ejemplo\n\nCálculo:\n- Base gravable: 840.336,13\n- IVA aplicable: 840.336,13 × 0,19 = 159.663,87\n- Total a cobrar: 1.000.000,00\n\n### 📌 10. buyer_benefits: Programa de Fidelización (Opcional)\n\nSi el cliente está en programa de puntos:\n\n```json\n\"buyer_benefits\": {\n \"code\": \"89008003\", // NIT/cédula identificadora\n \"name\": \"INVERSIONES DAVAL SAS\", // Nombre del cliente\n \"points\": \"100\" // Puntos redimidos en esta compra\n}\n```\n\n**Efectos en PDF:**\n- Se muestra en representación gráfica\n- Auditoría de puntos gastados\n- Sincronización con programa de lealtad\n\nSin este campo = cliente ocasional sin programa.\n\n### 📌 11. type_liability_id 7: No Responsable IVA (Consumidor Final)\n\nEn POS retail, el cliente típico es **consumidor final** (type_liability_id 7 = no responsable):\n- No puede recuperar IVA\n- No es responsable de pagos a DIAN\n- Simplifica validaciones tributarias\n- Diferente de empresa (type_liability_id 14 = responsable IVA)\n\n### 📌 12. Validación de Totales: Crítica para Aprobación\n\nLa DIAN valida exactamente:\n\n```\npayable_amount = line_extension_amount + impuestos - descuentos + cargos\n1.000.000,00 = 840.336,13 + 159.663,87 ✓\n```\n\nSi no cuadra (ej: 1.000.000,01): Error 422 \"Legal Monetary Totals do not match\".\n\n### 📌 13. Flujo Operativo del POS\n\n**Secuencia típica:**\n1. Cliente llega a caja, realiza compra\n2. Sistema POS calcula: cantidad × precio + IVA\n3. Si `dont_send_yet: true`: almacena localmente\n4. Si `dont_send_yet: false`: envía inmediatamente a DIAN\n5. DIAN valida y retorna CUFE (aproximadamente 5-10 segundos)\n6. POS imprime recibo con CUFE y código QR\n7. Cliente recibe comprobante\n8. Si se almacenó (paso 3): más tarde POST `/eqdoc/send_pendings` → DIAN procesa en lote\n\n### 📌 14. Descuentos en POS: Aplicar Correctamente\n\nSi hay descuento (ej: 10% a cliente frecuente):\n\n```json\n\"allowance_charges\": [{\n \"charge_indicator\": false,\n \"allowance_charge_reason\": \"Descuento cliente frecuente\",\n \"amount\": \"100000.00\",\n \"base_amount\": \"1000000.00\"\n}]\n```\n\nRecalcular totales:\n- Nuevo subtotal: 900.000,00\n- IVA (19%): 171.000,00\n- Total: 1.071.000,00 ← INCORRECTO (cliente paga más)\n\n**Correcto: Descuento en base antes de IVA**\n- Subtotal original: 1.000.000,00\n- Menos descuento 10%: -100.000,00\n- Base neta: 900.000,00\n- IVA 19%: 171.000,00\n- Total a pagar: 1.071.000,00\n\n### 📌 15. Casos de Uso Comunes POS Retail\n\n- **Tienda de ropa**: 1 línea con lote de prendas, IVA 19%\n- **Supermercado**: Múltiples líneas (carnes 19%, frutas 5%, lacteos 5%), cálculo por línea\n- **Farmacia**: Medicinas (0% si control INVIMA), otros artículos 19%\n- **Restaurante/Café**: Servicio con INC 8% o 16% (NO IVA estándar)\n- **Gasolinera**: Combustible 0% + accesorios 19%\n- **Tienda 24h con red inestable**: `dont_send_yet: true`, enviar `/send_pendings` a las 3 AM" }, "response": [] }, { "name": "Una Linea, Sin Descuentos, Una Tarifa de IVA Copy", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "7692a20fec92af0aa5729d796b019d27c83c9955407994630a0cdd7702ca2329", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "host", "value": "apidian2026-8.oo", "type": "text", "disabled": true } ], "body": { "mode": "raw", "raw": "{\r\n\t\"number\": 46,\r\n\t\"type_document_id\": 15,\r\n\t\"date\": \"2024-08-14\",\r\n\t\"time\": \"04:08:12\",\r\n \"postal_zone_code\": \"630003\",\r\n\t\"resolution_number\": \"18760000001\",\r\n\t\"prefix\": \"EPOS\",\r\n \"notes\": \"ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA\",\r\n\t\"sendmail\": true,\r\n \"sendmailtome\": false,\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"software_manufacturer\":{\r\n \"name\": \"ALEXANDER OBANDO LONDONO\",\r\n \"business_name\": \"TORRE SOFTWARE\",\r\n \"software_name\": \"BABEL\"\r\n },\r\n \"buyer_benefits\":{\r\n \"code\": \"89008003\",\r\n \"name\": \"INVERSIONES DAVAL SAS\",\r\n \"points\": \"100\"\r\n },\r\n \"cash_information\":{\r\n \"plate_number\": \"DF-000-12345\",\r\n \"location\": \"HOTEL OVERLOOK RECEPCION\",\r\n \"cashier\": \"JACK TORRANCE\",\r\n \"cash_type\": \"CAJA PRINCIPAL\",\r\n \"sales_code\": \"EPOS1\",\r\n \"subtotal\": \"1000000.00\"\r\n },\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 89008003,\r\n\t\t\"dv\": 2,\r\n\t\t\"name\": \"INVERSIONES DAVAL SAS\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexanderobandolondono@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 6,\r\n\t\t\"type_organization_id\": 1,\r\n \"type_liability_id\": 7,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1\r\n\t},\r\n\t\"payment_form\": {\r\n\t\t\"payment_form_id\": 1,\r\n\t\t\"payment_method_id\": 30,\r\n\t\t\"payment_due_date\": \"2024-08-14\",\r\n\t\t\"duration_measure\": \"0\"\r\n\t},\t\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"925925.925\",\r\n\t\t\"tax_exclusive_amount\": \"925925.925\",\r\n\t\t\"tax_inclusive_amount\": \"1000000.00\",\r\n\t\t\"payable_amount\": \"1000000.00\"\r\n\t},\r\n\t\"tax_totals\": [\r\n \t{\r\n\t\t\t\"tax_id\": 4,\r\n\t\t\t\"tax_amount\": \"74074.074\",\r\n\t\t\t\"taxable_amount\": \"925925.925\",\r\n\t\t\t\"percent\": \"8.00\"\r\n\t\t}\r\n\t],\r\n\t\"invoice_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"925925.925\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 4,\r\n\t\t\t\t\t\"tax_amount\": \"74074.074\",\r\n\t\t\t\t\t\"taxable_amount\": \"925925.925\",\r\n\t\t\t\t\t\"percent\": \"8.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"COMISION POR SERVICIOS\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"COMISION\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"1000000.00\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/eqdoc", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "eqdoc" ] }, "description": "# 🍽️ DOCUMENTO EQUIVALENTE POS - INC 8% (Punto de Venta - Restaurante)\n\n## 📄 Descripción General\n\nEste ejemplo demuestra la emisión de un **Documento Equivalente para Punto de Venta (POS)** con **Impuesto Nacional al Consumo (INC) al 8%**. Es el tipo de documento requerido en **restaurantes, bares, discotecas, servicios de comidas y telefonía**.\n\nA diferencia del ejemplo anterior (IVA 19%), aquí se aplica **INC** en lugar de IVA. El INC es un impuesto **obligatorio sobre servicios de comida**, regulado por DIAN con tarifa del **8% o 16%** según el tipo de establecimiento.\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/eqdoc\n```\n\n**Características:**\n- Tipo: Documento Equivalente - POS con INC\n- Modo: Síncrono (sin testSetId en URL)\n- Software POS: TORRE SOFTWARE - BABEL\n- Impuesto: **INC 8%** (Impuesto Nacional al Consumo)\n- Sector: Restaurantes, bares, servicios gastronómicos\n- Almacenamiento: `dont_send_yet: true` (modo offline)\n\n---\n\n## 🔑 Campos Principales - Variante con INC\n\n### Datos del Documento\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **type_document_id** | **15** | Documento Equivalente - POS |\n| **prefix** | EPOS | Prefijo autorizado para POS |\n| **number** | 46 | Número consecutivo |\n| **date** | 2024-08-14 | Fecha del documento |\n| **time** | 04:08:12 | Hora (Bogotá UTC-5) |\n| **resolution_number** | 18760000001 | Resolución DIAN 1876 |\n| **postal_zone_code** | 630003 | Código postal del establecimiento |\n\n### Software POS (Idéntico al ejemplo anterior)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **software_manufacturer.name** | ALEXANDER OBANDO LONDONO | Desarrollador |\n| **software_manufacturer.business_name** | TORRE SOFTWARE | Razón social |\n| **software_manufacturer.software_name** | BABEL | Nombre comercial |\n\n### Información de Caja/Operación (Idéntico al ejemplo anterior)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **cash_information.plate_number** | DF-000-12345 | Terminal/caja |\n| **cash_information.location** | HOTEL OVERLOOK RECEPCION | Ubicación física |\n| **cash_information.cashier** | JACK TORRANCE | Operador de caja |\n| **cash_information.cash_type** | CAJA PRINCIPAL | Clasificación |\n| **cash_information.sales_code** | EPOS1 | Referencia transacción |\n| **cash_information.subtotal** | 1.000.000,00 | Subtotal |\n\n### Programa de Fidelización\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **buyer_benefits.code** | 89008003 | NIT/cédula cliente |\n| **buyer_benefits.name** | INVERSIONES DAVAL SAS | Nombre cliente |\n| **buyer_benefits.points** | 100 | Puntos acumulados |\n\n### Cliente (customer)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **identification_number** | 89008003 | NIT cliente |\n| **type_document_identification_id** | 6 | Tipo: NIT |\n| **type_organization_id** | 1 | Persona jurídica |\n| **type_liability_id** | 7 | No responsable IVA |\n| **type_regime_id** | 1 | Régimen simplificado |\n| **name** | INVERSIONES DAVAL SAS | Razón social |\n\n### Forma de Pago\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **payment_form_id** | 1 | Contado |\n| **payment_method_id** | **30** | **Efectivo** |\n| **payment_due_date** | 2024-08-14 | Vencimiento |\n\n---\n\n## 💰 Línea y Cálculo con INC 8%\n\n| Concepto | Valor | Descripción |\n|----------|-------|-------------| \n| **description** | COMISION POR SERVICIOS | Servicio gastronómico |\n| **code** | COMISION | Código interno |\n| **unit_measure_id** | 70 | Unidad (UNIDAD) |\n| **invoiced_quantity** | 1,00 | Cantidad |\n| **price_amount** | 1.000.000,00 | Precio unitario |\n| **line_extension_amount** | 925.925,92 | **Subtotal con INC** |\n\n### Cálculo de Totales con INC 8% (Diferencia Crítica)\n\n| Componente | Valor | Fórmula | Explicación |\n|------------|-------|--------|-------------| \n| **Base Gravable (tax_exclusive)** | 925.925,92 | Precio ÷ 1.08 | Base antes de INC |\n| **INC (8%)** | **74.074,08** | 925.925,92 × 0,08 | **INC a cobrar** |\n| **TOTAL (tax_inclusive)** | 1.000.000,00 | 925.925,92 + 74.074,08 | **Total a pagar** |\n| **PAYABLE_AMOUNT** | **1.000.000,00** | - | Monto del recibo |\n\n### Impuesto (INC, NO IVA)\n\n```json\n\"tax_totals\": [{\n \"tax_id\": 4, // 4 = INC (NOT 1 = IVA)\n \"tax_amount\": \"74074.074\",\n \"percent\": \"8.00\", // 8% para restaurantes\n \"taxable_amount\": \"925925.926\"\n}]\n```\n\n**⚠️ CRÍTICO:** `tax_id: 4` para INC, **NO `tax_id: 1`** (que es IVA).\n\n---\n\n## 📝 Notas Importantes sobre POS con INC 8%\n\n### 📌 1. INC vs IVA: Diferencia Fundamental\n\n| Aspecto | IVA 19% (Ejemplo 1) | INC 8% (Este Ejemplo) |\n|--------|---|---| \n| **tax_id** | 1 | **4** |\n| **Tarifa** | 19% (estándar) | 8% (restaurantes) / 16% (otros) |\n| **Aplicación** | Bienes/servicios en general | Servicios de comida específicamente |\n| **Sectores** | Tiendas, comercios | Restaurantes, bares, cafés, discotecas |\n| **Fórmula** | Total = Base × 1.19 | Total = Base × 1.08 |\n| **Cliente** | Recupera si es responsable IVA | Consumidor final NO recupera |\n| **DIAN Código** | code_municipality_id: 1 (IVA) | code_municipality_id: 4 (INC) |\n\n**En este ejemplo:** INC 8%, no IVA. Usar en restaurantes, comidas para llevar, servicio a domicilio.\n\n### 📌 2. Cálculo Inverso: INC Incluido en Total\n\nA diferencia de IVA, en INC el total YA INCLUYE el impuesto:\n\n**Cliente paga:** 1.000.000,00 (todo incluido)\n\n**Desglose (calculado hacia atrás):**\n- Total con INC: 1.000.000,00\n- Descontar INC 8%: 1.000.000,00 ÷ 1.08 = 925.925,92 (base)\n- INC a pagar: 1.000.000,00 - 925.925,92 = 74.074,08\n\n**Verificación:**\n- 925.925,92 × 1.08 = 1.000.000,00 ✓\n\n### 📌 3. tax_id 4: Obligatorio para INC\n\nEn `tax_totals`:\n\n```json\n// ❌ INCORRECTO para restaurante:\n\"tax_id\": 1, // Esta es IVA, NO INC\n\n// ✓ CORRECTO para restaurante:\n\"tax_id\": 4, // INC (Impuesto Nacional al Consumo)\n```\n\nUsar `tax_id: 1` en restaurante = DIAN rechaza por tipo de impuesto incorrecto.\n\n### 📌 4. Tarifa INC: 8% vs 16%\n\n**INC 8%** (Este Ejemplo):\n- Restaurantes, bares, cafeterías\n- Servicios de comida/bebida en general\n- Hogares geriátricos, hospitales (servicios de alimentación)\n- Servicio a domicilio de comida\n\n**INC 16%**:\n- Algunos servicios específicos (telefonía, otros servicios)\n- Depende de clasificación DIAN\n\n**0%** (Exento):\n- Alimentos sin preparación (frutas, verduras, carnes crudas)\n- Medicinas\n- Periódicos, libros\n\nEn este ejemplo: 8% para comida/bebida en restaurante.\n\n### 📌 5. Casos de Uso: Restaurantes y Establecimientos Gastronómicos\n\n**Aplicar INC 8%:**\n- ✓ Restaurante con servicio de mesa\n- ✓ Pizzería, comida rápida (burgers, pollos)\n- ✓ Café/cafetería con bebidas y snacks\n- ✓ Bar, nightclub (bebidas alcohólicas)\n- ✓ Discoteca con servicio de bar\n- ✓ Comida para llevar (delivery, empaque)\n- ✓ Catering (servicios de comida)\n- ✓ Tienda de sushi, asiática con consumo en local\n\n**NO aplicar INC 8% (usar IVA 19%):**\n- ❌ Tienda de abarrotes (ventas sin consumo en local)\n- ❌ Panadería solo venta (sin café interno)\n- ❌ Carnicería (solo venta de carne)\n- ❌ Frutería\n- ❌ Farmacia\n- ❌ Gasolinera\n\n### 📌 6. Obligatoriedad de INC en Restaurantes\n\nLa DIAN **obliga** INC 8% en establecimientos gastronómicos:\n\n- No es opcional\n- Debe aplicarse a TODA transacción en restaurante\n- Rechazo 422 si falta o es tarifa incorrecta\n- Auditoría DIAN verifica INC vs type_document_id 15 y sector\n\n### 📌 7. Múltiples Items en Restaurante\n\nEjemplo con menú variado (cada línea con INC 8%):\n\n```json\n\"invoice_lines\": [\n {\n \"description\": \"Sancocho de Gallina\",\n \"invoiced_quantity\": \"2\",\n \"price_amount\": \"35000\",\n \"line_extension_amount\": \"70000\",\n \"tax_totals\": [{\n \"tax_id\": 4,\n \"percent\": \"8.00\",\n \"taxable_amount\": \"70000\",\n \"tax_amount\": \"5600\"\n }]\n },\n {\n \"description\": \"Jugo Natural\",\n \"invoiced_quantity\": \"2\",\n \"price_amount\": \"6500\",\n \"line_extension_amount\": \"13000\",\n \"tax_totals\": [{\n \"tax_id\": 4,\n \"percent\": \"8.00\",\n \"taxable_amount\": \"13000\",\n \"tax_amount\": \"1040\"\n }]\n },\n {\n \"description\": \"Pan de Queso\",\n \"invoiced_quantity\": \"1\",\n \"price_amount\": \"3000\",\n \"line_extension_amount\": \"3000\",\n \"tax_totals\": [{\n \"tax_id\": 4,\n \"percent\": \"8.00\",\n \"taxable_amount\": \"3000\",\n \"tax_amount\": \"240\"\n }]\n }\n]\n\n// Totales:\n// Base: 70000 + 13000 + 3000 = 86.000,00\n// INC 8%: 86000 × 0.08 = 6.880,00\n// TOTAL: 92.880,00\n```\n\nTODO tiene INC 8%, no hay mix de impuestos por línea.\n\n### 📌 8. Descuentos en Restaurante con INC\n\nSi cliente frecuente recibe 10% descuento:\n\n```json\n\"allowance_charges\": [{\n \"charge_indicator\": false,\n \"allowance_charge_reason\": \"Descuento cliente frecuente\",\n \"amount\": \"92880.00\", // 10% del total CON INC\n \"base_amount\": \"928800.00\"\n}]\n```\n\n**Nuevo cálculo:**\n- Total original: 92.880,00\n- Descuento 10%: -9.288,00\n- **Total a pagar: 83.592,00**\n\nEl descuento se aplica SOBRE el total con INC ya incluido.\n\n### 📌 9. Propina (Gratuidad) en Restaurante\n\nLa propina **NO es impuesto**, va como **cargo adicional** (charge_indicator: true):\n\n```json\n\"allowance_charges\": [{\n \"charge_indicator\": true,\n \"allowance_charge_reason\": \"Propina\",\n \"amount\": \"5640.00\", // 6% de propina sugerida\n \"base_amount\": \"92880.00\"\n}]\n```\n\n**Cálculo:**\n- Consumo: 92.880,00 (ya con INC 8%)\n- Propina 6% sugerida: 92.880,00 × 0.06 = 5.632,80\n- **Total con propina: 98.512,80**\n\nLa propina:\n- ✓ Se muestra en recibo\n- ✓ No afecta base tributaria\n- ✓ Es decisión del cliente\n- ✓ Se registra pero no entra en DIAN como impuesto\n\n### 📌 10. INC NO es Recuperable\n\n| Aspecto | IVA 19% | INC 8% |\n|--------|--------|--------| \n| **Responsable recupera en declaración** | ✓ Sí (si es empresa) | ✗ **NO** (es impuesto final) |\n| **Consumidor final paga** | ✓ Sí | ✓ Sí |\n| **Es gasible para empresa** | ✓ Parcialmente (si es acreedor) | ✗ **NO** |\n| **Afecta flujo de caja empresa** | ~ Recuperable más adelante | ✗ Gasto definitivo |\n\nPor eso restaurantes NO pueden recuperar INC en declaración de renta: es impuesto final al consumidor.\n\n### 📌 11. Validación DIAN: tax_id 4 Requiere Sector Gastronómico\n\nLa DIAN valida:\n\n```\nSI tax_id = 4 (INC)\nENTONCES type_document_id = 15 (POS)\nY establishment está registrado en DIAN como GASTRONÓMICO\n```\n\nSi envía INC en tienda de ropa: Error 422 \"Invalid tax_id for economic activity\".\n\n### 📌 12. Flujo POS en Restaurante\n\n**Secuencia típica:**\n1. Mesero toma orden en tablet/POS\n2. Cocina prepara comida\n3. Mesero lleva factura a mesa\n4. Cliente revisa consumo (comida, bebidas)\n5. Cliente efectúa pago en caja\n6. POS calcula: subtotal + INC 8% + (opcional: propina/descuento)\n7. Emite comprobante con CUFE y código QR\n8. Cliente recibe recibo (puede impreso o por WhatsApp)\n9. POS sincroniza con DIAN (si `dont_send_yet: false`) o almacena en local (si `dont_send_yet: true`)\n\n### 📌 13. Comparativa: Total Igual en Ambos Ejemplos pero Distinto Desglose\n\n**Ejemplo 1 (IVA 19%):**\n- Base: 840.336,13\n- IVA: +159.663,87\n- **Total: 1.000.000,00**\n\n**Ejemplo 2 (INC 8%) - Este:**\n- Base: 925.925,92\n- INC: +74.074,08\n- **Total: 1.000.000,00**\n\n**Mismo total al cliente, pero:**\n- En IVA: base menor, impuesto mayor (19%)\n- En INC: base mayor, impuesto menor (8%)\n\nPor eso INC 8% es más favorable para cliente que IVA 19%.\n\n### 📌 14. Frecuencia de Uso en Colombia\n\n- **Restaurantes:** 100% de facturas con INC 8%\n- **Cafeterías:** 100% de bebidas/snacks con INC 8%\n- **Bares/Discotecas:** 100% de bebidas con INC 8% (o 16% según municipio)\n- **Servicios Gastronómicos:** 100% con INC 8%\n\nEs tan común que sistemas POS asumen INC 8% automáticamente al detectar código CIIU gastronómico.\n\n### 📌 15. Errores Comunes al Cambiar a INC\n\n| Error | Consecuencia | Corrección |\n|-------|---|---| \n| Usar `tax_id: 1` (IVA) en restaurante | Error 422: \"Invalid tax structure\" | Cambiar a `tax_id: 4` |\n| Olvidar recalcular base (usar 1.19 en vez de 1.08) | Total incorrecto | Base = Total ÷ 1.08 |\n| Mezclar IVA 19% e INC 8% en líneas | Error DIAN | Todas las líneas: INC 8% |\n| Olvid copiar `percent` para INC | Cálculo incorrecto | Incluir `\"percent\": \"8.00\"` |\n| No cambiar `taxable_amount` | Totales descuadran | Usar base recalculada |\n| Enviar a DIAN con `dont_send_yet: true` olvidando `/send_pendings` | Documentos nunca llegan DIAN | Llamar `/api/ubl2.1/eqdoc/send_pendings` |" }, "response": [] }, { "name": "Una Linea, Sin Descuentos, Una Tarifa de IVA Copy", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "7692a20fec92af0aa5729d796b019d27c83c9955407994630a0cdd7702ca2329", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "host", "value": "apidian2026-8.oo", "type": "text", "disabled": true } ], "body": { "mode": "raw", "raw": "{\r\n\t\"number\": 503,\r\n\t\"type_document_id\": 15,\r\n\t\"date\": \"2024-05-28\",\r\n\t\"time\": \"04:08:12\",\r\n \"postal_zone_code\": \"630003\",\r\n\t\"resolution_number\": \"18760000001\",\r\n\t\"prefix\": \"EPOS\",\r\n \"notes\": \"ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA\",\r\n\t\"sendmail\": true,\r\n \"sendmailtome\": true,\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"software_manufacturer\":{\r\n \"name\": \"ALEXANDER OBANDO LONDONO\",\r\n \"business_name\": \"TORRE SOFTWARE\",\r\n \"software_name\": \"BABEL\"\r\n },\r\n \"buyer_benefits\":{\r\n \"code\": \"89008003\",\r\n \"name\": \"INVERSIONES DAVAL SAS\",\r\n \"points\": \"100\"\r\n },\r\n \"cash_information\":{\r\n \"plate_number\": \"DF-000-12345\",\r\n \"location\": \"HOTEL OVERLOOK RECEPCION\",\r\n \"cashier\": \"JACK TORRANCE\",\r\n \"cash_type\": \"CAJA PRINCIPAL\",\r\n \"sales_code\": \"EPOS1\",\r\n \"subtotal\": \"1000000.00\"\r\n },\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 89008003,\r\n\t\t\"dv\": 2,\r\n\t\t\"name\": \"INVERSIONES DAVAL SAS\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexanderobandolondono@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 6,\r\n\t\t\"type_organization_id\": 1,\r\n \"type_liability_id\": 7,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1\r\n\t},\r\n\t\"payment_form\": {\r\n\t\t\"payment_form_id\": 1,\r\n\t\t\"payment_method_id\": 30,\r\n\t\t\"payment_due_date\": \"2024-05-28\",\r\n\t\t\"duration_measure\": \"0\"\r\n\t},\t\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\"tax_exclusive_amount\": \"840336.134\",\r\n\t\t\"tax_inclusive_amount\": \"1000000.00\",\r\n\t\t\"payable_amount\": \"1000000.00\"\r\n\t},\r\n\t\"tax_totals\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\"percent\": \"19.00\",\r\n\t\t\t\"taxable_amount\": \"840336.134\"\r\n\t\t}\r\n\t],\r\n\t\"invoice_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\t\t\"taxable_amount\": \"840336.134\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"COMISION POR SERVICIOS\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"COMISION\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"1000000.00\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/eqdoc", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "eqdoc" ] }, "description": "# 📋 VARIANTE POS ESTÁNDAR - IVA 19% (Copia para Pruebas Alternas)\n\n## 📄 Descripción General\n\nEste es una **copia del primer ejemplo POS con IVA 19%** diseñada para pruebas alternativas, configuraciones de respaldo o validaciones de múltiples numeraciones consecutivas.\n\nMantiene **estructura idéntica** al primer ejemplo (IVA 19%, retail estándar) pero con **número de comprobante diferente** (503 vs 12) para simular una transacción distinta o un segundo turno de operación POS.\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/eqdoc\n```\n\n**Características:**\n- Tipo: Documento Equivalente - Punto de Venta\n- Modo: Síncrono (sin testSetId en URL)\n- Software POS: TORRE SOFTWARE - BABEL\n- Impuesto: IVA 19% (Igual al primer ejemplo)\n- Número consecutivo: 503 (diferente al primer ejemplo que es 12)\n- Caso de uso: Pruebas de numeración consecutiva, transacción múltiple\n\n---\n\n## 🔑 Diferencias Clave respecto al Primer Ejemplo\n\n| Campo | Ejemplo 1 | Esta Variante | Propósito |\n|-------|-----------|---------------|----------|\n| **number** | 12 | **503** | Simular numeración secuencial |\n| **date** | 2025-11-05 | 2024-05-28 | Fecha diferente (pruebas) |\n| **sendmailtome** | false | true | Enviar copia al emisor |\n| **Resto** | Idéntico | Idéntico | Estructura POS estándar |\n\n---\n\n## 📝 Guía de Uso\n\nUtilizar esta variante para:\n\n✓ **Pruebas de numeración:** Validar que consecutivos 12 y 503 se procesen correctamente\n✓ **Múltiples transacciones:** Simular flujo de diferentes comprobantes en mismo turno\n✓ **Validación de rango:** Verificar que ambos números están dentro del rango autorizado (1-999999)\n✓ **Respaldo/Recuperación:** Si el primer ejemplo falla, probar con esta variante\n✓ **Ambiente de testing:** Generar múltiples CUFE para validación de batch\n\n**Nota Importante:** Antes de enviar, asegúrese que ambos números (12 y 503) están autorizados en Config Company con type_document_id 15.\n\n---\n\n## 💡 Recomendaciones\n\n1. **No enviar simultáneamente ambos ejemplos** (12 y 503) a DIAN al mismo tiempo - puede causar rechazos por processing delay\n2. **Enviar secuencialmente:** Primero número 12, luego esperar respuesta, después número 503\n3. **Validar CUFE:** Cada número debe generar CUFE único\n4. **Usar dont_send_yet: true** si la red es inestable, luego procesar en batch con `/send_pendings`\n5. **Revisar logs:** Consultar `storage/logs/laravel.log` para diagnóstico si alguno falla\n\n---\n\n## 📌 Estructura Técnica\n\nPara referencia completa sobre campos, impuestos, cálculos y buenas prácticas, consulte la **documentación del Ejemplo 1: \"Una Linea, Sin Descuentos, Una Tarifa de IVA\"** (primer ejemplo del subsbloque POS) que contiene:\n\n- Descripción general completa\n- Estructura de campos obligatorios\n- Detalles de software_manufacturer\n- Información de cash_information\n- Cálculos de IVA 19%\n- 15+ notas sobre validaciones, flujos y casos de uso\n\n**Esta variante reutiliza la misma estructura.** Los únicos cambios son el número consecutivo y la fecha para simular una transacción diferente." }, "response": [] }, { "name": "Impuesto Bolsa", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "7692a20fec92af0aa5729d796b019d27c83c9955407994630a0cdd7702ca2329", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"number\": 40,\r\n\t\"type_document_id\": 15,\r\n\t\"date\": \"2024-07-02\",\r\n\t\"time\": \"04:08:12\",\r\n \"postal_zone_code\": \"630003\",\r\n\t\"resolution_number\": \"18760000001\",\r\n\t\"prefix\": \"EPOS\",\r\n \"notes\": \"ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA\",\r\n\t\"sendmail\": true,\r\n \"sendmailtome\": true,\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"software_manufacturer\":{\r\n \"name\": \"ALEXANDER OBANDO LONDONO\",\r\n \"business_name\": \"TORRE SOFTWARE\",\r\n \"software_name\": \"BABEL\"\r\n },\r\n \"buyer_benefits\":{\r\n \"code\": \"89008003\",\r\n \"name\": \"INVERSIONES DAVAL SAS\",\r\n \"points\": \"100\"\r\n },\r\n \"cash_information\":{\r\n \"plate_number\": \"DF-000-12345\",\r\n \"location\": \"HOTEL OVERLOOK RECEPCION\",\r\n \"cashier\": \"JACK TORRANCE\",\r\n \"cash_type\": \"CAJA PRINCIPAL\",\r\n \"sales_code\": \"EPOS1\",\r\n \"subtotal\": \"1000000.00\"\r\n },\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 89008003,\r\n\t\t\"dv\": 2,\r\n\t\t\"name\": \"INVERSIONES DAVAL SAS\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexanderobandolondono@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 6,\r\n\t\t\"type_organization_id\": 1,\r\n \"type_liability_id\": 7,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1\r\n\t},\r\n\t\"payment_form\": {\r\n\t\t\"payment_form_id\": 1,\r\n\t\t\"payment_method_id\": 30,\r\n\t\t\"payment_due_date\": \"2024-07-02\",\r\n\t\t\"duration_measure\": \"0\"\r\n\t},\t\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"840336.13\",\r\n\t\t\"tax_exclusive_amount\": \"840336.13\",\r\n\t\t\"tax_inclusive_amount\": \"1000500.00\",\r\n\t\t\"allowance_total_amount\": \"0.00\",\r\n\t\t\"charge_total_amount\": \"0.00\",\r\n\t\t\"payable_amount\": \"1000500.00\"\r\n\t},\r\n\t\"tax_totals\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"159663.86\",\r\n\t\t\t\"percent\": \"19\",\r\n\t\t\t\"taxable_amount\": \"840336.13\"\r\n\t\t},\r\n {\r\n \"tax_id\": 10,\r\n \"unit_measure_id\": \"70\",\r\n \"tax_amount\": \"500.00\",\r\n \"percent\": \"0\",\r\n \"taxable_amount\": \"500.00\",\r\n \"per_unit_amount\": \"50.00\",\r\n \"base_unit_measure\": \"1.00\"\r\n }\r\n\t],\r\n\t\"invoice_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"840336.13\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"allowance_charges\": [{\r\n\t\t\t\t\t\"charge_indicator\": false,\r\n\t\t\t\t\t\"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n\t\t\t\t\t\"amount\": \"0.00\",\r\n\t\t\t\t\t\"base_amount\": \"1000000.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"159663.86\",\r\n\t\t\t\t\t\"taxable_amount\": \"840336.13\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"COMISION POR SERVICIOS\",\r\n\t\t\t\"code\": \"COMISION\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"840336.13\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t},\t\r\n {\r\n \"unit_measure_id\": \"70\",\r\n \"invoiced_quantity\": \"10\",\r\n \"line_extension_amount\": \"0.00\",\r\n \"reference_price_id\": 3,\r\n \"free_of_charge_indicator\": true,\r\n \"allowance_charges\": [{\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"500.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": \"10\",\r\n \"unit_measure_id\": \"70\",\r\n \"tax_amount\": \"500.00\",\r\n \"taxable_amount\": \"0.00\",\r\n \"percent\": \"0.00\",\r\n \"per_unit_amount\": \"50.00\",\r\n \"base_unit_measure\": \"1.00\"\r\n }\r\n ],\r\n \"description\": \"INCBP IMPUESTO NACIONAL AL CONSUMO DE BOLSAS PLASTICAS\",\r\n \"code\": \"BOLSA\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"50.00\",\r\n \"base_quantity\": \"1\"\r\n }\r\n\t]\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/eqdoc", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "eqdoc" ] }, "description": "# 🛍️ POS CON IMPUESTO BOLSAS PLÁSTICAS (tax_id 10)\n\n## 📄 Descripción General\n\nEste ejemplo demuestra cómo incluir el **Impuesto Nacional al Consumo de Bolsas Plásticas (INCBP)** en documentos POS (`type_document_id: 15`). Según la **Ley 1819 de 2016**, todo establecimiento que entregue bolsas plásticas debe cobrar este impuesto.\n\n**Características clave:**\n- Impuesto: **$50 COP por bolsa** (tarifa 2025)\n- Estructura: IVA 19% + Impuesto Bolsa\n- Línea especial: Bolsas como bonificación (`free_of_charge: true`)\n- Cálculo: 10 bolsas × $50 = $500\n- Total documento: $1.000.500,00 (base + IVA + bolsas)\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/eqdoc\n```\n\n**Características:**\n- Tipo: Documento Equivalente POS\n- Modo: Síncrono\n- Impuestos: IVA 19% + INCBP\n- Cantidad bolsas: 10 unidades\n- Valor bolsas: $500,00 ($50 × 10)\n\n---\n\n## 🔑 Campos Principales\n\n### Documento\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **type_document_id** | 15 | POS |\n| **prefix** | EPOS | Prefijo |\n| **number** | 40 | Consecutivo |\n| **date** | 2024-07-02 | Fecha expedición |\n| **postal_zone_code** | 630003 | Código postal |\n\n### Tax Totals: Dos Impuestos\n\n**Impuesto 1: IVA 19%**\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **tax_id** | 1 | IVA |\n| **tax_amount** | 159.663,86 | Valor IVA |\n| **percent** | 19 | Tarifa |\n| **taxable_amount** | 840.336,13 | Base gravable |\n\n**Impuesto 2: Bolsas Plásticas**\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **tax_id** | **10** | **Impuesto Bolsas** |\n| **unit_measure_id** | 70 | Unidad |\n| **tax_amount** | **500,00** | **10 bolsas × $50** |\n| **percent** | 0 | Sin porcentaje |\n| **taxable_amount** | 500,00 | Base = tax_amount |\n| **per_unit_amount** | **50,00** | **$50 por bolsa** |\n| **base_unit_measure** | 1,00 | Unidad base |\n\n---\n\n## 📦 Estructura Invoice Lines\n\n**Línea 1: Servicio Principal**\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **description** | COMISION POR SERVICIOS | Concepto |\n| **invoiced_quantity** | 1 | Cantidad |\n| **line_extension_amount** | 840.336,13 | Subtotal |\n| **tax_id** | 1 | IVA 19% |\n| **price_amount** | 840.336,13 | Precio unitario |\n\n**Línea 2: Bolsas Plásticas (Especial)**\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **description** | **INCBP IMPUESTO NACIONAL AL CONSUMO DE BOLSAS PLASTICAS** | Concepto obligatorio |\n| **invoiced_quantity** | **10** | **10 bolsas** |\n| **line_extension_amount** | **0,00** | **Sin valor (bonificación)** |\n| **free_of_charge_indicator** | **true** | **Obligatorio: es bonificación** |\n| **reference_price_id** | **3** | **Referencia precio sin cargo** |\n| **tax_id** | **10** | **Impuesto Bolsas** |\n| **per_unit_amount** | **50,00** | **$50 por bolsa** |\n| **base_unit_measure** | 1,00 | Unidad base |\n| **price_amount** | 50,00 | Precio unitario bolsa |\n\n---\n\n## 💰 Cálculo de Totales\n\n### Línea 1: Servicio\n\n```\nBase gravable: 840.336,13\nIVA 19%: + 159.663,87\n─────────────────────────────\nSubtotal servicio: 1.000.000,00\n```\n\n### Línea 2: Bolsas\n\n```\nCantidad bolsas: 10\nPrecio por bolsa: × $50\n─────────────────────────────\nImpuesto bolsas: 500,00\n```\n\n### Total Documento\n\n| Concepto | Valor |\n|----------|-------| \n| **Subtotal servicios** | 840.336,13 |\n| **IVA 19%** | 159.663,87 |\n| **Impuesto Bolsas** | 500,00 |\n| **TOTAL A PAGAR** | **1.000.500,00** |\n\n---\n\n## 📝 Notas Críticas sobre Impuesto Bolsas\n\n### 📌 1. tax_id 10: Impuesto Bolsas Plásticas\n\n```json\n\"tax_totals\": [\n {\n \"tax_id\": 1, // IVA\n \"tax_amount\": \"159663.86\",\n \"percent\": \"19\"\n },\n {\n \"tax_id\": 10, // Bolsas\n \"unit_measure_id\": \"70\",\n \"tax_amount\": \"500.00\",\n \"percent\": \"0\",\n \"taxable_amount\": \"500.00\",\n \"per_unit_amount\": \"50.00\",\n \"base_unit_measure\": \"1.00\"\n }\n]\n```\n\n**Crítico:**\n- `tax_id: 10` es específico para bolsas (NO confundir con IVA o INC)\n- `per_unit_amount: 50.00` es la tarifa vigente 2025\n- `percent: 0` porque no es porcentual, es por unidad\n\n### 📌 2. Línea de Bolsas: free_of_charge_indicator true\n\n```json\n\"invoice_lines\": [\n {\n \"description\": \"INCBP IMPUESTO NACIONAL AL CONSUMO DE BOLSAS PLASTICAS\",\n \"invoiced_quantity\": \"10\",\n \"line_extension_amount\": \"0.00\", // Sin valor\n \"free_of_charge_indicator\": true, // Obligatorio\n \"reference_price_id\": 3, // Precio sin cargo\n \"tax_totals\": [\n {\n \"tax_id\": \"10\",\n \"per_unit_amount\": \"50.00\",\n \"base_unit_measure\": \"1.00\"\n }\n ]\n }\n]\n```\n\n**Por qué free_of_charge:**\n- Las bolsas NO se venden (son bonificación)\n- El impuesto se cobra en `tax_totals`, no en `line_extension_amount`\n- `line_extension_amount: 0.00` indica que no hay valor comercial\n- DIAN valida esta estructura específica\n\n### 📌 3. per_unit_amount: Tarifa por Bolsa\n\n```json\n\"per_unit_amount\": \"50.00\" // $50 pesos por bolsa (2025)\n```\n\n**Historia de tarifas:**\n\n| Año | Tarifa | Ley |\n|-----|--------|-----|\n| 2017 | $20 | Ley 1819/2016 |\n| 2018 | $30 | Actualización |\n| 2020 | $40 | Ajuste |\n| 2025 | **$50** | **Vigente** |\n\n### 📌 4. Cálculo del Impuesto\n\n```\nFórmula:\ntax_amount = invoiced_quantity × per_unit_amount × base_unit_measure\n\nEjemplo:\ntax_amount = 10 × 50.00 × 1.00 = 500.00\n```\n\n**Validación:**\n```json\n\"invoiced_quantity\": \"10\",\n\"per_unit_amount\": \"50.00\",\n\"base_unit_measure\": \"1.00\",\n\"tax_amount\": \"500.00\" // 10 × 50 × 1 = 500 ✓\n```\n\n### 📌 5. reference_price_id 3: Precio Sin Cargo\n\n```json\n\"reference_price_id\": 3 // Indica que es bonificación\n```\n\n**Opciones:**\n- `1` = Precio de venta\n- `2` = Precio sugerido\n- **`3` = Precio sin cargo (para bonificaciones)** ← Usar para bolsas\n\n### 📌 6. Diferencia: Impuesto Bolsa vs IVA\n\n| Aspecto | IVA (tax_id 1) | Bolsas (tax_id 10) |\n|---------|----------------|--------------------|\n| **Cálculo** | Porcentual (%) | Por unidad ($) |\n| **Campo clave** | `percent` | `per_unit_amount` |\n| **Base** | `taxable_amount` | `base_unit_measure` |\n| **Ejemplo** | 19% de 840.336 | $50 × 10 bolsas |\n| **Línea** | Producto/servicio | Línea separada bolsas |\n| **free_of_charge** | false | **true** |\n\n### 📌 7. payable_amount: Suma Total\n\n```json\n\"legal_monetary_totals\": {\n \"line_extension_amount\": \"840336.13\",\n \"tax_exclusive_amount\": \"840336.13\",\n \"tax_inclusive_amount\": \"1000500.00\", // Incluye IVA + Bolsas\n \"payable_amount\": \"1000500.00\"\n}\n```\n\n**Cálculo:**\n```\nBase: 840.336,13\nIVA 19%: + 159.663,87\nBolsas: + 500,00\n─────────────────────────\nTotal: 1.000.500,00\n```\n\n### 📌 8. Casos de Uso: Impuesto Bolsas\n\n**Caso 1: Supermercado (este ejemplo)**\n```\nCompra: $840.336,13 en productos\nBolsas entregadas: 10\nImpuesto bolsas: 10 × $50 = $500,00\nTotal a pagar: $1.000.500,00\n```\n\n**Caso 2: Tienda de Ropa**\n```\nCompra: $200.000,00 en ropa\nBolsas entregadas: 3\nImpuesto bolsas: 3 × $50 = $150,00\nTotal: $200.000,00 + IVA + $150,00\n```\n\n**Caso 3: Farmacia (sin bolsas)**\n```\nCompra: $50.000,00 en medicamentos\nBolsas: Cliente trae su propia bolsa\nImpuesto bolsas: $0,00\nTotal: $50.000,00 + IVA\n```\n\n### 📌 9. Validaciones DIAN\n\n**DIAN verifica:**\n\n✓ `tax_id: 10` existe en tax_totals \n✓ Línea de bolsas con `free_of_charge_indicator: true` \n✓ `per_unit_amount: 50.00` (tarifa vigente) \n✓ `tax_amount` = cantidad × per_unit \n✓ `payable_amount` incluye impuesto bolsas \n✓ `description` contiene \"INCBP\" o \"BOLSAS PLASTICAS\" \n\n❌ **Rechaza si:**\n- Falta línea de bolsas con tax_id 10\n- `free_of_charge_indicator: false` en línea bolsas\n- `per_unit_amount` diferente de $50\n- Cálculo incorrecto de tax_amount\n\n### 📌 10. Ley 1819 de 2016: Normativa\n\n**Obligación:**\n- Todo establecimiento que entregue bolsas plásticas\n- Cobro obligatorio de $50 por bolsa (2025)\n- Impuesto se paga a la DIAN (no queda en establecimiento)\n- Aplica para bolsas de cualquier tamaño\n\n**Exenciones:**\n- Bolsas biodegradables certificadas\n- Bolsas de papel\n- Bolsas reutilizables (tela, lona)\n- Cliente trae su propia bolsa\n\n### 📌 11. Errores Comunes\n\n| Error | Causa | Solución |\n|-------|-------|----------|\n| \"tax_id 10 not found\" | Falta impuesto bolsas en tax_totals | Agregar objeto con tax_id: 10 |\n| \"free_of_charge required\" | Línea bolsas sin free_of_charge | Agregar `\"free_of_charge_indicator\": true` |\n| \"Invalid per_unit_amount\" | Tarifa diferente de $50 | Usar `\"per_unit_amount\": \"50.00\"` |\n| \"Calculation mismatch\" | tax_amount no coincide con fórmula | Validar: cantidad × $50 |\n| \"Missing reference_price_id\" | Falta en línea bolsas | Agregar `\"reference_price_id\": 3` |\n| \"payable_amount incorrect\" | No suma impuesto bolsas | Incluir $500 en total |\n\n### 📌 12. Flujo Operativo: Supermercado\n\n**Escenario:**\nCliente compra en supermercado, necesita 10 bolsas.\n\n**Paso 1: Registro de Compra**\n```\nProductos: 840.336,13\nIVA 19%: + 159.663,87\n─────────────────────────\nSubtotal: 1.000.000,00\n```\n\n**Paso 2: Cliente Solicita Bolsas**\n```\nCajero: \"¿Necesita bolsas?\"\nCliente: \"Sí, 10 bolsas por favor\"\nCajero registra: 10 bolsas\n```\n\n**Paso 3: Sistema Calcula Impuesto**\n```\nBolsas: 10\nTarifa: $50 por bolsa\nImpuesto: 10 × $50 = $500,00\n```\n\n**Paso 4: Total Final**\n```\nSubtotal productos: 1.000.000,00\nImpuesto bolsas: + 500,00\n───────────────────────────────\nTotal a pagar: 1.000.500,00\n```\n\n**Paso 5: Emisión POS**\n```\nPOST /api/ubl2.1/eqdoc\nDIAN valida: ✓\nCUFE generado\nPDF con detalle de 10 bolsas × $50\n```\n\n### 📌 13. PDF: Lo que Cliente Ve\n\n```\n┌──────────────────────────────┐\n│ SUPERMERCADO EL AHORRO │\n│ DOCUMENTO EQUIVALENTE POS │\n│ EPOS-40 │\n│ 2024-07-02 │\n└──────────────────────────────┘\n\nDETALLE DE COMPRA:\n\nCOMISION POR SERVICIOS\nCantidad: 1\nValor: $840.336,13\nIVA 19%: $159.663,87\n──────────────────────────\nSubtotal: $1.000.000,00\n\n📦 BOLSAS PLÁSTICAS\nCantidad: 10 bolsas\nImpuesto por bolsa: $50,00\nTotal impuesto bolsas: $500,00\n──────────────────────────\n\n════════════════════════════\nTOTAL A PAGAR: $1.000.500,00\n════════════════════════════\n\n⚠️ Impuesto bolsas plásticas\n según Ley 1819/2016\n💚 Traiga su bolsa reutilizable\n y ahorre $500 en su próxima\n compra\n```\n\n### 📌 14. Comparativa: Con vs Sin Bolsas\n\n**Compra CON bolsas (10):**\n```\nProductos: 840.336,13\nIVA 19%: + 159.663,87\nBolsas (10): + 500,00\n─────────────────────────\nTotal: 1.000.500,00\n```\n\n**Compra SIN bolsas (cliente trae la suya):**\n```\nProductos: 840.336,13\nIVA 19%: + 159.663,87\nBolsas: + 0,00\n─────────────────────────\nTotal: 1.000.000,00\n\nAhorro: $500,00 🎉\n```\n\n### 📌 15. Resumen: Impuesto Bolsas en POS\n\n- **Propósito:** Cobrar impuesto bolsas plásticas según ley\n- **Tarifa:** $50 por bolsa (2025)\n- **tax_id:** 10 (específico bolsas)\n- **Estructura:** Línea separada con `free_of_charge: true`\n- **Cálculo:** Cantidad × $50 = tax_amount\n- **Total:** Base + IVA + Bolsas\n- **DIAN valida:** Estructura, tarifa, cálculo\n- **Impacto:** Cliente paga $50 extra por cada bolsa\n- **Alternativa:** Cliente trae bolsa reutilizable = $0" }, "response": [] }, { "name": "Enviar Pendientes POS", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/eqdoc/send_pendings", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "eqdoc", "send_pendings" ] }, "description": "# 📡 ENVIAR DOCUMENTOS POS PENDIENTES (Modo Offline)\n\n## 📄 Descripción General\n\nEndpoint especializado para **enviar en lote** todos los documentos POS (`type_document_id: 15`) que fueron almacenados localmente con la bandera `dont_send_yet: true`. Diseñado para sistemas POS con **conectividad intermitente** que acumulan facturas offline y las transmiten posteriormente cuando hay conexión estable.\n\n**Características clave:**\n- **Sin body requerido**: Endpoint sin parámetros JSON\n- **Procesamiento automático**: Busca todos los POS pendientes del usuario autenticado\n- **Envío secuencial**: Transmite cada documento a DIAN uno por uno\n- **Respuesta detallada**: Array con resultados individuales (CUFE, PDF, XML, estado)\n- **Casos de uso**: Restaurantes, tiendas remotas, eventos masivos\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/eqdoc/send_pendings\n```\n\n**Características:**\n- **Método:** POST\n- **Body:** Vacío (sin JSON)\n- **Autenticación:** Bearer token (obligatorio)\n- **Timeout:** 120 segundos (para lotes grandes)\n- **Rate limit:** 50 documentos por minuto\n\n---\n\n## 🔑 Estructura del Request\n\n### Headers\n\n| Header | Valor | Obligatorio |\n|--------|-------|-------------|\n| **Authorization** | Bearer {token} | ✓ Sí |\n| **Content-Type** | application/json | ✓ Sí |\n| **Accept** | application/json | ✓ Sí |\n\n### Body\n\n```json\n\"\" // Vacío, sin parámetros\n```\n\n**No se requiere JSON.** El endpoint automáticamente:\n1. Identifica el usuario por el `api_token` del Authorization header\n2. Busca en BD todos los POS con `status: 'pending'` y `dont_send_yet: true`\n3. Procesa cada documento en orden FIFO (primero creado, primero enviado)\n\n---\n\n## 📦 Estructura de la Respuesta\n\n### Respuesta Exitosa (200 OK)\n\n```json\n[\n {\n \"id\": 12345,\n \"number\": \"EPOS-38\",\n \"cufe\": \"abc123...def789\",\n \"status\": \"Validating\",\n \"pdf_url\": \"https://api.com/storage/pdf/EPOS-38.pdf\",\n \"xml_url\": \"https://api.com/storage/xml/EPOS-38.xml\",\n \"ApplicationResponse\": {\n \"ResponseCode\": \"00\",\n \"ResponseDescription\": \"Documento validado exitosamente\"\n }\n },\n {\n \"id\": 12346,\n \"number\": \"EPOS-39\",\n \"cufe\": \"xyz456...uvw123\",\n \"status\": \"Processed\",\n \"pdf_url\": \"https://api.com/storage/pdf/EPOS-39.pdf\",\n \"xml_url\": \"https://api.com/storage/xml/EPOS-39.xml\",\n \"ApplicationResponse\": {\n \"ResponseCode\": \"00\",\n \"ResponseDescription\": \"Aprobado\"\n }\n }\n]\n```\n\n### Campos de la Respuesta\n\n| Campo | Tipo | Descripción |\n|-------|------|-------------|\n| **id** | integer | ID interno del documento |\n| **number** | string | Número consecutivo (EPOS-XX) |\n| **cufe** | string | Código Único Factura Electrónica |\n| **status** | string | Estado: Validating, Processed, Rejected |\n| **pdf_url** | string | URL del PDF firmado |\n| **xml_url** | string | URL del XML UBL 2.1 |\n| **ApplicationResponse** | object | Respuesta DIAN |\n\n---\n\n## 📝 Notas Críticas sobre send_pendings\n\n### 📌 1. Flujo: Modo Offline → Envío Diferido\n\n**Paso 1: Generación Offline (durante el día)**\n```json\nPOST /api/ubl2.1/eqdoc\n{\n \"type_document_id\": 15,\n \"number\": 38,\n \"dont_send_yet\": true, // ← Clave: NO enviar a DIAN aún\n \"invoice_lines\": [...]\n}\n```\n\n**Resultado:**\n- Documento guardado en BD con `status: 'pending'`\n- CUFE generado localmente\n- Sin transmisión a DIAN\n- Sin PDF/XML en respuesta\n\n**Paso 2: Acumulación**\n```\nDocumentos pendientes acumulados:\n- EPOS-38 (12:30 PM)\n- EPOS-39 (13:15 PM)\n- EPOS-40 (14:00 PM)\n- EPOS-41 (15:30 PM)\n- EPOS-42 (16:45 PM)\n\nTotal: 5 documentos pendientes\n```\n\n**Paso 3: Envío en Lote (al final del día)**\n```json\nPOST /api/ubl2.1/eqdoc/send_pendings\n// Body vacío\n```\n\n**Resultado:**\n```json\n[\n {\"number\": \"EPOS-38\", \"status\": \"Processed\"},\n {\"number\": \"EPOS-39\", \"status\": \"Validating\"},\n {\"number\": \"EPOS-40\", \"status\": \"Processed\"},\n {\"number\": \"EPOS-41\", \"status\": \"Rejected\"}, // ← Revisar\n {\"number\": \"EPOS-42\", \"status\": \"Processed\"}\n]\n```\n\n### 📌 2. dont_send_yet: true - Bandera Crítica\n\n```json\n{\n \"type_document_id\": 15,\n \"dont_send_yet\": true // ← Modo offline\n}\n```\n\n**Efecto:**\n- ✓ Documento se guarda en BD\n- ✓ CUFE se genera\n- ✓ Validaciones básicas se ejecutan\n- ✗ **NO** se envía a DIAN\n- ✗ **NO** se genera PDF/XML\n- ✗ **NO** se retorna ApplicationResponse\n\n**Uso:**\n```json\n// Modo online (normal)\n{\n \"dont_send_yet\": false // o no incluir campo (default: false)\n}\n\n// Modo offline (para enviar después)\n{\n \"dont_send_yet\": true\n}\n```\n\n### 📌 3. Sin Body Requerido\n\n```bash\n# Correcto\ncurl -X POST https://api.com/api/ubl2.1/eqdoc/send_pendings \\\n -H \"Authorization: Bearer {token}\" \\\n -H \"Content-Type: application/json\" \\\n -d \"\"\n\n# También correcto (omitir -d)\ncurl -X POST https://api.com/api/ubl2.1/eqdoc/send_pendings \\\n -H \"Authorization: Bearer {token}\"\n```\n\n**Por qué no requiere body:**\n- El `api_token` identifica al usuario\n- La API busca automáticamente todos sus documentos pendientes\n- No hay filtros ni parámetros opcionales\n\n### 📌 4. Procesamiento Secuencial\n\n**Orden FIFO (First In, First Out):**\n\n```\nDocumentos pendientes:\n1. EPOS-38 (creado: 2024-07-02 12:30)\n2. EPOS-39 (creado: 2024-07-02 13:15)\n3. EPOS-40 (creado: 2024-07-02 14:00)\n\nProcesamiento:\nPaso 1: Envía EPOS-38 → Espera respuesta DIAN (2-5 seg)\nPaso 2: Envía EPOS-39 → Espera respuesta DIAN\nPaso 3: Envía EPOS-40 → Espera respuesta DIAN\n\nResultado: Array con 3 resultados\n```\n\n**Tiempo estimado:**\n- 1 documento: ~3 segundos\n- 10 documentos: ~30 segundos\n- 50 documentos: ~2.5 minutos\n- 100 documentos: ~5 minutos (cerca del timeout)\n\n### 📌 5. Manejo de Errores Parciales\n\n**Escenario: 5 documentos, 1 falla**\n\n```json\n[\n {\"number\": \"EPOS-38\", \"status\": \"Processed\"}, // ✓ OK\n {\"number\": \"EPOS-39\", \"status\": \"Processed\"}, // ✓ OK\n {\"number\": \"EPOS-40\", \"status\": \"Rejected\", // ✗ Error\n \"ApplicationResponse\": {\n \"ResponseCode\": \"02\",\n \"ResponseDescription\": \"Total de factura no coincide\"\n }},\n {\"number\": \"EPOS-41\", \"status\": \"Processed\"}, // ✓ OK\n {\"number\": \"EPOS-42\", \"status\": \"Processed\"} // ✓ OK\n]\n```\n\n**Comportamiento:**\n- El proceso **NO se detiene** si un documento falla\n- Continúa con los siguientes documentos\n- Retorna resultados de todos (exitosos y fallidos)\n- HTTP Status: **200 OK** (no 422, porque no es error del endpoint)\n\n**Acción del desarrollador:**\n```javascript\nconst results = await sendPendings();\nconst failures = results.filter(r => r.status === 'Rejected');\n\nif (failures.length > 0) {\n console.log('Documentos fallidos:', failures);\n // Revisar y corregir documentos rechazados\n // Re-intentar envío individual\n}\n```\n\n### 📌 6. Estados de Documentos\n\n| Estado | Significado | Siguiente acción |\n|--------|-------------|------------------|\n| **Validating** | DIAN recibió, validando | Esperar 1-2 min, consultar estado |\n| **Processed** | Aprobado por DIAN | PDF/XML disponibles |\n| **Rejected** | Rechazado por DIAN | Revisar ApplicationResponse, corregir |\n| **pending** | No enviado aún | Espera send_pendings |\n\n### 📌 7. Casos de Uso Reales\n\n**Caso 1: Restaurante con Internet Inestable**\n\n```\nProblema:\nRestaurante en zona con WiFi intermitente\nHorario pico: 12:00-15:00 y 19:00-22:00\nNo puede esperar DIAN en cada factura (lentitud)\n\nSolución:\n1. Durante servicio: dont_send_yet: true\n2. Acumula 150 facturas del día\n3. A las 23:00 (conexión estable): send_pendings\n4. Transmite todas en ~7 minutos\n\nBeneficios:\n- Servicio rápido (sin esperar DIAN)\n- Facturación continua (sin interrupciones)\n- Envío nocturno (horario bajo tráfico)\n```\n\n**Caso 2: Feria o Evento Masivo**\n\n```\nProblema:\nFeria con 20 stands\nConexión 4G compartida (saturada)\n500 ventas en 6 horas\n\nSolución:\n1. Cada stand genera POS offline\n2. Acumula facturas localmente\n3. Al cerrar feria: send_pendings por stand\n4. Transmisión escalonada:\n - Stand 1: 20:00 (50 docs)\n - Stand 2: 20:10 (45 docs)\n - Stand 3: 20:20 (60 docs)\n ...\n\nBeneficios:\n- No depende de conexión en horario pico\n- Evita colapso de red\n- Todas las facturas se envían al final\n```\n\n**Caso 3: Tienda Zona Rural**\n\n```\nProblema:\nTienda en zona rural\nInternet solo disponible 2 horas/día (8-10 AM)\n30 ventas diarias\n\nSolución:\n1. Todo el día: dont_send_yet: true\n2. Acumula 30 facturas (8 AM - 6 PM)\n3. Próximo día 8:00 AM: send_pendings\n4. Transmite facturas del día anterior\n\nBeneficios:\n- Opera sin internet todo el día\n- Cumple con DIAN (envío diferido permitido)\n- Aprovecha ventana de conectividad\n```\n\n### 📌 8. Timeout y Rate Limits\n\n**Timeout del endpoint:**\n```\nTimeout API: 120 segundos\nTiempo promedio por doc: 3 segundos\nCapacidad máxima: ~40 documentos por llamada\n```\n\n**Si tienes más de 40 documentos:**\n```javascript\n// Envío en lotes\nfor (let i = 0; i < totalDocs; i += 40) {\n await sendPendings();\n await sleep(10000); // Espera 10 seg entre lotes\n}\n```\n\n**Rate limit DIAN:**\n```\nLímite: 50 documentos/minuto por empresa\nSi excede: HTTP 429 Too Many Requests\nRecomendación: Máximo 30 docs/minuto para margen\n```\n\n### 📌 9. Validaciones Antes del Envío\n\n**La API valida cada documento antes de enviar:**\n\n✓ Certificado digital vigente \n✓ Totales correctos (IVA, payable_amount) \n✓ Resolución DIAN activa \n✓ Consecutivo dentro del rango autorizado \n✓ Fecha dentro de los 30 días \n✓ CUFE calculado correctamente \n\n❌ **Si falla validación:**\n```json\n{\n \"number\": \"EPOS-40\",\n \"status\": \"Rejected\",\n \"ApplicationResponse\": {\n \"ResponseCode\": \"99\",\n \"ResponseDescription\": \"Certificado vencido\"\n }\n}\n```\n\n### 📌 10. Diferencia: Offline vs Online\n\n| Aspecto | Modo Online (normal) | Modo Offline (dont_send_yet) |\n|---------|---------------------|------------------------------|\n| **Envío a DIAN** | Inmediato | Diferido (send_pendings) |\n| **Tiempo respuesta** | 3-5 segundos | Instantáneo (local) |\n| **PDF/XML** | Retornado en respuesta | Generado en send_pendings |\n| **ApplicationResponse** | Incluido | Solo en send_pendings |\n| **Uso** | Conexión estable | Conectividad intermitente |\n| **Riesgo** | Falla DIAN = venta bloqueada | Sin bloqueo, envío posterior |\n\n### 📌 11. Errores Comunes\n\n| Error | Causa | Solución |\n|-------|-------|----------|\n| \"No pending documents\" | No hay POS con dont_send_yet | Verificar que se crearon con bandera true |\n| \"Authentication failed\" | Token inválido | Renovar bearer token |\n| \"Timeout\" | Más de 40 documentos | Enviar en lotes de 30-40 |\n| \"Certificate expired\" | Certificado digital vencido | Renovar certificado DIAN |\n| \"Resolution inactive\" | Resolución DIAN expirada | Obtener nueva resolución |\n| \"HTTP 429\" | Rate limit excedido | Esperar 60 seg, reducir velocidad |\n\n### 📌 12. Monitoreo y Logs\n\n**Log de envío:**\n```json\n{\n \"timestamp\": \"2024-07-02 20:05:30\",\n \"action\": \"send_pendings\",\n \"user_id\": 123,\n \"total_pending\": 50,\n \"sent\": 50,\n \"processed\": 48,\n \"rejected\": 2,\n \"duration\": \"2m 35s\",\n \"failed_documents\": [\"EPOS-15\", \"EPOS-32\"]\n}\n```\n\n**Métricas recomendadas:**\n- Cantidad de documentos pendientes por hora\n- Tiempo promedio de procesamiento\n- Tasa de rechazo DIAN\n- Horarios de mayor acumulación\n\n### 📌 13. Respuestas HTTP\n\n| Código | Descripción | Acción |\n|--------|-------------|--------|\n| **200 OK** | Procesamiento exitoso (revisar array) | Validar status de cada documento |\n| **401 Unauthorized** | Token inválido o expirado | Renovar autenticación |\n| **404 Not Found** | Endpoint incorrecto | Verificar URL: /eqdoc/send_pendings |\n| **422 Unprocessable** | No hay documentos pendientes | Normal, no hay nada que enviar |\n| **429 Too Many Requests** | Rate limit excedido | Esperar 60 segundos |\n| **500 Internal Server** | Error servidor o timeout DIAN | Reintentar en 5 minutos |\n| **504 Gateway Timeout** | Timeout (>120 seg) | Reducir lote a 30 documentos |\n\n### 📌 14. Testing y Desarrollo\n\n**Flujo de prueba:**\n\n```javascript\n// 1. Crear POS offline\nconst doc1 = await createPOS({ dont_send_yet: true });\nconst doc2 = await createPOS({ dont_send_yet: true });\nconst doc3 = await createPOS({ dont_send_yet: true });\n\nconsole.log('3 documentos pendientes creados');\n\n// 2. Verificar que están pendientes\nconst status = await checkPendingCount(); // Debe ser 3\n\n// 3. Enviar todos\nconst results = await sendPendings();\n\n// 4. Validar resultados\nresults.forEach(r => {\n console.log(`${r.number}: ${r.status}`);\n if (r.status === 'Rejected') {\n console.error('Error:', r.ApplicationResponse);\n }\n});\n\n// 5. Verificar que ya no hay pendientes\nconst remaining = await checkPendingCount(); // Debe ser 0\n```\n\n### 📌 15. Resumen: send_pendings\n\n- **Propósito:** Enviar lote de POS offline a DIAN\n- **Body:** Vacío (sin JSON)\n- **Lógica:** Busca todos los `dont_send_yet: true` del usuario\n- **Procesamiento:** Secuencial (uno por uno)\n- **Respuesta:** Array con resultados individuales\n- **Timeout:** 120 segundos (~40 documentos)\n- **Errores:** No detiene el proceso, continúa con siguientes\n- **Casos de uso:** Conectividad intermitente, eventos, horarios pico\n- **Beneficio:** Servicio rápido + cumplimiento DIAN diferido" }, "response": [] }, { "name": "NC Una Linea, Sin Descuentos, Una Tarifa de IVA Copy", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"is_eqdoc\": true,\r\n\t\"billing_reference\": {\r\n\t\t\"number\": \"EPOS11\",\r\n\t\t\"uuid\": \"4330571e42ae249e98025c8fb6312fef97a58cbda65584ef43e2e002c6d6be107fcc0dd1dd662273c871f6ee0bb72de7\",\r\n\t\t\"issue_date\": \"2025-11-04\",\r\n \"type_document_id\": 15\r\n\t},\r\n\t\"discrepancyresponsecode\": 2,\r\n \"notes\": \"PRUEBA DE NOTA CREDITO A DOCUMENTO EQUIVALENTE POS\",\r\n \"prefix\": \"NCP\",\r\n\t\"number\": 1,\r\n\t\"type_document_id\": 26,\r\n\t\"date\": \"2025-11-04\",\r\n\t\"time\": \"06:00:13\",\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"sendmail\": false,\r\n \"sendmailtome\": false,\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 900166483,\r\n\t\t\"dv\": 1,\r\n\t\t\"name\": \"INVERSIONES DAVAL SAS\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexanderobandolondono@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 6,\r\n\t\t\"type_organization_id\": 1,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1\r\n\t},\r\n\t\"tax_totals\": [\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"15966.386\",\r\n\t\t\t\"percent\": \"19\",\r\n\t\t\t\"taxable_amount\": \"84033.614\"\r\n\t\t}\r\n\t],\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"84033.614\",\r\n\t\t\"tax_exclusive_amount\": \"84033.614\",\r\n\t\t\"tax_inclusive_amount\": \"100000.00\",\r\n\t\t\"payable_amount\": \"100000.00\"\r\n\t},\r\n\t\"credit_note_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"84033.614\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"15966.386\",\r\n\t\t\t\t\t\"taxable_amount\": \"84033.614\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"COMISION POR SERVICIOS\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"COMISION\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"100000.00\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/credit-note", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "credit-note" ] }, "description": "# 📋 NOTA CRÉDITO DOCUMENTO EQUIVALENTE POS (type_document_id 26)\n\n## 📄 Descripción General\n\nEsta es una **Nota Crédito para anular o ajustar documentos POS** emitidos anteriormente. Es el mecanismo para:\n- **Anulaciones totales:** Cliente devuelve producto/servicio sin usar\n- **Devoluciones parciales:** Ajuste de cantidad o precio erróneo\n- **Cambios/canjes:** Cliente quiere otro producto de diferente valor\n- **Promociones posteriores:** Descuento aplicado después de la venta original\n\nLa nota crédito replica la estructura del POS original pero genera un **nuevo CUFE** y tiene **validez legal independiente** ante DIAN.\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/credit-note\n```\n\n**Características:**\n- Tipo: Nota Crédito de Documento Equivalente POS\n- Modo: Síncrono (sin testSetId en URL)\n- Documento vinculado: Documento Equivalente POS (type_document_id 15)\n- Motivo: Anulación, devolución, ajuste de precio/cantidad\n- Respuesta: CUFE, PDF, XML firmado\n\n---\n\n## 🔑 Campos Principales\n\n### Referencia al Documento Original\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **is_eqdoc** | **true** | Indica que es NC de documento equivalente |\n| **billing_reference.number** | EPOS11 | Prefijo + número del POS original |\n| **billing_reference.uuid** | 4330571e... | CUFE del POS original (identificador único) |\n| **billing_reference.issue_date** | 2025-11-04 | Fecha de emisión del POS original |\n| **billing_reference.type_document_id** | **15** | **Indica que anula un POS** |\n\n### Identificación de la Nota Crédito\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **type_document_id** | **26** | **Tipo: Nota Crédito** |\n| **prefix** | NCP | Prefijo autorizado para notas crédito |\n| **number** | 1 | Número consecutivo de la NC |\n| **date** | 2025-11-04 | Fecha de emisión de la NC |\n| **time** | 06:00:13 | Hora (Bogotá UTC-5) |\n\n### Motivo de la Nota Crédito\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **discrepancyresponsecode** | **2** | **2 = Crédito (anulación/devolución)** |\n| **notes** | \"PRUEBA DE NOTA...\" | Explicación detallada del motivo |\n| **head_note** | Texto libre | Encabezado visible en PDF |\n| **foot_note** | Texto libre | Pie de página visible en PDF |\n\n### Establecimiento/Punto de Venta\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **establishment_name** | TORRE SOFTWARE | Nombre del local |\n| **establishment_address** | BRR LIMONAR MZ 6... | Dirección del local |\n| **establishment_phone** | 3226563672 | Teléfono de contacto |\n| **establishment_municipality** | 600 | Código DANE municipio |\n\n### Cliente (Idéntico al POS Original)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **identification_number** | 900166483 | NIT/cédula del cliente |\n| **type_document_identification_id** | 6 | Tipo: NIT |\n| **name** | INVERSIONES DAVAL SAS | Razón social |\n| **type_organization_id** | 1 | Persona jurídica |\n| **type_regime_id** | 1 | Régimen simplificado |\n\n---\n\n## 💰 Cálculo de Montos\n\n| Componente | Valor | Descripción |\n|------------|-------|-------------| \n| **Base gravable** | 84.033,61 | Subtotal sin impuestos |\n| **IVA 19%** | 15.966,39 | Impuesto a descontar |\n| **Total a descontar** | 100.000,00 | Monto de la devolución |\n\n### Lógica de Cálculo\n\n```\nNC = Anulación de 100.000,00 del POS original\n\nDesglose:\n- Base (tax_exclusive): 100.000,00 ÷ 1.19 = 84.033,61\n- IVA 19%: 84.033,61 × 0.19 = 15.966,39\n- Verificación: 84.033,61 + 15.966,39 = 100.000,00 ✓\n```\n\n---\n\n## 📝 Notas Importantes sobre Notas Crédito POS\n\n### 📌 1. Vinculación Crítica: UUID/CUFE del POS Original\n\n```json\n\"billing_reference\": {\n \"uuid\": \"4330571e42ae249e98025c8fb6312fef...\"\n}\n```\n\n**El UUID DEBE ser exacto:**\n- ✗ INCORRECTO: UUID fabricado o incorrecto → DIAN rechaza\n- ✓ CORRECTO: UUID devuelto en respuesta 200 OK del POS\n- 🔍 Cómo obtenerlo: Consultar `/api/ubl2.1/status/document/{cufe}` si fue perdido\n\n**Importancia:**\n- DIAN valida que NC corresponda a POS válido y no sea duplicada\n- Auditoría interna puede rastrear cadena completa: POS original → NC → devolución\n- Afecta liquidación de IVA: el crédito se vincula al tributo original\n\n### 📌 2. discrepancyresponsecode: 2 (Crédito)\n\n```json\n\"discrepancyresponsecode\": 2 // Crédito (descuento/devolución)\n```\n\n**Códigos de respuesta:**\n- **1:** Factura emitida con errores en la emisión (raro en POS)\n- **2:** Crédito por devoluciones, descuentos, anulaciones ← **Este caso**\n- **3:** Débito por cobro adicional (no se usa en devoluciones)\n- **4:** Cambio del número del documento\n- **5:** Cambio de referencia de POS (cambio de transacción)\n\nEn POS retail, siempre es **2 (crédito)**.\n\n### 📌 3. is_eqdoc: true (Obligatorio para POS)\n\n```json\n\"is_eqdoc\": true // Indica que anula documento equivalente (POS)\n```\n\n**Diferencia crítica:**\n- Si `is_eqdoc: false` → Nota crédito de factura estándar\n- Si `is_eqdoc: true` → Nota crédito de documento equivalente (POS, transporte, cine)\n\nSi omite o pone `false` en POS: DIAN rechaza con error \"Type mismatch\".\n\n### 📌 4. credit_note_lines vs invoice_lines\n\n```json\n// Estructura de NC (usa credit_note_lines, NO invoice_lines):\n\"credit_note_lines\": [{\n \"description\": \"COMISION POR SERVICIOS\",\n \"invoiced_quantity\": \"1\",\n \"price_amount\": \"100000.00\",\n \"line_extension_amount\": \"84033.614\",\n \"tax_totals\": [{\n \"tax_id\": 1,\n \"tax_amount\": \"15966.386\",\n \"taxable_amount\": \"84033.614\",\n \"percent\": \"19.00\"\n }]\n}]\n```\n\n**Nota:** Usar `credit_note_lines`, NO `invoice_lines` como en POS.\n\n### 📌 5. Anulación Total vs Parcial\n\n**Anulación Total:** NC de todo el POS\n```json\n\"payable_amount\": \"100000.00\" // Mismo monto que POS original\n\"notes\": \"ANULACION TOTAL VENTA DEL 04-NOV POS11\"\n```\n\n**Anulación Parcial:** Devolución de parte del POS\n```json\n\"payable_amount\": \"50000.00\" // Solo mitad del original\n\"notes\": \"DEVOLUCION PARCIAL: Cliente devuelve 1 unidad de 2 compradas\"\n```\n\n⚠️ **Crítico:** `payable_amount` NC **NO PUEDE** exceder `payable_amount` POS original.\n\n### 📌 6. Motivos Comunes de Notas Crédito en Retail POS\n\n| Motivo | Ejemplo | discrepancyresponsecode | Notas |\n|--------|---------|---|---|\n| **Devolución completa** | Cliente desiste sin abrir producto | 2 | NC cubre 100% del POS |\n| **Devolución parcial** | De 3 prendas, devuelve 1 | 2 | NC proporcional al artículo |\n| **Defecto/Garantía** | Producto dañado, cliente requiere cambio | 2 | NC anula defectuoso |\n| **Descuento posterior** | \"Paga 10% menos si devuelves recibo\" | 2 | NC por descuento |\n| **Cambio de producto** | Cliente no le gustó, trae otro | 2 | NC del original + nueva venta |\n| **Error precio** | Se cobró más de lo correcto | 2 | NC por diferencia |\n| **Error cantidad** | Se emitió por 2 unidades, fue solo 1 | 2 | NC proporcional |\n\n### 📌 7. Flujo Temporal: Cuándo Emitir NC\n\n**Antes de emitir NC:**\n1. POS original debe estar validado por DIAN (state_document_id 1 = Validado)\n2. Cliente solicita devolución/ajuste\n3. Verificar que el motivo es válido (no es fraude)\n4. Contar con original o comprobante de pago\n\n**Proceso de emisión:**\n1. Capturar UUID exacto del POS original\n2. Calcular montos: base = POS ÷ 1.19, IVA = base × 0.19\n3. Enviar POST `/credit-note` con `billing_reference.uuid`\n4. DIAN valida y retorna nuevo CUFE para NC\n\n**Después de emitir NC:**\n1. Guardar CUFE de NC en sistema POS\n2. Vincular NC → POS en registros internos\n3. Imprimir PDF de NC para cliente\n4. Actualizar inventario si aplica (reintegro de producto)\n5. Ajustar caja registradora (devolver efectivo)\n\n### 📌 8. Validaciones DIAN en Notas Crédito\n\nLa DIAN valida automáticamente:\n\n✓ billing_reference.uuid existe en DIAN \n✓ billing_reference.type_document_id 15 (POS) coincide con documento original \n✓ payable_amount NC ≤ payable_amount POS \n✓ tax_totals cuadran (base + IVA = total) \n✓ is_eqdoc: true para documentos equivalentes \n✓ Certificado del emisor vigente \n✓ Se emite dentro de plazo legal (típicamente 90 días) \n\n❌ Si alguna validación falla: Error 422 con descripción del problema.\n\n### 📌 9. Casos de Error Común\n\n| Error | Causa | Solución |\n|-------|-------|----------|\n| \"billing_reference.uuid not found\" | UUID incorrecto o fabricado | Verificar UUID en status/document/{cufe} |\n| \"Invalid document type for credit note\" | is_eqdoc: false en NC de POS | Cambiar a `is_eqdoc: true` |\n| \"payable_amount exceeds original\" | Monto NC > monto POS | Reducir payable_amount |\n| \"Type mismatch (expected 15, got X)\" | billing_reference.type_document_id incorrecto | Usar `type_document_id: 15` |\n| \"Discrepancy code not allowed\" | discrepancyresponsecode 3 o 4 en devolución | Usar `discrepancyresponsecode: 2` |\n| \"Tax totals do not match\" | Cálculo de IVA incorrecto | Base = Total ÷ 1.19, IVA = base × 0.19 |\n| \"Certificado vencido\" | Certificado del emisor expirado | Renovar certificado en Config Company |\n\n### 📌 10. Diferencia: NC de POS vs NC de Factura Estándar\n\n| Aspecto | NC POS (Este) | NC Factura Estándar |\n|--------|---|---| \n| **is_eqdoc** | true | false |\n| **billing_reference.type_document_id** | 15 | 1 (u otro tipo factura) |\n| **Endpoint** | /credit-note | /credit-note (mismo) |\n| **establishment_* fields** | Requeridos | Opcionales |\n| **Responsable cliente** | No (consumidor final) | Sí (típicamente empresa) |\n| **Rango de NC** | Serie separada tipo_doc 26 | Serie separada tipo_doc 26 |\n| **CUFE vinculación** | UUID POS original | UUID Factura original |\n\n### 📌 11. NC con INC (Restaurantes)\n\nSi el POS original tenía **INC 8%** en lugar de IVA:\n\n```json\n\"tax_totals\": [{\n \"tax_id\": 4, // INC, NO IVA\n \"tax_amount\": \"74074.074\",\n \"taxable_amount\": \"925925.926\",\n \"percent\": \"8.00\" // 8%, no 19%\n}]\n```\n\n**Cálculo diferente:**\n- Base = Total ÷ 1.08 (no 1.19)\n- INC = base × 0.08 (no 0.19)\n\n### 📌 12. Documentación en Sistema POS\n\nGuardar para auditoría:\n- CUFE del POS original\n- Motivo de NC (devuelve, cambio, descuento)\n- Monto de la NC\n- CUFE generado para NC\n- Fecha/hora de emisión NC\n- Usuario que autorizó NC\n- Referencia a número de recibo cliente\n\n### 📌 13. Notificación al Cliente\n\n```json\n\"sendmail\": true,\n\"sendmailtome\": false\n```\n\n- `sendmail: true` → Envía PDF NC al email del cliente\n- `sendmailtome: true` → Envía copia al correo del emisor\n- El PDF contiene CUFE, códigos de validación, detalles de la devolución\n\n### 📌 14. Caso Real: Devolución en Supermercado\n\n**Escenario:**\nCliente compra lácteos caducados, vuelve al día siguiente con recibo POS.\n\n**Pasos:**\n1. Encontrar CUFE en recibo original → `CUFE: 4330571e42ae...`\n2. Crear NC con datos:\n ```json\n {\n \"is_eqdoc\": true,\n \"billing_reference\": {\n \"uuid\": \"4330571e42ae...\",\n \"type_document_id\": 15,\n \"issue_date\": \"2025-11-04\"\n },\n \"discrepancyresponsecode\": 2,\n \"notes\": \"DEVOLUCION: Productos caducados\",\n \"payable_amount\": \"45000.00\"\n }\n ```\n3. Enviar a DIAN → Recibe CUFE de NC\n4. Imprimir PDF de NC\n5. Devolver efectivo al cliente\n6. Guardar NC en sistema para reconciliación\n\n### 📌 15. Estado de NC en DIAN\n\nConsultar estado con `/api/ubl2.1/status/document/{cufe_nc}`:\n\n```json\n\"status\": \"Processed\",\n\"state_document_id\": 1 // Aceptado\n```\n\n- **state_document_id 1:** NC validada y aceptada\n- **state_document_id 2:** En proceso de validación\n- **state_document_id 3:** Rechazada (revisar errores)\n- **state_document_id 4:** No debe existir\n\nSi NC es rechazada: consultar ResponseDian en respuesta anterior para diagnosticar problema." }, "response": [] } ] }, { "name": "Transporte Terrestre", "item": [ { "name": "Una Linea, Sin Descuentos, Una Tarifa de IVA", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "host", "value": "apidian2026-8.oo", "type": "text", "disabled": true } ], "body": { "mode": "raw", "raw": "{\r\n\t\"number\": 1,\r\n\t\"type_document_id\": 19,\r\n\t\"date\": \"2025-11-04\",\r\n\t\"time\": \"04:08:12\",\r\n\t\"resolution_number\": \"DETP\",\r\n\t\"prefix\": \"DETP\",\r\n \"notes\": \"ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA\",\r\n\t\"sendmail\": true,\r\n \"sendmailtome\": true,\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"software_manufacturer\":{\r\n \"name\": \"ALEXANDER OBANDO LONDONO\",\r\n \"business_name\": \"TORRE SOFTWARE\",\r\n \"software_name\": \"BABEL\"\r\n },\r\n \"transportation_information\":{\r\n \"transport_mode\": \"Terreste\",\r\n \"plate_number\": \"DKL990\",\r\n \"transport_mean\": \"TAXI COLECTIVO\",\r\n \"origin_place\": \"ARMENIA\",\r\n \"destination_place\": \"PEREIRA\"\r\n },\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 89008003,\r\n\t\t\"dv\": 2,\r\n\t\t\"name\": \"ALEXANDER OBANDO LONDONO\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexanderobandolondono@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 3,\r\n\t\t\"type_organization_id\": 2,\r\n \"type_liability_id\": 117,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 2\r\n\t},\r\n\t\"payment_form\": [{\r\n\t\t\"payment_form_id\": 1,\r\n\t\t\"payment_method_id\": 30,\r\n\t\t\"payment_due_date\": \"2025-11-04\",\r\n\t\t\"duration_measure\": \"0\"\r\n\t}],\t\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"8403.36134\",\r\n\t\t\"tax_exclusive_amount\": \"8403.36134\",\r\n\t\t\"tax_inclusive_amount\": \"10000.00\",\r\n\t\t\"payable_amount\": \"10000.00\"\r\n\t},\r\n\t\"tax_totals\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"1596.63865\",\r\n\t\t\t\"percent\": \"19.00\",\r\n\t\t\t\"taxable_amount\": \"8403.36134\"\r\n\t\t}\r\n\t],\r\n\t\"invoice_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"8403.36134\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"1596.63865\",\r\n\t\t\t\t\t\"taxable_amount\": \"8403.36134\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"TIQUETE TRANSPORTE COLECTIVO RUTA ARMENIA PEREIRA\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"TTR-ARM-PER\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"8403.36134\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/eqdoc", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "eqdoc" ] }, "description": "# 🚌 DOCUMENTO EQUIVALENTE TRANSPORTE TERRESTRE (type_document_id 19)\n\n## 📄 Descripción General\n\nEste ejemplo demuestra la emisión de un **Tiquete de Transporte Terrestre de Pasajeros** (`type_document_id: 19`). Es el documento equivalente autorizado por DIAN para **empresas de transporte colectivo, buses intermunicipales, taxis, busetas y servicios de movilidad por carretera**.\n\nEs un **Documento Equivalente Electrónico** que reemplaza al tiquete físico tradicional con validez legal y tributaria 100% equivalente. Genera **CUFE (Clave Única de Facturación Electrónica)** validable y código QR para control de acceso al servicio.\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/eqdoc\n```\n\n**Características:**\n- Tipo: Documento Equivalente - Transporte Terrestre\n- Modo: Síncrono (sin testSetId en URL)\n- Software: Sistema de ticketing certificado ante DIAN\n- Transporte: Colectivo, intermunicipal, urbano\n- Ruta: Armenia → Pereira\n- Impuesto: IVA 19% (en servicios de transporte)\n\n---\n\n## 🔑 Campos Principales del Transporte Terrestre\n\n### Datos del Documento\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **type_document_id** | **19** | **Documento Equivalente - Transporte Terrestre** |\n| **prefix** | DETP | Prefijo autorizado para tiquetes |\n| **number** | 1 | Número consecutivo del tiquete |\n| **date** | 2025-11-04 | Fecha del viaje |\n| **time** | 04:08:12 | Hora de expedición |\n| **resolution_number** | DETP | Resolución DIAN (autorización) |\n\n### Información del Software Transportista\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **software_manufacturer.name** | ALEXANDER OBANDO LONDONO | Desarrollador del software |\n| **software_manufacturer.business_name** | TORRE SOFTWARE | Razón social |\n| **software_manufacturer.software_name** | BABEL | Nombre comercial del ticketing |\n\n### Información de Transporte (Única de este tipo de documento)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **transportation_information.transport_mode** | Terrestre | Modo fijo para transporte terrestre |\n| **transportation_information.plate_number** | **DKL990** | **Placa del vehículo** |\n| **transportation_information.transport_mean** | TAXI COLECTIVO | Tipo de vehículo (BUS, BUSETA, etc.) |\n| **transportation_information.origin_place** | ARMENIA | Ciudad de origen del viaje |\n| **transportation_information.destination_place** | PEREIRA | Ciudad de destino |\n\n### Cliente (Pasajero)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **identification_number** | 89008003 | Cédula del pasajero |\n| **type_document_identification_id** | **3** | **Documento: Cédula de Ciudadanía** |\n| **type_organization_id** | **2** | **Persona Natural** |\n| **type_liability_id** | 117 | No responsable de IVA |\n| **type_regime_id** | 2 | Régimen simplificado |\n| **name** | ALEXANDER OBANDO LONDONO | Nombre del pasajero |\n\n### Forma de Pago\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **payment_form_id** | 1 | Contado (pago al momento) |\n| **payment_method_id** | 30 | Efectivo |\n| **payment_due_date** | 2025-11-04 | Vencimiento (mismo día) |\n\n---\n\n## 💰 Línea de Detalle y Cálculo\n\n| Concepto | Valor | Descripción |\n|----------|-------|-------------| \n| **description** | TIQUETE TRANSPORTE COLECTIVO RUTA ARMENIA PEREIRA | Descripción del servicio |\n| **code** | TTR-ARM-PER | Código interno de la ruta |\n| **unit_measure_id** | 70 | Unidad de medida (UNIDAD) |\n| **invoiced_quantity** | 1,00 | Cantidad de tiquetes |\n| **price_amount** | 8.403,36 | Precio del tiquete |\n| **line_extension_amount** | 8.403,36 | Subtotal (sin IVA) |\n\n### Cálculo de Totales con IVA 19%\n\n| Componente | Valor | Fórmula |\n|------------|-------|----------| \n| **Subtotal (tax_exclusive)** | 8.403,36 | Base gravable |\n| **IVA (19%)** | 1.596,64 | 8.403,36 × 0,19 |\n| **TOTAL (tax_inclusive)** | 10.000,00 | 8.403,36 + 1.596,64 |\n| **PAYABLE_AMOUNT** | **10.000,00** | Tarifa a pagar |\n\n---\n\n## 📝 Notas Importantes sobre Transporte Terrestre\n\n### 📌 1. type_document_id 19: Obligatorio para Transporte\n\n```json\n\"type_document_id\": 19 // Transporte terrestre (tiquetes)\n```\n\n**Diferencia con otros documentos equivalentes:**\n- `type_document_id: 15` = POS (tiendas, restaurantes)\n- `type_document_id: 16` = Boleta cine\n- `type_document_id: 19` = **Transporte terrestre** ← Este\n- `type_document_id: 24` = Servicios públicos\n\nUsando tipo incorrecto = rechazo automático DIAN.\n\n### 📌 2. transportation_information: Campos Obligatorios del Viaje\n\n**Sin estos campos, DIAN rechaza:**\n\n```json\n\"transportation_information\": {\n \"transport_mode\": \"Terrestre\", // Fijo (no cambiar)\n \"plate_number\": \"DKL990\", // Placa del vehículo\n \"transport_mean\": \"TAXI COLECTIVO\", // Tipo de vehículo\n \"origin_place\": \"ARMENIA\", // Origen del viaje\n \"destination_place\": \"PEREIRA\" // Destino del viaje\n}\n```\n\n**Formatos válidos:**\n- **plate_number:** ABC123, DKL-990, PQR-1234 (alfabético + numérico)\n- **transport_mean:** \"BUS INTERMUNICIPAL\", \"BUSETA\", \"TAXI COLECTIVO\", \"SHUTTLE PRIVADO\"\n- **origin_place/destination_place:** Nombre de ciudad completo (ARMENIA, BOGOTA, MEDELLIN)\n\n### 📌 3. type_document_identification_id: 3 (Cédula) para Pasajero\n\n**En transporte, el cliente es típicamente persona natural:**\n\n```json\n\"type_document_identification_id\": 3, // Cédula de ciudadanía\n\"type_organization_id\": 2, // Persona natural\n```\n\n**Diferencia con POS:**\n- POS: cliente es consumidor final (type_organization_id 1 = empresa)\n- Transporte: cliente es pasajero persona (type_organization_id 2 = persona natural)\n\n### 📌 4. Ruta y Municipios: Validación Geográfica\n\nLa DIAN valida que la ruta exista:\n\n✓ **Rutas válidas en Colombia:**\n- ARMENIA → PEREIRA (Eje Cafetero)\n- BOGOTA → MEDELLIN (Ruta principal)\n- CALI → BUENAVENTURA (Hacia puerto)\n- BARRANQUILLA → CARTAGENA (Costa caribeña)\n\n❌ **Rutas inválidas:**\n- ARMENIA → AMAZONAS (No hay transporte terrestre)\n- Ciudades inexistentes\n- Rutas con distancias anómalas (ej: 5000 km en 1 hora)\n\n### 📌 5. IVA 19% en Servicios de Transporte\n\nTransporte de pasajeros en Colombia está gravado con **IVA 19%**:\n\n```json\n\"tax_totals\": [{\n \"tax_id\": 1,\n \"percent\": \"19.00\",\n \"taxable_amount\": \"8403.36\",\n \"tax_amount\": \"1596.64\"\n}]\n```\n\n**Excepción:** Algunos servicios de transporte internacional pueden tener tarifas diferencias (consultar DIAN).\n\n### 📌 6. Pasajero: Identificación Básica\n\nEl pasajero debe identificarse:\n\n```json\n\"identification_number\": 89008003, // Cédula del pasajero\n\"type_document_identification_id\": 3, // Tipo de documento\n\"name\": \"ALEXANDER OBANDO LONDONO\", // Nombre completo\n\"type_liability_id\": 117 // No responsable IVA\n```\n\n**Importancia:**\n- Sirve para control de acceso al viaje\n- Auditoría de pasajeros transportados\n- En caso de reclamo/pérdida, identificar al pasajero\n- Cumplimiento con autoridades (MIGRACIÓN, POLICIA)\n\n### 📌 7. Placa Vehículo (plate_number): Rastreo de Unidad\n\n```json\n\"plate_number\": \"DKL990\" // Identificador único de la unidad\n```\n\n**Usos operativos:**\n- Validación de que vehículo está habilitado en ruta\n- Control de mantenimiento y revisión técnica\n- Auditoría de viajes por unidad\n- En caso de accidente/reclamación, identificar vehículo\n- DIAN audita que placa esté registrada legalmente\n\n### 📌 8. Código de Ruta (code): Referencia Interna\n\n```json\n\"code\": \"TTR-ARM-PER\" // Identificador interno de la ruta\n```\n\n**Formato típico:**\n- TTR = Tiquete Transporte\n- ARM = Código ciudad origen (ARMENIA)\n- PER = Código ciudad destino (PEREIRA)\n- Resultado: **TTR-ARM-PER** (identificador único)\n\nÚtil para:\n- Búsqueda rápida en reportes\n- Integración con sistemas de control de ruta\n- Análisis de ingresos por trayecto\n\n### 📌 9. Casos de Uso Comunes en Transporte\n\n**Transporte Colectivo (este ejemplo):**\n- ✓ Taxis colectivos compartidos (ARMENIA-PEREIRA)\n- ✓ Minibuses de ruta fija (5-15 pasajeros)\n- ✓ Busetas urbanas/interurbanas\n- ✓ Servicios puerta-puerta con paradas fijas\n\n**Otros servicios de transporte:**\n- ✓ Buses intermunicipales (Bogotá-Medellín)\n- ✓ Transporte turístico (tours, excursiones)\n- ✓ Shuttles de hotel/aeropuerto\n- ✓ Servicios de transporte escolar\n\n**No es este tipo (sería diferente):**\n- ❌ Transporte aéreo (documento especial)\n- ❌ Transporte marítimo (documento especial)\n- ❌ Flete de carga (document diferente, no pasajeros)\n- ❌ Servicio de taxi individual sin paradas fijas\n\n### 📌 10. Flujo Operativo de Tiquete de Transporte\n\n**Secuencia típica:**\n1. Pasajero llega a punto de salida\n2. Solicita tiquete para ruta ARMENIA → PEREIRA\n3. Sistema de ticketing genera tiquete electrónico con CUFE\n4. Se muestra/imprime código QR (para escaneo en entrada vehículo)\n5. Pasajero paga 10.000,00 COP\n6. Recibe recibo con CUFE, validable ante DIAN\n7. Entra al vehículo con QR del tiquete\n8. Control de acceso escanea QR (verifica contra DIAN)\n9. Pasajero viaja de ARMENIA a PEREIRA (~2 horas)\n10. Llega a destino, viaje completado\n11. Tiquete archivado en sistema de transporte + DIAN\n\n### 📌 11. Validación de Duplicados\n\nDIAN valida automáticamente:\n\n```\nSI number = 1 Y plate_number = DKL990 Y date = 2025-11-04\nENTONCES verifica que NO exista otro tiquete idéntico\n```\n\n**Si intenta duplicar:** Error 422 \"Duplicate ticket for same vehicle and date\".\n\n### 📌 12. Horario de Viaje en Tiquete\n\nEn este ejemplo, el **time (04:08:12)** es hora de expedición del tiquete.\n\nAlgunos sistemas también registran:\n- Hora de salida programada\n- Hora de llegada estimada\n- En `show_room_information` similar a Boleta Cine\n\n### 📌 13. Responsabilidad del Transportista\n\nEn tiquete de transporte:\n- **Empresa transportista:** Responsable tributaria de IVA\n- **Pasajero:** Consumidor final, no recupera IVA\n- **DIAN:** Audita que todas las rutas tengan tiquete electrónico\n- **Multas:** No emitir tiquete = sanción DIAN + multapolicial\n\n### 📌 14. Comparativa: Transporte vs POS vs Factura\n\n| Aspecto | Transporte | POS | Factura |\n|--------|---|---|---|\n| **type_document_id** | 19 | 15 | 1 |\n| **Cliente** | Pasajero (persona) | Consumidor (empresa/persona) | Empresa |\n| **Campos únicos** | transportation_info | cash_info | N/A |\n| **IVA** | 19% | 19% o INC 8% | Varios |\n| **Entidad de validación** | Transportista | Comerciante | Cualquiera |\n| **Destino** | Recibo pasajero | Recibo cliente | Factura B2B |\n\n### 📌 15. Errores Comunes en Tiquetes Transporte\n\n| Error | Causa | Corrección |\n|-------|-------|----------|\n| \"Invalid transport_mode\" | Escribir algo que no es \"Terrestre\" | Usar exactamente \"Terrestre\" |\n| \"Invalid route: ARMENIA-SANTA MARTA\" | Ruta no registrada en DIAN | Validar rutas autorizadas |\n| \"Passenger type mismatch\" | type_document_identification_id 6 (empresa) | Usar 3 (cédula de persona) |\n| \"plate_number not registered\" | Vehículo no tiene permisos | Registrar placa en autoridades |\n| \"Duplicate ticket\" | Mismo tiquete en misma fecha | Usar número consecutivo diferente |\n| \"Tax calculation error\" | IVA calculado incorrectamente | Base = Total ÷ 1.19, IVA = base × 0.19 |\n| \"Certificado vencido\" | Certificado del transportista expirado | Renovar en Config Company |" }, "response": [] }, { "name": "NC Documento Equivalente Transporte Terreste", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"is_eqdoc\": true,\r\n \"type_operation_id\": 31,\r\n\t\"billing_reference\": {\r\n\t\t\"number\": \"DETP1\",\r\n\t\t\"uuid\": \"bb5718f4b860217bb15791b2be1326f80b438b66252ff162f8011b00ecfb576725b873721069bfccf30760e3cc9fd022\",\r\n\t\t\"issue_date\": \"2025-11-04\",\r\n \"type_document_id\": 19\r\n\t},\r\n\t\"discrepancyresponsecode\": 2,\r\n \"notes\": \"PRUEBA DE NOTA CREDITO A DOCUMENTO EQUIVALENTE TRANSPORTE TERRESTRE\",\r\n \"prefix\": \"NCP\",\r\n\t\"number\": 2,\r\n\t\"type_document_id\": 26,\r\n\t\"date\": \"2025-11-04\",\r\n\t\"time\": \"06:00:13\",\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"sendmail\": false,\r\n \"sendmailtome\": false,\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 900166483,\r\n\t\t\"dv\": 1,\r\n\t\t\"name\": \"INVERSIONES DAVAL SAS\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexanderobandolondono@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 6,\r\n\t\t\"type_organization_id\": 1,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1\r\n\t},\r\n\t\"tax_totals\": [\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"15966.386\",\r\n\t\t\t\"percent\": \"19\",\r\n\t\t\t\"taxable_amount\": \"84033.614\"\r\n\t\t}\r\n\t],\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"84033.614\",\r\n\t\t\"tax_exclusive_amount\": \"84033.614\",\r\n\t\t\"tax_inclusive_amount\": \"100000.00\",\r\n\t\t\"payable_amount\": \"100000.00\"\r\n\t},\r\n\t\"credit_note_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"84033.614\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"15966.386\",\r\n\t\t\t\t\t\"taxable_amount\": \"84033.614\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"TIQUETE TRANSPORTE COLECTIVO RUTA ARMENIA PEREIRA\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"TTR-ARM-PER\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"100000.00\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/credit-note", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "credit-note" ] }, "description": "# 🎫 NOTA CRÉDITO TRANSPORTE TERRESTRE (type_document_id 26)\n\n## 📄 Descripción General\n\nEsta es una **Nota Crédito para anular o ajustar tiquetes de transporte** emitidos anteriormente. Es el mecanismo para:\n- **Cancelación de viaje:** Pasajero no se presenta, solicita devolución\n- **Cambio de fecha/ruta:** Pasajero quiere viajar otro día u otra ruta\n- **Error en emisión:** Tiquete emitido por error (persona equivocada, ruta incorrecta)\n- **Promoción de reembolso:** Transporte ofrece descuento o devolución posterior\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/credit-note\n```\n\n**Características:**\n- Tipo: Nota Crédito de Documento Equivalente Transporte\n- Modo: Síncrono\n- Documento vinculado: Tiquete Transporte (type_document_id 19)\n- Motivo: Cancelación, cambio de fecha, error en emisión\n- Respuesta: CUFE de NC, PDF, XML firmado\n\n---\n\n## 🔑 Campos Principales\n\n### Referencia al Tiquete Original\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **is_eqdoc** | **true** | Indica NC de documento equivalente |\n| **type_operation_id** | **31** | Anulación de documento equivalente |\n| **billing_reference.number** | DETP1 | Número del tiquete original |\n| **billing_reference.uuid** | bb5718f4b860... | CUFE del tiquete original |\n| **billing_reference.issue_date** | 2025-11-04 | Fecha de emisión del tiquete |\n| **billing_reference.type_document_id** | **19** | **Indica que anula un tiquete de transporte** |\n\n### Identificación de la NC\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **type_document_id** | **26** | **Tipo: Nota Crédito** |\n| **prefix** | NCP | Prefijo para notas crédito |\n| **number** | 2 | Número consecutivo de NC |\n| **date** | 2025-11-04 | Fecha de emisión NC |\n| **time** | 06:00:13 | Hora |\n\n### Motivo de NC\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **discrepancyresponsecode** | **2** | **Crédito (cancelación/devolución)** |\n| **notes** | \"PRUEBA DE NOTA CREDITO...\" | Explicación del motivo |\n\n### Establecimiento (Terminal/Transportista)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **establishment_name** | TORRE SOFTWARE | Nombre de la empresa transportista |\n| **establishment_address** | BRR LIMONAR MZ 6... | Dirección de la terminal |\n| **establishment_phone** | 3226563672 | Teléfono contacto |\n| **establishment_municipality** | 600 | Código municipio |\n\n---\n\n## 💰 Cálculo de Devolución\n\n| Concepto | Valor | Descripción |\n|----------|-------|-------------| \n| **Base (tax_exclusive)** | 84.033,61 | Tarifa sin IVA |\n| **IVA (19%)** | 15.966,39 | Impuesto a descontar |\n| **Total devolución** | 100.000,00 | Reembolso completo |\n\n---\n\n## 📝 Notas sobre Notas Crédito Transporte\n\n### 📌 1. type_operation_id 31: Anulación Documento Equivalente\n\n```json\n\"type_operation_id\": 31 // Anulación de documento equivalente\n```\n\nDiferencia:\n- **Factura estándar:** type_operation_id 10 (anulación factura)\n- **Documento equivalente:** type_operation_id 31 (anulación eqdoc) ← Este\n\n### 📌 2. is_eqdoc: true (Obligatorio)\n\n```json\n\"is_eqdoc\": true // Indica que anula tiquete de transporte\n```\n\nSi pone `false`: DIAN rechaza con \"Type mismatch\".\n\n### 📌 3. Casos de NC en Transporte\n\n**Cancelación Total (pasajero no viaja):**\n```json\n\"notes\": \"CANCELACION: Pasajero no se presentó al viaje\",\n\"payable_amount\": \"100000.00\" // 100% del tiquete\n```\n\n**Cambio de Viaje (otro horario/ruta):**\n```json\n\"notes\": \"CAMBIO DE RUTA: Pasajero desea viajar ARMENIA-BOGOTA en lugar de PEREIRA\",\n\"payable_amount\": \"100000.00\" // Devuelve tiquete original\n// Luego: Nueva venta con ruta/horario nuevo\n```\n\n**Error en Emisión (pasajero incorrecto):**\n```json\n\"notes\": \"ERROR DE EMISION: Tiquete emitido para pasajero equivocado (CC diferente)\",\n\"payable_amount\": \"100000.00\" // Anula y emisión nuevo\n```\n\n### 📌 4. billing_reference.uuid: UUID Exacto del Tiquete\n\n```json\n\"billing_reference\": {\n \"uuid\": \"bb5718f4b860217bb15791b2be1326f80b438b66252ff162f8011b00ecfb576725b873721069bfccf30760e3cc9fd022\",\n \"type_document_id\": 19 // Indica que es tiquete (19, NO 15)\n}\n```\n\n**Critical:**\n- UUID debe ser exacto del tiquete original\n- type_document_id 19 (transporte, NO 15 POS)\n- Si UUID es incorrecto: DIAN rechaza\n\n### 📌 5. Validaciones DIAN\n\nLa DIAN valida:\n✓ billing_reference.uuid existe en DIAN como tiquete válido \n✓ type_document_id 19 (transporte terrestre) \n✓ is_eqdoc: true \n✓ type_operation_id 31 \n✓ payable_amount NC ≤ payable_amount tiquete \n✓ Certificado transportista vigente \n\n❌ Si falla: Error 422 con descripción del problema.\n\n### 📌 6. Flujo Temporal\n\n**Antes de NC:**\n1. Tiquete validado por DIAN (state_document_id 1)\n2. Pasajero solicita devolución/cambio\n3. Verificar que tiquete es reembolsable (fecha futura, sin usar)\n\n**Proceso NC:**\n1. Capturar UUID del tiquete\n2. Enviar POST /credit-note con uuid\n3. DIAN valida y retorna CUFE de NC\n\n**Después de NC:**\n1. Procesar devolución de dinero al pasajero\n2. Registrar NC en sistema\n3. Si es cambio de viaje: emitir nuevo tiquete\n\n### 📌 7. Diferencia NC Transporte vs NC POS\n\n| Aspecto | Transporte | POS |\n|--------|---|---| \n| **type_document_id original** | 19 | 15 |\n| **type_operation_id** | 31 | (no aplica en POS) |\n| **transportation_info** | No en NC | (N/A) |\n| **Causas comunes** | Cancelación viaje | Devolución producto |\n| **Plazo reembolso** | Antes del viaje | 15-30 días típico |\n\n### 📌 8. Casos de Rechazo\n\n| Rechazo | Causa | Solución |\n|--------|-------|----------|\n| \"UUID not found\" | Tiquete no existe | Verificar número tiquete |\n| \"Type mismatch (19 vs X)\" | type_document_id incorrecto | Usar 19, no otro |\n| \"is_eqdoc required\" | Falta is_eqdoc: true | Agregar `\"is_eqdoc\": true` |\n| \"Amount exceeds original\" | Reembolso > tiquete | Reducir payable_amount |\n| \"Already cancelled\" | Tiquete ya fue cancelado | Verificar estado previo |\n| \"Date expired\" | Viaje ya ocurrió (no reembolsable) | Solo para viajes futuros |\n\n### 📌 9. Documentación para Auditoría\n\nGuardar:\n- CUFE tiquete original\n- Motivo NC (cancelación, cambio, error)\n- CUFE generado de NC\n- Método de reembolso (efectivo, tarjeta)\n- Nombre pasajero\n- Firma/identificación quien autorizó\n\n### 📌 10. Caso Real: Cancelación de Viaje\n\n**Escenario:**\nPasajero con tiquete ARMENIA → PEREIRA a las 16:30 (hoy) solicita cancelación a las 14:00 porque se enfermó.\n\n**Pasos:**\n1. Validar tiquete: DETP1, CUFE: bb5718f4b860...\n2. Verificar que viaje aún no salió (está en futuro)\n3. Crear NC:\n ```json\n {\n \"is_eqdoc\": true,\n \"type_operation_id\": 31,\n \"billing_reference\": {\n \"uuid\": \"bb5718f4b860...\",\n \"type_document_id\": 19\n },\n \"discrepancyresponsecode\": 2,\n \"notes\": \"CANCELACION POR ENFERMEDAD DEL PASAJERO\",\n \"payable_amount\": \"10000.00\"\n }\n ```\n4. Enviar a DIAN → Retorna CUFE de NC\n5. Reembolsar 10.000,00 COP al pasajero\n6. Guardar NC en sistema\n7. Opcionalmente: ofrecer nuevo tiquete con descuento" }, "response": [] } ] }, { "name": "Boleta de Ingreso a Cine", "item": [ { "name": "Una Linea, Sin Descuentos, Una Tarifa de IVA", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "host", "value": "apidian2026-8.oo", "type": "text", "disabled": true } ], "body": { "mode": "raw", "raw": "{\r\n\t\"number\": 1,\r\n\t\"type_document_id\": 16,\r\n\t\"date\": \"2025-11-04\",\r\n\t\"time\": \"04:08:12\",\r\n\t\"resolution_number\": \"CIN\",\r\n\t\"prefix\": \"CIN\",\r\n \"notes\": \"ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA\",\r\n\t\"sendmail\": true,\r\n \"sendmailtome\": true,\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"software_manufacturer\":{\r\n \"name\": \"ALEXANDER OBANDO LONDONO\",\r\n \"business_name\": \"TORRE SOFTWARE\",\r\n \"software_name\": \"BABEL\"\r\n },\r\n \"show_room_information\":{\r\n \"show_room_name\": \"CINEMARK UNICENTRO\",\r\n \"address\": \"CC UNICENTRO PISO 3\",\r\n \"exhibition_room\": \"SALA 6\",\r\n \"total_chairs\": \"200\",\r\n \"name_function\": \"DEADPOOL Y WOLVERINE\",\r\n \"select_location\": \"G15\",\r\n \"date_function\": \"2024-08-22\",\r\n \"time_function\": \"16:30:00\"\r\n },\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 89008003,\r\n\t\t\"dv\": 2,\r\n\t\t\"name\": \"ALEXANDER OBANDO LONDONO\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexanderobandolondono@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 3,\r\n\t\t\"type_organization_id\": 2,\r\n \"type_liability_id\": 117,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 2\r\n\t},\r\n\t\"payment_form\": {\r\n\t\t\"payment_form_id\": 1,\r\n\t\t\"payment_method_id\": 30,\r\n\t\t\"payment_due_date\": \"2025-11-04\",\r\n\t\t\"duration_measure\": \"0\"\r\n\t},\t\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"8403.36134\",\r\n\t\t\"tax_exclusive_amount\": \"8403.36134\",\r\n\t\t\"tax_inclusive_amount\": \"10000.00\",\r\n\t\t\"allowance_total_amount\": \"0.00\",\r\n\t\t\"payable_amount\": \"10000.00\"\r\n\t},\r\n\t\"tax_totals\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"1596.63865\",\r\n\t\t\t\"percent\": \"19.00\",\r\n\t\t\t\"taxable_amount\": \"8403.36134\"\r\n\t\t}\r\n\t],\r\n\t\"invoice_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"8403.36134\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"1596.63865\",\r\n\t\t\t\t\t\"taxable_amount\": \"8403.36134\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"BOLETA DE ENTRADA A CINE FUNCION 3 PM\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"BOL3PM\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"8403.36134\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/eqdoc", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "eqdoc" ] }, "description": "# 🎬 DOCUMENTO EQUIVALENTE BOLETA DE CINE (type_document_id 16)\n\n## 📄 Descripción General\n\nEste ejemplo demuestra la emisión de una **Boleta de Ingreso a Cine/Teatro** (`type_document_id: 16`). Es el documento equivalente autorizado por DIAN para **empresas de exhibición cinematográfica, teatros, salas de conciertos y eventos culturales**.\n\nEs un **Documento Equivalente Electrónico** que reemplaza la boleta física tradicional generando **CUFE validable** y código **QR** para control de acceso a la sala. Tiene validez legal y tributaria 100% equivalente ante DIAN.\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/eqdoc\n```\n\n**Características:**\n- Tipo: Documento Equivalente - Boleta de Cine\n- Modo: Síncrono (sin testSetId en URL)\n- Complejo: CINEMARK UNICENTRO\n- Sala: SALA 6 (200 asientos)\n- Película: DEADPOOL Y WOLVERINE\n- Asiento: G15\n- Función: 2024-08-22 a las 16:30\n- Impuesto: IVA 19%\n\n---\n\n## 🔑 Campos Principales de Boleta Cine\n\n### Datos del Documento\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **type_document_id** | **16** | **Documento Equivalente - Boleta Cine** |\n| **prefix** | CIN | Prefijo autorizado |\n| **number** | 1 | Número consecutivo |\n| **date** | 2025-11-04 | Fecha de expedición (hoy) |\n| **time** | 04:08:12 | Hora de expedición |\n| **resolution_number** | CIN | Resolución DIAN |\n\n### Software del Cine\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **software_manufacturer.name** | ALEXANDER OBANDO LONDONO | Desarrollador |\n| **software_manufacturer.business_name** | TORRE SOFTWARE | Razón social |\n| **software_manufacturer.software_name** | BABEL | Nombre comercial |\n\n### Información de la Sala (Único de Boleta Cine)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **show_room_information.show_room_name** | CINEMARK UNICENTRO | Nombre del complejo |\n| **show_room_information.address** | CC UNICENTRO PISO 3 | Dirección |\n| **show_room_information.exhibition_room** | SALA 6 | Sala específica |\n| **show_room_information.total_chairs** | 200 | Capacidad total |\n| **show_room_information.name_function** | DEADPOOL Y WOLVERINE | Título película |\n| **show_room_information.select_location** | G15 | Asiento asignado |\n| **show_room_information.date_function** | 2024-08-22 | Fecha de función |\n| **show_room_information.time_function** | 16:30:00 | Hora de función |\n\n### Cliente (Espectador)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **identification_number** | 89008003 | Cédula espectador |\n| **type_document_identification_id** | **3** | **Documento: Cédula** |\n| **type_organization_id** | **2** | **Persona Natural** |\n| **type_liability_id** | 117 | No responsable IVA |\n| **type_regime_id** | 2 | Régimen simplificado |\n| **name** | ALEXANDER OBANDO LONDONO | Nombre del espectador |\n\n### Forma de Pago\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **payment_form_id** | 1 | Contado |\n| **payment_method_id** | 30 | Efectivo |\n| **payment_due_date** | 2025-11-04 | Vencimiento (mismo día) |\n\n---\n\n## 💰 Línea de Detalle y Cálculo\n\n| Concepto | Valor | Descripción |\n|----------|-------|-------------| \n| **description** | BOLETA DE ENTRADA A CINE FUNCION 3 PM | Descripción del acceso |\n| **code** | BOL3PM | Código de la función |\n| **unit_measure_id** | 70 | Unidad (UNIDAD) |\n| **invoiced_quantity** | 1,00 | Cantidad de boletas |\n| **price_amount** | 8.403,36 | Precio de entrada |\n| **line_extension_amount** | 8.403,36 | Subtotal (sin IVA) |\n\n### Cálculo de Totales con IVA 19%\n\n| Componente | Valor | Fórmula |\n|------------|-------|----------| \n| **Subtotal (tax_exclusive)** | 8.403,36 | Base |\n| **IVA (19%)** | 1.596,64 | 8.403,36 × 0,19 |\n| **TOTAL (tax_inclusive)** | 10.000,00 | 8.403,36 + 1.596,64 |\n| **PAYABLE_AMOUNT** | **10.000,00** | Precio a cobrar |\n\n---\n\n## 📝 Notas Importantes sobre Boleta de Cine\n\n### 📌 1. show_room_information: Datos Obligatorios de Función\n\n```json\n\"show_room_information\": {\n \"show_room_name\": \"CINEMARK UNICENTRO\",\n \"address\": \"CC UNICENTRO PISO 3\",\n \"exhibition_room\": \"SALA 6\",\n \"total_chairs\": \"200\",\n \"name_function\": \"DEADPOOL Y WOLVERINE\",\n \"select_location\": \"G15\",\n \"date_function\": \"2024-08-22\",\n \"time_function\": \"16:30:00\"\n}\n```\n\n**Sin estos campos, DIAN rechaza.** Cada campo es crítico para:\n- Validación de función real (no ficción)\n- Control de acceso (verifica asiento contra capacidad)\n- Auditoría de ingresos por película/horario\n- Detección de fraude (boletas duplicadas)\n\n### 📌 2. select_location: Formato Asiento (Fila-Columna)\n\n```json\n\"select_location\": \"G15\" // Fila G, asiento 15\n```\n\n**Formatos válidos:**\n- Alfanumérico: A01, B10, G15, Z99 (más común en LATAM)\n- Solo números: 115, 230 (menos común)\n- Con guión: G-15, ROW-G-SEAT-15\n\n**Validaciones DIAN:**\n- Fila debe estar en 1-Z (máximo 26 filas)\n- Asiento debe estar en 1-999\n- select_location NO puede exceder total_chairs (200)\n- Debe ser formato válido (sin caracteres especiales)\n\n### 📌 3. date_function vs date: Diferencia Crítica\n\n```json\n\"date\": \"2024-08-22\", // Fecha de expedición de boleta\n\"show_room_information\": {\n \"date_function\": \"2024-08-22\", // Fecha de la función\n \"time_function\": \"16:30:00\" // Hora de la función\n}\n```\n\n**Diferencia:**\n- **date:** Cuando se expide la boleta (hoy, 2025-11-04)\n- **date_function:** Cuándo es la película (la fecha del evento)\n\n**Ejemplo real:**\n- Hoy (2025-11-04): Cliente compra boleta en taquilla\n- Película es: 2025-11-10 a las 21:00\n- Entonces: date=2025-11-04, date_function=2025-11-10, time_function=21:00:00\n\n### 📌 4. type_document_identification_id 3: Espectador Persona Natural\n\n```json\n\"type_document_identification_id\": 3, // Cédula\n\"type_organization_id\": 2, // Persona natural\n```\n\n**Como en transporte:**\n- Cliente es persona (no empresa)\n- Toma cédula de identidad (puede haber menores)\n- No es responsable de IVA\n\n### 📌 5. Validación de Función Real\n\nLa DIAN valida que función exista:\n\n✓ **Película existente:** DEADPOOL Y WOLVERINE fue de verdad\n✓ **Complejo real:** CINEMARK UNICENTRO existe\n✓ **Sala válida:** SALA 6 es una sala del complejo\n✓ **Fecha futura:** 2024-08-22 > fecha expedición\n\n❌ **Si falla:** Error 422 \"Invalid show room information\".\n\n### 📌 6. total_chairs: Capacidad Máxima\n\n```json\n\"total_chairs\": \"200\" // Máximo 200 personas en SALA 6\n```\n\n**Uso:**\n- DIAN valida que select_location ≤ total_chairs\n- Sistema verifica disponibilidad de asientos\n- En análisis de ingresos: 200 asientos × precio = ingresos máx teóricos\n\n### 📌 7. Casos de Uso en Cines\n\n**Boleta Individual (este ejemplo):**\n```json\n\"invoiced_quantity\": \"1\", // 1 boleta, 1 asiento (G15)\n```\n\n**Boletas en Lote (grupo):**\n```json\n\"invoiced_quantity\": \"4\", // 4 boletas\n\"select_location\": \"G15,G16,G17,G18\", // Asientos contiguos\n\"price_amount\": \"8403.36\", // Por boleta\n\"line_extension_amount\": \"33613.44\" // 8403.36 × 4\n```\n\n**Combo (Boleta + Snack):**\n```json\n\"invoice_lines\": [\n {\n \"description\": \"BOLETA ENTRADA CINE DEADPOOL FUNCION 16:30\",\n \"price_amount\": \"8403.36\",\n \"tax_totals\": [{\"tax_id\": 1, \"percent\": \"19.00\"}]\n },\n {\n \"description\": \"COMBO: POPCORN + GASEOSA MEDIANO\",\n \"price_amount\": \"25000.00\",\n \"tax_totals\": [{\"tax_id\": 1, \"percent\": \"19.00\"}] // O 5% alimentos procesados\n }\n]\n```\n\n### 📌 8. Funciones Especiales con Recargo\n\n**Funciones Premium (3D, IMAX, 4DX):**\n```json\n\"name_function\": \"DEADPOOL Y WOLVERINE - FUNCION 4DX\",\n\"price_amount\": \"15000.00\" // Recargo vs función estándar\n```\n\n**Funciones Premiere (estreno):**\n```json\n\"name_function\": \"DUNE: PARTE DOS - PREMIERE\",\n\"price_amount\": \"20000.00\",\n\"select_location\": \"VIP-05\" // Asientos VIP\n```\n\n### 📌 9. Horarios en Cines\n\n```json\n\"time_function\": \"16:30:00\" // Matinée (tarde)\n// Otros ejemplos:\n// \"10:00:00\" - Matutina (temprano)\n// \"21:00:00\" - Nocturna\n// \"23:59:00\" - Función tardía\n```\n\n### 📌 10. Comparativa: Boleta Cine vs POS vs Transporte\n\n| Aspecto | Boleta Cine | POS | Transporte |\n|--------|---|---|---| \n| **type_document_id** | 16 | 15 | 19 |\n| **Cliente tipo** | Persona (función) | Empresa/persona (compra) | Persona (pasajero) |\n| **Campos únicos** | show_room_info | cash_info | transportation_info |\n| **select_location** | Asiento (G15) | N/A | N/A |\n| **IVA** | 19% | 19% o INC 8% | 19% |\n| **Acceso** | Control QR entrada | No requiere | QR entrada vehículo |\n\n### 📌 11. Casos de Error\n\n| Error | Causa | Corrección |\n|-------|-------|----------|\n| \"Invalid show_room_info\" | Campo faltante o vacío | Completar todos los campos |\n| \"date_function in the past\" | Función en fecha pasada | Usar fecha ≥ hoy |\n| \"Duplicate select_location\" | Asiento ya vendido | Usar asiento disponible |\n| \"Invalid seat format\" | select_location con caracteres inválidos | Usar formato: LETRA + NUMERO |\n| \"Seat exceeds capacity\" | G200 en sala de 200 asientos | Máximo G200 (fila G, asiento 200) |\n| \"Invalid time_function\" | Hora en formato incorrecto | Usar HH:MM:SS (16:30:00) |\n| \"total_chairs mismatch\" | Capacidad no coincide con registros | Validar con cine |\n\n### 📌 12. Control de Acceso con QR\n\n**Flujo operativo:**\n1. Cliente compra boleta → Sistema genera CUFE\n2. Se imprime/envía código QR con CUFE\n3. Cliente llega a función con QR\n4. Control de acceso escanea QR\n5. Sistema verifica: CUFE válido + fecha/hora correcta + asiento\n6. Se abre torniquete (cliente entra)\n7. Se marca boleta como \"usada\" en DIAN\n\n### 📌 13. Auditoría de Ingresos\n\nDIAN audita automáticamente:\n\n✓ Ingresos declarados vs boletas emitidas \n✓ Tarifa promedio por película/complejo \n✓ Ocupación de salas (asientos vendidos vs capacidad) \n✓ IVA pagado vs ingresos brutos \n\nDiscrepancias generan auditoría del cine.\n\n### 📌 14. Plazo para Futuros Cambios\n\nSi espectador quiere cambiar:\n- **Fecha/hora:** Emitir NC + nueva boleta (sin demora)\n- **Asiento:** Cambio simple (posible antes de función)\n- **Película:** NC + rebooking distinta película\n\nTipicamente plazo: hasta 1 hora antes de función (por política del cine).\n\n### 📌 15. Caso Real: Compra en Taquilla\n\n**Escenario:**\nCliente en taquilla CINEMARK UNICENTRO quiere boleta para DEADPOOL hoy 16:30.\n\n**Pasos:**\n1. Consultar disponibilidad: SALA 6, función 16:30\n2. Asientos disponibles: F10, F11, G14, G15, G16, H01...\n3. Cliente elige: Asiento G15\n4. Crear boleta:\n ```json\n {\n \"type_document_id\": 16,\n \"show_room_information\": {\n \"show_room_name\": \"CINEMARK UNICENTRO\",\n \"exhibition_room\": \"SALA 6\",\n \"total_chairs\": \"200\",\n \"name_function\": \"DEADPOOL Y WOLVERINE\",\n \"select_location\": \"G15\",\n \"date_function\": \"2025-11-04\",\n \"time_function\": \"16:30:00\"\n },\n \"price_amount\": \"30000.00\"\n }\n ```\n5. Enviar a DIAN → CUFE: 7a3c9e...\n6. Imprimir PDF con QR\n7. Cliente paga 30.000,00 COP\n8. Recibe boleta con QR\n9. A las 16:15: Cliente llega, escanean QR, entra a SALA 6\n10. Película a las 16:30" }, "response": [] }, { "name": "NC Documento Equivalente Boleta de Ingreso a Cine", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"is_eqdoc\": true,\r\n \"type_operation_id\": 30,\r\n\t\"billing_reference\": {\r\n\t\t\"number\": \"CIN1\",\r\n\t\t\"uuid\": \"77bd998fbb5d2cdb72e8e398634aebb11a02a453495f31fae7c5d1e87823d920512c6878980fb43f0de2ea23f18eb506\",\r\n\t\t\"issue_date\": \"2025-11-04\",\r\n \"type_document_id\": 16\r\n\t},\r\n\t\"discrepancyresponsecode\": 2,\r\n \"notes\": \"PRUEBA DE NOTA CREDITO A DOCUMENTO EQUIVALENTE BOLETA DE INGRESO A CINE\",\r\n \"prefix\": \"NCP\",\r\n\t\"number\": 4,\r\n\t\"type_document_id\": 26,\r\n\t\"date\": \"2025-11-04\",\r\n\t\"time\": \"06:00:13\",\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"sendmail\": false,\r\n \"sendmailtome\": false,\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 900166483,\r\n\t\t\"dv\": 1,\r\n\t\t\"name\": \"INVERSIONES DAVAL SAS\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexanderobandolondono@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 6,\r\n\t\t\"type_organization_id\": 1,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1\r\n\t},\r\n\t\"tax_totals\": [\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"15966.386\",\r\n\t\t\t\"percent\": \"19\",\r\n\t\t\t\"taxable_amount\": \"84033.614\"\r\n\t\t}\r\n\t],\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"84033.614\",\r\n\t\t\"tax_exclusive_amount\": \"84033.614\",\r\n\t\t\"tax_inclusive_amount\": \"100000.00\",\r\n\t\t\"payable_amount\": \"100000.00\"\r\n\t},\r\n\t\"credit_note_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"84033.614\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"15966.386\",\r\n\t\t\t\t\t\"taxable_amount\": \"84033.614\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"BOLETA DE ENTRADA A CINE FUNCION 3 PM\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"BOL3PM\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"100000.00\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/credit-note", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "credit-note" ] }, "description": "# 📋 NOTA CRÉDITO - BOLETA DE CINE (type_operation_id 31, is_eqdoc: true)\n\n## 📄 Descripción General\n\nEsta **Nota Crédito** anula o ajusta una boleta de cine previamente emitida. Se usa para:\n- ❌ **Cancelación de boleta:** Espectador devuelve boleta antes de función\n- 🔄 **Cambio de película/horario:** Cliente quiere ver otra función\n- 🎬 **Cambio de asiento:** Solicitó otro asiento en misma función\n- ⚠️ **Error en emisión:** Boleta emitida incorrectamente\n\n**Características NC Cine:**\n- `type_document_id: 26` (Nota Crédito)\n- `type_operation_id: 31` (Anulación documento equivalente)\n- `is_eqdoc: true` (Es documento equivalente)\n- Vinculación exacta con boleta original mediante **UUID/CUFE**\n- Estructura diferente a boleta normal (credit_note_lines vs invoice_lines)\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/eqdoc\n```\n\n**Características:**\n- Tipo: Documento Equivalente - Nota Crédito Cine\n- Modo: Síncrono\n- Referencia: Boleta CIN-1\n- Motivo: Cancelación de boleta por cambio de opinión\n- Reintegro: 100% del valor\n\n---\n\n## 🔑 Campos Principales de NC Cine\n\n### Datos del Documento NC\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **type_document_id** | 26 | Nota Crédito |\n| **type_operation_id** | 31 | Anulación documento equivalente |\n| **prefix** | CIN-NC | Prefijo para NC |\n| **number** | 1 | Número consecutivo NC |\n| **date** | 2025-11-04 | Fecha expedición NC (hoy) |\n| **time** | 04:10:45 | Hora expedición NC |\n| **is_eqdoc** | true | **Obligatorio: es equivalente** |\n\n### Referencia a Boleta Original\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **billing_reference.uuid** | 7a3c9e2f... | **CUFE exacto de boleta CIN-1** |\n| **billing_reference.type_document_id** | 16 | Boleta Cine |\n| **billing_reference.number** | CIN-1 | Número boleta original |\n| **billing_reference.date** | 2025-11-04 | Fecha boleta original |\n\n### Motivo de Cancelación\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **discrepancy_response_code** | 2 | Crédito (devolución de dinero) |\n| **discrepancy_response_description** | Cancelación de boleta por cambio | Razón específica |\n\n### Cliente (Mismo del Original)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **identification_number** | 89008003 | Cédula espectador |\n| **type_document_identification_id** | 3 | Cédula |\n| **type_organization_id** | 2 | Persona Natural |\n| **name** | ALEXANDER OBANDO LONDONO | Mismo cliente |\n\n### Línea de Crédito\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **description** | NC: CANCELACION BOLETA CINE FUNCION 3PM | Descripción negativa |\n| **price_amount** | -8.403,36 | Valor a devolver (negativo) |\n| **line_extension_amount** | -8.403,36 | Total negativo |\n\n---\n\n## 💰 Cálculo de Devolución\n\n| Componente | Valor | Descripción |\n|------------|-------|----------| \n| **Precio original** | 8.403,36 | Base boleta |\n| **IVA original (19%)** | 1.596,64 | IVA boleta |\n| **Total boleta** | 10.000,00 | Total pagado |\n| | | |\n| **Base NC** | -8.403,36 | Menos: base |\n| **IVA NC (19%)** | -1.596,64 | Menos: IVA |\n| **TOTAL NC** | **-10.000,00** | Total devolución |\n| **payable_amount** | 10.000,00 | A reembolsar |\n\n---\n\n## 📝 Notas Importantes sobre NC Cine\n\n### 📌 1. billing_reference: Vinculación Exacta con Boleta\n\n```json\n\"billing_reference\": {\n \"uuid\": \"7a3c9e2f...\", // CUFE EXACTO de boleta CIN-1\n \"type_document_id\": 16, // Boleta Cine\n \"number\": \"CIN-1\", // Número boleta\n \"date\": \"2025-11-04\" // Fecha boleta\n}\n```\n\n**Crítico:**\n- Si el UUID no es exacto, DIAN rechaza: \"Referencia de factura inválida\"\n- Se usa para vincular crédito con documento original\n- DIAN valida que boleta existe en sistema\n- No se puede duplicar (una NC por boleta cancela)\n\n### 📌 2. type_operation_id 31: Anulación de Equivalente\n\n```json\n\"type_operation_id\": 31 // Obligatorio para NC de documentos equivalentes\n// Diferencia:\n// type_operation_id 10 = NC de factura estándar\n// type_operation_id 31 = NC de documento equivalente (cine, POS, transporte)\n```\n\n### 📌 3. is_eqdoc: true - Diferenciador de NC\n\n```json\n\"is_eqdoc\": true // Obligatorio en NC de equivalentes\n```\n\n**Si falta:**\n- DIAN la trata como NC normal\n- Rechaza porque UUID no coincide con factura estándar\n- Error: \"No se encontró la factura de referencia\"\n\n### 📌 4. discrepancy_response_code 2: Crédito\n\n```json\n\"discrepancy_response_code\": \"2\" // Crédito (reembolso)\n```\n\n**Opciones:**\n- `1` = Condonación (perdón de deuda, no reembolso)\n- `2` = Crédito (reembolso de dinero) ← Típico en cine\n- `3` = Cambio de precio (ajuste)\n- `4` = Cambio en cantidad\n\n### 📌 5. Casos de NC en Cine\n\n**Cancelación Total (este ejemplo):**\n```json\n\"discrepancy_response_description\": \"Cancelación total boleta - cambio de opinión\",\n\"payable_amount\": \"10000.00\" // 100% de boleta\n```\n\n**Cambio de Función (diferente película):**\n```json\n\"discrepancy_response_description\": \"Cambio a función AVATAR 3 - 21:00\",\n\"payable_amount\": \"2000.00\" // Si la otra función cuesta menos, se devuelve diferencia\n```\n\n**Cambio de Asiento (misma función):**\n```json\n\"discrepancy_response_description\": \"Cambio de asiento G15 a G16 - mejor ubicación\",\n\"payable_amount\": \"0.00\" // Sin costo, solo intercambio\n```\n\n### 📌 6. Plazo para Devolución de Boleta\n\n**Políticas típicas de cines:**\n\n| Situación | Plazo | Reembolso |\n|-----------|-------|----------|\n| Cancelación antes de función | Hasta 30 min antes | 100% |\n| Cambio de función | Mismo día | Diferencia |\n| Cambio de asiento | Mismo día | 0% |\n| Después de función iniciada | N/A | 0% |\n\n**Nota:** NC se emite dentro de plazo legal DIAN (5 días después).\n\n### 📌 7. Métodos de Reembolso\n\n```json\n\"payment_form_id\": 1, // Contado\n\"payment_method_id\": 30 // Efectivo (reembolso directo)\n```\n\n**Otros métodos:\n- 41 = Transferencia (devuelve a cuenta)\n- 42 = Tarjeta crédito (revierte transacción)\n- 43 = Billetera digital\n\n### 📌 8. Diferencia NC Cine vs NC POS vs NC Transporte\n\n| Aspecto | NC Cine | NC POS | NC Transporte |\n|--------|--------|--------|---------------|\n| **type_doc original** | 16 | 15 | 19 |\n| **Motivos comunes** | Cancelación, cambio función | Devolución producto | Cancelación viaje |\n| **Plazo devolución** | Hasta 30 min antes función | Depende producto | Antes de salida |\n| **show_room_info** | Requerida en referencia | N/A | N/A |\n| **transportation_info** | N/A | N/A | Requerida en referencia |\n\n### 📌 9. Casos de Rechazo Comunes\n\n| Error | Causa | Solución |\n|-------|-------|----------|\n| \"Invalid reference uuid\" | UUID no coincide con boleta | Copiar CUFE exacto de boleta |\n| \"Reference not found\" | Boleta no existe en DIAN | Verificar número boleta |\n| \"Operation not allowed\" | type_operation_id incorrecto | Usar 31 para equivalentes |\n| \"Missing is_eqdoc\" | Campo faltante | Agregar `\"is_eqdoc\": true` |\n| \"Invalid date_reference\" | Fecha boleta no es precedente | Asegurar NC después boleta |\n| \"Duplicate NC\" | Ya existe NC para esta boleta | Consultar si ya fue cancelada |\n| \"After show time\" | Intenta devolver después función | DIAN restringe (política cine) |\n\n### 📌 10. Documentación para Auditoría\n\n**Guardar:**\n- UUID boleta original\n- CUFE NC\n- Razón específica de devolución\n- Firma cliente (si aplica)\n- Método reembolso\n- Fecha/hora cancelación\n\n**Validación DIAN:**\n- Auditoría de ingresos vs cancelaciones\n- Tasa de cancelación por película/horario\n- Frecuencia de cambios vs política\n- Detección de fraude (cancelar/reemitir)\n\n### 📌 11. Flujo de Cancelación de Boleta\n\n**Escenario: Cliente quiere devolver boleta comprada hace 10 min**\n\n```\n16:10 → Compra boleta CIN-1, CUFE: 7a3c9e..., paga 30.000 COP\n16:15 → Cliente: \"Quiero devolverla, cambié de idea\"\n16:16 → Taquilla emite NC:\n {\n \"type_document_id\": 26,\n \"type_operation_id\": 31,\n \"is_eqdoc\": true,\n \"billing_reference\": {\n \"uuid\": \"7a3c9e...\",\n \"type_document_id\": 16,\n \"number\": \"CIN-1\"\n },\n \"payable_amount\": \"30000.00\"\n }\n16:17 → DIAN procesa NC ✓\n16:18 → Taquilla devuelve 30.000 COP en efectivo\n16:19 → Cliente se va satisfecho\n```\n\n### 📌 12. Restricción: No se Puede Cambiar precio\n\n❌ **INCORRECTO:**\n```json\n\"payable_amount\": \"25000.00\" // Intentar devolver menos del valor original\n```\n\n✓ **CORRECTO:**\n```json\n\"payable_amount\": \"30000.00\" // 100% del valor pagado\n```\n\n**Excepciones:**\n- Cambio a función más barata: Se devuelve diferencia\n- Promoción/descuento posterior: Se audita internamente\n\n### 📌 13. Estado de NC en DIAN\n\n**Posibles estados:**\n\n| state_document_id | Descripción |\n|-------------------|-------------|\n| 1 | Recibida (procesando) |\n| 2 | Aceptada (validada) |\n| 3 | Rechazada (error crítico) |\n| 4 | En evaluación (auditoría) |\n| 5 | Contingencia (sin conexión DIAN) |\n\n**Consultar:** POST `/api/ubl2.1/document-status/{document_id}`\n\n### 📌 14. Caso Real: Cancelación por Cambio de Planes\n\n**Situación:**\nCliente ALEXANDER compra boleta DEADPOOL función 16:30 SALA 6:\n- Boleta CIN-1\n- CUFE: 7a3c9e2f...\n- Precio: 30.000,00 COP\n- Asiento: G15\n\n**A los 5 minutos:**\n- Cliente llama: \"Mi hermano no va, devuelvo boleta\"\n- Cine emite NC CIN-NC-1 anulando CIN-1\n- 100% devuelto\n- Boleta CIN-1 ahora muestra \"Anulada\" en DIAN\n- Asiento G15 queda disponible para nueva venta\n\n### 📌 15. Comparativa: Tres Caminos para Espectador\n\n**Opción 1: Cancelación (este ejemplo)**\n```\nCompra boleta → Se arrepiente → NC → Dinero de vuelta\nCosto para cine: Reembolso + comisión tarjeta\n```\n\n**Opción 2: Cambio de Función**\n```\nCompra boleta DEADPOOL 16:30 → Quiere AVATAR 21:00\n→ NC boleta original → Nueva boleta AVATAR\n→ Si precio igual, sin reembolso neto\n→ Si precio mayor, cliente paga diferencia\n```\n\n**Opción 3: Cambio de Asiento**\n```\nCompra asiento G15 → Quiere asiento H10 (mejor ubicación)\n→ Cambio simple (no requiere NC formalmente)\n→ Si hay cargo diferencia, se carga a cliente\n→ Algunos cines emiten NC por control interno\n```\n\n---\n\n## 🎬 Resumen: NC Boleta Cine\n\n- **Propósito:** Devolver o ajustar boletas de cine emitidas\n- **Vinculación:** CUFE exacto de boleta original\n- **Campos clave:** is_eqdoc: true, type_operation_id: 31, billing_reference.uuid\n- **Plazo:** Antes de función (típicamente 30 min antes)\n- **Reembolso:** Generalmente 100% o diferencia si cambio\n- **DIAN valida:** Duplicados, fechas precedentes, referencias exactas\n- **Auditoría:** Tasa cancelación, ingresos vs devoluciones, control fraude" }, "response": [] } ] }, { "name": "Servicios Publicos", "item": [ { "name": "Servicios Publicos - Servicio y Complementos", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "host", "value": "apidian2026-8.oo", "type": "text", "disabled": true } ], "body": { "mode": "raw", "raw": "{\r\n\t\"number\": 1,\r\n\t\"type_document_id\": 24,\r\n \"type_operation_id\": 28,\r\n\t\"date\": \"2025-11-04\",\r\n\t\"time\": \"04:08:12\",\r\n\t\"resolution_number\": \"SSP\",\r\n\t\"prefix\": \"SSP\",\r\n \"notes\": \"ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA\",\r\n\t\"sendmail\": true,\r\n \"sendmailtome\": true,\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"last_valid_payment_date\": \"2025-10-31\",\r\n \"payment_reference\": \"190242200835880000-107-010787002\",\r\n \"stratum_id\": 3,\r\n \"software_manufacturer\":{\r\n \"name\": \"ALEXANDER OBANDO LONDONO\",\r\n \"business_name\": \"TORRE SOFTWARE\",\r\n \"software_name\": \"BABEL\"\r\n },\r\n \"spd\": \r\n [\r\n {\r\n \"agency_information\": {\r\n \"type_spd_id\": 1,\r\n \"office_lending_company\": \"OFICINA DE RECAUDO EFIGAS SA ESP\",\r\n \"contract_number\": \"ABC-000001\",\r\n \"issue_date\": \"2020-01\",\r\n \"note\": \"Esta es una nota de ejemplo.\"\r\n },\r\n \"subscriber_party\": {\r\n \"party_name\": \"ALEXANDER OBANDO LONDONO\",\r\n \"street_name\": \"CLL 11 NRO 21-73\",\r\n \"additional_street_name\": \"BRR LA CABAÑA, PISO 2, HOTEL OVERLOOK\",\r\n \"municipality_id\": 822,\r\n \"stratum\": \"3-Residencial\",\r\n \"email\": \"alexanderobandolondono@gmail.com\"\r\n },\r\n \"subscriber_consumption\": {\r\n \"duration_of_the_billing_cycle\": \"1.00\",\r\n \"consumption_section_note\": \"Esta es una nota de seccion de consumo de ejemplo\",\r\n \"total_metered_unit_id\": 864,\r\n \"total_metered_quantity\": \"15.00\",\r\n \"consumption_payable_amount\": \"30000.00\",\r\n \"consumption_price_quantity\": \"15.00\",\r\n \"partial_line_extension_amount\": \"90000.00\",\r\n \"cargos_debito_al_item\":\r\n [\r\n {\r\n \"charge_reason\": \"Alumbrado Publico\",\r\n \"amount\": \"4100\"\r\n },\r\n {\r\n \"charge_reason\": \"XYZ\",\r\n \"amount\": \"2000\"\r\n }\r\n ],\r\n \"unstructured_price\": {\r\n \"price_amount\": \"1960.10\",\r\n \"base_quantity\": \"1.00\"\r\n },\r\n \"consumption_history\": \r\n [\r\n {\r\n \"total_invoiced_quantity\": \"24.00\",\r\n \"start_date\": \"2025-01-01\",\r\n \"end_date\": \"2025-01-31\",\r\n \"duration_measure\": \"31\"\r\n },\r\n {\r\n \"total_invoiced_quantity\": \"20.00\",\r\n \"start_date\": \"2025-02-01\",\r\n \"end_date\": \"2025-02-28\",\r\n \"duration_measure\": \"29\"\r\n },\r\n {\r\n \"total_invoiced_quantity\": \"21.00\",\r\n \"start_date\": \"2025-03-01\",\r\n \"end_date\": \"2025-03-31\",\r\n \"duration_measure\": \"31\"\r\n }\r\n ]\r\n }\r\n },\r\n {\r\n \"agency_information\": {\r\n \"type_spd_id\": 8,\r\n \"office_lending_company\": \"EFIGAS S.A. E.S.P\",\r\n \"contract_number\": \"XYZ-000002\",\r\n \"issue_date\": \"2025-01\",\r\n \"note\": \"Esta es una nota de ejemplo.\"\r\n },\r\n \"subscriber_party\": {\r\n \"party_name\": \"ALEXANDER OBANDO LONDONO\",\r\n \"street_name\": \"CLL 11 NRO 21-73\",\r\n \"additional_street_name\": \"BRR LA CABAÑA, PISO 2, HOTEL OVERLOOK\",\r\n \"municipality_id\": 822,\r\n \"stratum\": \"3-Residencial\",\r\n \"email\": \"alexanderobandolondono@gmail.com\"\r\n },\r\n \"subscriber_consumption\": {\r\n \"duration_of_the_billing_cycle\": \"1.00\",\r\n \"consumption_section_note\": \"Esta es una nota de seccion de consumo de ejemplo\",\r\n \"total_metered_unit_id\": 864,\r\n \"total_metered_quantity\": \"15.00\",\r\n \"consumption_payable_amount\": \"30000.00\",\r\n \"consumption_price_quantity\": \"15.00\",\r\n \"partial_line_extension_amount\": \"90000.00\",\r\n \"descuentos_credito_al_item\":\r\n [\r\n {\r\n \"allowance_reason\": \"Subsidio Alumbrado Publico\",\r\n \"amount\": \"4100\"\r\n },\r\n {\r\n \"allowance_reason\": \"Subsidio XYZ\",\r\n \"amount\": \"2000\"\r\n }\r\n ],\r\n \"unstructured_price\": {\r\n \"price_amount\": \"2000.10\",\r\n \"base_quantity\": \"1.00\"\r\n },\r\n \"utility_meter\": {\r\n \"meter_number\": \"Tech_sirius_2016637401-7\",\r\n \"previous_meter_reading_date\": \"2025-03-27\",\r\n \"previous_meter_quantity\": \"1.360\",\r\n \"latest_meter_reading_date\": \"2025-04-27\",\r\n \"latest_meter_quantity\": \"1.382\",\r\n \"meter_reading_method\": \"Directa al contador\",\r\n \"duration_measure\": \"31\"\r\n },\r\n \"consumption_history\": \r\n [\r\n {\r\n \"total_invoiced_quantity\": \"24.00\",\r\n \"start_date\": \"2025-01-01\",\r\n \"end_date\": \"2025-01-31\",\r\n \"duration_measure\": \"31\"\r\n },\r\n {\r\n \"total_invoiced_quantity\": \"20.00\",\r\n \"start_date\": \"2025-02-01\",\r\n \"end_date\": \"2025-02-28\",\r\n \"duration_measure\": \"29\"\r\n },\r\n {\r\n \"total_invoiced_quantity\": \"21.00\",\r\n \"start_date\": \"2025-03-01\",\r\n \"end_date\": \"2025-03-31\",\r\n \"duration_measure\": \"31\"\r\n }\r\n ],\r\n \"payment_agreements\": \r\n [\r\n {\r\n \"contract_number\": \"IX900-abc-001\",\r\n \"good_service_name\": \"Tuberias\",\r\n \"description\": \"Instalacion de tuberias sin IVA\",\r\n \"fees_to_pay\": \"36\",\r\n \"paid_fees\": \"31\",\r\n \"interest_rate\": \"0.77\",\r\n \"balance_to_pay\": \"250000.00\",\r\n \"transaction_description\": \"Cuota 32\",\r\n \"fee_value_to_pay\": \"50000.00\",\r\n \"item_credit_discount\": \"0.00\",\r\n \"item_debit_charge\": \"0.00\"\r\n },\r\n {\r\n \"contract_number\": \"IX900-abc-002\",\r\n \"good_service_name\": \"Revision\",\r\n \"description\": \"Revision anual de la instalacion\",\r\n \"fees_to_pay\": \"36\",\r\n \"paid_fees\": \"11\",\r\n \"interest_rate\": \"0.77\",\r\n \"balance_to_pay\": \"1250000.00\",\r\n \"transaction_description\": \"Cuota 12\",\r\n \"fee_value_to_pay\": \"55000.00\",\r\n \"item_credit_discount\": \"0.00\",\r\n \"item_debit_charge\": \"0.00\"\r\n }\r\n ]\r\n }\r\n }\r\n ],\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 89008003,\r\n\t\t\"dv\": 2,\r\n\t\t\"name\": \"ALEXANDER OBANDO LONDONO\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexanderobandolondono@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 3,\r\n\t\t\"type_organization_id\": 2,\r\n \"type_liability_id\": 117,\r\n\t\t\"municipality_id\": 820,\r\n\t\t\"type_regime_id\": 2\r\n\t},\r\n\t\"payment_form\": {\r\n\t\t\"payment_form_id\": 1,\r\n\t\t\"payment_method_id\": 30,\r\n\t\t\"payment_due_date\": \"2025-11-04\",\r\n\t\t\"duration_measure\": \"0\"\r\n\t},\t\r\n\t\"allowance_charges\": [\r\n\t\t{\r\n\t\t\t\"discount_id\": 1,\r\n\t\t\t\"charge_indicator\": true,\r\n\t\t\t\"allowance_charge_reason\": \"Acuerdo de Pago\",\r\n\t\t\t\"amount\": \"700.00\",\r\n\t\t\t\"base_amount\": \"10000.00\"\r\n\t\t}\r\n\t],\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"8403.36134\",\r\n\t\t\"tax_exclusive_amount\": \"8403.36134\",\r\n\t\t\"tax_inclusive_amount\": \"10000.00\",\r\n \"allowance_total_amount\": \"0.00\",\r\n \"charge_total_amount\": \"700.00\",\r\n\t\t\"payable_amount\": \"10700.00\"\r\n\t},\r\n\t\"tax_totals\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"1596.63865\",\r\n\t\t\t\"percent\": \"19.00\",\r\n\t\t\t\"taxable_amount\": \"8403.36134\"\r\n\t\t}\r\n\t],\r\n\t\"invoice_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"8403.36134\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"1596.63865\",\r\n\t\t\t\t\t\"taxable_amount\": \"8403.36134\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"CONSUMO DE GAS\",\r\n \"seller_code\": \"0001\",\r\n\t\t\t\"code\": \"SPD-GAS\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"8403.36134\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/eqdoc", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "eqdoc" ] }, "description": "# 💡 SERVICIOS PÚBLICOS DOMICILIARIOS - COMPLETO (type_document_id 24)\n\n## 📄 Descripción General\n\nEste ejemplo demuestra la emisión de **facturas de servicios públicos domiciliarios** (`type_document_id: 24`) con **múltiples servicios** en un único documento. Es un Documento Equivalente especializado para **Empresas de Servicios Públicos (ESP)** como acueductos, empresas de gas, energía, telecomunicaciones y aseo.\n\n**Características clave:**\n- Array `spd` con 2 servicios: **Agua potable** (type_spd_id: 3) + **Gas** (type_spd_id: 8)\n- Lecturas de medidores con cálculo de consumo\n- Historiales de 3 meses para comparativa\n- Subsidios/contribuciones por estrato socioeconómico\n- Acuerdos de pago (financiaciones activas)\n- Cargos adicionales (alumbrado público)\n- Cálculo de IVA 19%\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/eqdoc\n```\n\n**Características:**\n- Tipo: Documento Equivalente - Servicios Públicos\n- Modo: Síncrono\n- Suscriptor: ALEXANDER OBANDO LONDONO\n- Servicios: Agua + Gas (2 SPD)\n- Estrato: 3 Residencial\n- Período: Marzo 2025\n\n---\n\n## 🔑 Campos Principales de Servicios Públicos\n\n### Datos del Documento\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **type_document_id** | **24** | **Servicios Públicos Domiciliarios** |\n| **type_operation_id** | 28 | Operación de servicios públicos |\n| **prefix** | SSP | Prefijo autorizado |\n| **number** | 1 | Número consecutivo |\n| **date** | 2025-11-04 | Fecha expedición |\n| **time** | 04:08:12 | Hora expedición |\n| **resolution_number** | SSP | Resolución DIAN |\n\n### Datos Específicos ESP\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **last_valid_payment_date** | 2025-10-31 | Fecha límite pago |\n| **payment_reference** | 190242200835... | Código bancario para PSE/transferencia |\n| **stratum_id** | 3 | Estrato socioeconómico |\n| **software_manufacturer** | TORRE SOFTWARE | Proveedor software facturación |\n\n### Array SPD - Estructura Compleja\n\n**SPD #1: Servicio de Agua Potable**\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **type_spd_id** | 3 | Agua potable |\n| **office_lending_company** | ACUEDUCTO CIUDAD | Empresa prestadora |\n| **contract_number** | ABC-000001 | Contrato suscriptor |\n| **party_name** | ALEXANDER OBANDO LONDONO | Titular |\n| **municipality_id** | 822 | Municipio (Pereira) |\n| **stratum** | 3-Residencial | Estrato |\n\n**Consumo Agua:**\n\n| Concepto | Valor | Descripción |\n|---------|-------|----------| \n| **total_metered_quantity** | 15,00 m³ | Metros cúbicos consumidos |\n| **consumption_payable_amount** | 30.000,00 | Valor consumo |\n| **utility_meter** | - | - |\n| - meter_number | Tech_sirius_... | Serial medidor |\n| - previous_reading | 1.360 m³ | Lectura anterior (27/03) |\n| - latest_reading | 1.382 m³ | Lectura actual (27/04) |\n| - difference | 0.022 m³ | Consumo calculado |\n\n**Cargos Agua:**\n\n| Cargo | Valor | Descripción |\n|-------|-------|----------| \n| **Alumbrado Público** | 4.100,00 | Contribución municipal |\n| **Mantenimiento Red** | 2.000,00 | Servicio complementario |\n| **Subtotal** | 36.100,00 | Base antes IVA |\n\n---\n\n**SPD #2: Servicio de Gas**\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **type_spd_id** | 8 | Gas combustible/otros |\n| **office_lending_company** | EFIGAS S.A. ESP | Empresa prestadora |\n| **contract_number** | XYZ-000002 | Contrato suscriptor |\n| **party_name** | ALEXANDER OBANDO LONDONO | Mismo titular |\n\n**Consumo Gas:**\n\n| Concepto | Valor | Descripción |\n|---------|-------|----------| \n| **total_metered_quantity** | 15,00 m³ | Metros cúbicos consumidos |\n| **consumption_payable_amount** | 30.000,00 | Valor consumo |\n| **utility_meter** | - | - |\n| - meter_number | Tech_sirius_... | Serial medidor |\n| - previous_reading | 1.360 m³ | Lectura anterior (27/03) |\n| - latest_reading | 1.382 m³ | Lectura actual (27/04) |\n\n**Descuentos Gas (Subsidios por estrato):**\n\n| Descuento | Valor | Descripción |\n|-----------|-------|----------| \n| **Subsidio Alumbrado** | -4.100,00 | Estrato 3 recibe |\n| **Subsidio Complemento** | -2.000,00 | Apoyo gobierno local |\n| **Total descuentos** | -6.100,00 | Beneficio suscriptor |\n\n**Acuerdos de Pago Activos (Financiación):**\n\n| Concepto | Valor | Descripción |\n|---------|-------|----------| \n| **Tuberías - Cuota 32** | - | - |\n| - Saldo pendiente | 250.000,00 | Deuda activa |\n| - Cuota del mes | 50.000,00 | Abono del período |\n| - Tasa interés | 0,77% | Costo financiero |\n| - Cuotas restantes | 5 | De 36 totales |\n| | | |\n| **Revisión Anual - Cuota 12** | - | - |\n| - Saldo pendiente | 1.250.000,00 | Deuda acumulada |\n| - Cuota del mes | 55.000,00 | Abono del período |\n| - Tasa interés | 0,77% | Costo financiero |\n| - Cuotas restantes | 25 | De 36 totales |\n\n---\n\n## 💰 Cálculo de Totales\n\n| Rubro | Valor | Descripción |\n|-------|-------|----------| \n| **Subtotal (sin IVA)** | 8.403,36 | Base gravable |\n| **IVA 19%** | 1.596,64 | Impuesto |\n| **Subtotal con IVA** | 10.000,00 | Base + IVA |\n| **Cargos Adicionales** | 700,00 | Acuerdo de pago |\n| **TOTAL A PAGAR** | **10.700,00** | Valor factura |\n\n---\n\n## 📝 Notas Importantes sobre Servicios Públicos\n\n### 📌 1. Array SPD: Múltiples Servicios en Uno\n\n```json\n\"spd\": [\n {\n \"agency_information\": { \"type_spd_id\": 3, ... }, // Agua\n \"subscriber_party\": { ... },\n \"subscriber_consumption\": { ... }\n },\n {\n \"agency_information\": { \"type_spd_id\": 8, ... }, // Gas\n \"subscriber_party\": { ... },\n \"subscriber_consumption\": { ... }\n }\n]\n```\n\n**Ventajas:**\n- Un documento, múltiples servicios\n- Un pago consolidado\n- Reducción de costos administrativos\n- Mejor experiencia suscriptor (factura única)\n\n### 📌 2. type_spd_id: Clasificación de Servicios\n\n```json\n\"type_spd_id\": 3 // Agua potable y alcantarillado\n```\n\n**Opciones DIAN:**\n\n| Código | Servicio | Medición |\n|--------|----------|----------|\n| **1** | Energía Eléctrica | kWh (kilowatios-hora) |\n| **2** | Gas Combustible | m³ (metros cúbicos) |\n| **3** | Acueducto/Agua Potable | m³ |\n| **4** | Alcantarillado | m³ |\n| **5** | Telecomunicaciones | Unidades/minutos |\n| **6** | Aseo/Recolección | Kg/mes |\n| **7** | Acueducto Comunitario | m³ |\n| **8** | Otros Servicios | Varía |\n\n### 📌 3. utility_meter: Lectura de Medidores\n\n```json\n\"utility_meter\": {\n \"meter_number\": \"Tech_sirius_2016637401-7\",\n \"previous_meter_reading_date\": \"2025-03-27\",\n \"previous_meter_quantity\": \"1.360\",\n \"latest_meter_reading_date\": \"2025-04-27\",\n \"latest_meter_quantity\": \"1.382\",\n \"meter_reading_method\": \"Directa al contador\",\n \"duration_measure\": \"31\"\n}\n```\n\n**Cálculo Consumo:**\n```\nConsumo = Latest - Previous\nConsumo = 1.382 - 1.360 = 0.022 m³\n```\n\n**Métodos de lectura:**\n- **\"Directa al contador\"** - Lecturador físico\n- **\"Telemetría\"** - Sistema automático (IoT)\n- **\"Estimada\"** - Promedio histórico\n- **\"Lectores remotos\"** - Dispositivo inteligente\n\n### 📌 4. stratum_id: Estrato Socioeconómico\n\n```json\n\"stratum_id\": 3,\n\"stratum\": \"3-Residencial\"\n```\n\n**Sistema de Estratos Colombia:**\n\n| Estrato | Tipo | Subsidio | Contribución |\n|---------|------|----------|---------------|\n| **1** | Bajo-bajo | Máximo 50% | No |\n| **2** | Bajo | Máximo 40% | No |\n| **3** | Medio-bajo | Máximo 15% | No |\n| **4** | Medio | Ninguno | 20% |\n| **5** | Medio-alto | Ninguno | 50% |\n| **6** | Alto | Ninguno | 100% |\n| **C** | Comercial | Ninguno | 20% |\n| **I** | Industrial | Ninguno | 50% |\n\n**Suscriptor estrato 3:**\n- Puede recibir subsidios hasta 15%\n- No paga contribuciones\n- Aplica para agua, energía, gas\n\n### 📌 5. cargos_debito_al_item vs descuentos_credito_al_item\n\n**Cargos (cobros adicionales):**\n```json\n\"cargos_debito_al_item\": [\n {\n \"charge_reason\": \"Alumbrado Publico\",\n \"amount\": \"4100\"\n },\n {\n \"charge_reason\": \"Mantenimiento Red\",\n \"amount\": \"2000\"\n }\n]\n```\n\n**Descuentos (subsidios):**\n```json\n\"descuentos_credito_al_item\": [\n {\n \"allowance_reason\": \"Subsidio Alumbrado Publico\",\n \"amount\": \"4100\"\n },\n {\n \"allowance_reason\": \"Subsidio XYZ\",\n \"amount\": \"2000\"\n }\n]\n```\n\n**Diferencia:**\n- Cargos: Aumentan el valor a pagar\n- Descuentos: Reducen el valor a pagar\n- Estrato 1-3: Descuentos\n- Estrato 4-6: Cargos (contribución)\n\n### 📌 6. consumption_history: Histórico 3+ Meses\n\n```json\n\"consumption_history\": [\n {\n \"total_invoiced_quantity\": \"24.00\",\n \"start_date\": \"2025-01-01\",\n \"end_date\": \"2025-01-31\",\n \"duration_measure\": \"31\"\n },\n {\n \"total_invoiced_quantity\": \"20.00\",\n \"start_date\": \"2025-02-01\",\n \"end_date\": \"2025-02-28\",\n \"duration_measure\": \"29\"\n },\n {\n \"total_invoiced_quantity\": \"21.00\",\n \"start_date\": \"2025-03-01\",\n \"end_date\": \"2025-03-31\",\n \"duration_measure\": \"31\"\n }\n]\n```\n\n**Uso en PDF:**\n- Gráfica de barras comparativa\n- Detección de fugas (consumo anómalo)\n- Análisis de tendencias\n- Transparencia para suscriptor\n\n### 📌 7. payment_agreements: Financiaciones Activas\n\n```json\n\"payment_agreements\": [\n {\n \"contract_number\": \"IX900-abc-001\",\n \"good_service_name\": \"Tuberias\",\n \"description\": \"Instalacion de tuberias sin IVA\",\n \"fees_to_pay\": \"36\",\n \"paid_fees\": \"31\",\n \"interest_rate\": \"0.77\",\n \"balance_to_pay\": \"250000.00\",\n \"transaction_description\": \"Cuota 32\",\n \"fee_value_to_pay\": \"50000.00\"\n }\n]\n```\n\n**Información crítica:**\n- **fees_to_pay**: Total cuotas acuerdo (36)\n- **paid_fees**: Cuotas pagadas (31)\n- **balance_to_pay**: Deuda activa (250.000,00)\n- **fee_value_to_pay**: Cuota del mes actual (50.000,00)\n- **interest_rate**: Tasa financiero (0,77%)\n\n### 📌 8. last_valid_payment_date: Plazo Pago\n\n```json\n\"last_valid_payment_date\": \"2025-10-31\"\n```\n\n**Importancia:**\n- Límite máximo para pago sin intereses\n- Típicamente 20-30 días después expedición\n- Si pasa: cobro de mora (interés\n+ comisión)\n- Debe estar en PDF y correos ESP\n\n### 📌 9. payment_reference: Código Bancario Único\n\n```json\n\"payment_reference\": \"190242200835880000-107-010787002\"\n```\n\n**Formato típico:**\n- Código DANE + referencia interna + dígitos\n- Único por factura\n- Permite identificar al suscriptor + período + ESP\n- Se paga en PSE, transferencias, corresponsales bancarios\n\n**Ejemplo de pago:**\n```\nCliente va a banco/cajero:\n\"Quiero pagar servicios públicos\"\nIngresa: 190242200835880000-107-010787002\nSistema bancario: Identifica empresa + suscriptor\nPago confirmado\n```\n\n### 📌 10. Casos de Uso Servicios Públicos\n\n**Caso 1: Servicios Múltiples (este ejemplo)**\n```\n- Un suscriptor\n- 2+ servicios (agua + gas)\n- Un documento\n- Un pago consolidado\n```\n\n**Caso 2: Residencia Estrato 1 con Máximo Subsidio**\n```json\n\"stratum_id\": 1,\n\"descuentos_credito_al_item\": [\n { \"allowance_reason\": \"Subsidio Agua 50%\", \"amount\": \"15000\" },\n { \"allowance_reason\": \"Subsidio Energía 50%\", \"amount\": \"25000\" }\n]\n```\n\n**Caso 3: Comercio Estrato C con Contribución**\n```json\n\"stratum_id\": 6, // O \"C\" comercial\n\"cargos_debito_al_item\": [\n { \"charge_reason\": \"Contribución Comercial 20%\", \"amount\": \"3000\" },\n { \"charge_reason\": \"Alumbrado Público\", \"amount\": \"1500\" }\n]\n```\n\n**Caso 4: Industrial Edificio Oficinas**\n```json\n\"spd\": [\n { \"type_spd_id\": 1, \"total_metered_quantity\": \"5000\" }, // 5.000 kWh\n { \"type_spd_id\": 3, \"total_metered_quantity\": \"200\" }, // 200 m³\n { \"type_spd_id\": 5, \"total_metered_quantity\": \"50\" } // Telecom\n]\n```\n\n### 📌 11. Comparativa: Servicios Públicos vs otros tipos\n\n| Aspecto | ESP (24) | POS (15) | Factura (1) |\n|---------|----------|---------|-------------|\n| **Modelo** | Periódico (mensual) | Transaccional | Único venta |\n| **Medidor** | Sí (gas, agua, energía) | No | No |\n| **Historiales** | 3-6 meses atrás | No | No |\n| **Subsidios** | Por estrato | No | No |\n| **Acuerdos pago** | Financiaciones | Plazo 30 días | Contado típico |\n| **Lecturas** | utility_meter + fechas | No | No |\n| **Múltiples servicios** | Sí (SPD array) | Boletas individuales | Múltiples líneas |\n\n### 📌 12. Matriz de Errores Comunes\n\n| Error | Causa | Solución |\n|-------|-------|----------|\n| \"SPD array vacío\" | Sin servicios definidos | Agregar mínimo 1 objeto SPD |\n| \"type_spd_id inválido\" | Código no reconocido (9, 10) | Usar 1-8 según tabla |\n| \"consumption_history desordenada\" | Fechas no cronológicas | Ordenar de antiguo a reciente |\n| \"Lecturas inconsistentes\" | latest < previous | Validar que lectura nueva > anterior |\n| \"stratum_id/stratum mismatch\" | 3 en raíz pero \"Comercial\" en texto | Mantener consistencia: stratum_id 3 → \"3-Residencial\" |\n| \"Acuerdo futuro\" | payment_agreement con fecha > hoy | Usar fechas precedentes |\n| \"payment_reference duplicado\" | Mismo código en 2 facturas | Generar uno único por documento |\n\n### 📌 13. Flujo Operativo Mensual de ESP\n\n**Fase 1: Lectura de Medidores**\n```\nDía 25: Lecturadores van a inmuebles\nRegistran: Lectura actual, método, fecha\nEjemplo: 1.382 m³ (27/04)\n```\n\n**Fase 2: Cálculo de Consumo**\n```\nConsumo = 1.382 - 1.360 = 0.022 m³\nValor = 0.022 × $1.363.636 = $30.000,00\n```\n\n**Fase 3: Aplicar Subsidios/Cargos**\n```\nEstrato 3: Descuento 15% = -6.100,00\nAlumbrado: Cargo = +4.100,00\nAcuerdos: Cuota abono = +50.000,00\n```\n\n**Fase 4: Generar Factura Electrónica**\n```\nPOST /api/ubl2.1/eqdoc\nDIAN valida\nGenerado: CUFE + PDF + XML\n```\n\n**Fase 5: Envío a Suscriptor**\n```\nsendmail: true → Email con PDF + QR\nPDF incluye: Gráficas, datos medidor, payment_reference\n```\n\n**Fase 6: Cobro**\n```\nSuscriptor paga:\n- PSE: payment_reference\n- Banco: payment_reference\n- ESP: Efectivo/transferencia\nValor: 10.700,00 COP (incluye acuerdo pago)\n```\n\n### 📌 14. Auditoría DIAN y SSPD\n\n**Validaciones DIAN:**\n- UUID único por factura\n- consumption_history coherente\n- Cargos/descuentos por estrato válidos\n- Fechas no futuras\n- payment_reference único\n\n**Validaciones SSPD (Superintendencia):**\n- Lecturas realistas (no saltos anormales)\n- Subsidios/contribuciones según estrato\n- Tasa morosidad (facturas impagadas)\n- Frecuencia emisión (mensual)\n- Documentación respaldatoria\n\n### 📌 15. Caso Real: Factura Agua + Gas Residencial\n\n**Suscriptor:** ALEXANDER OBANDO LONDONO \n**Dirección:** Calle 11 # 21-73, Barrio La Cabaña (Pereira) \n**Estrato:** 3 Residencial \n**Período:** Marzo 2025 \n\n**Lectura Agua:**\n- Anterior (27/02): 1.360 m³\n- Actual (27/03): 1.382 m³\n- Consumo: 0.022 m³ × $1.363.636 = 30.000,00 COP\n- Cargo: Alumbrado +4.100,00\n- **Subtotal Agua:** 34.100,00\n\n**Lectura Gas:**\n- Anterior: 1.360 m³\n- Actual: 1.382 m³\n- Consumo: 0.022 m³ × $1.363.636 = 30.000,00 COP\n- **Descuento (Estrato 3):** -6.100,00 (Subsidio + Beneficio)\n- **Subtotal Gas:** 23.900,00\n\n**Acuerdos Activos:**\n- Cuota Tuberías: +50.000,00\n- Cuota Revisión: +55.000,00\n\n**Cálculo Final:**\n```\nAgua + Gas + Cargos - Descuentos: 34.100 + 23.900 - 6.100 = 51.900\nIVA 19%: 9.861,00\nSubtotal: 61.761,00\nAcuerdos de pago: +105.000,00\n─────────────────\nTOTAL A PAGAR: 166.761,00 COP\n\nFecha límite pago: 31 de octubre 2025\nCódigo pago: 190242200835880000-107-010787002\n```\n\n**En PDF se genera:**\n- 📊 Gráfica consumo últimos 3 meses\n- 📋 Detalle de cargos/descuentos por estrato\n- 💳 Métodos de pago (PSE, banco, oficina ESP)\n- 📞 Números teléfono atención (24/7)\n- ⚠️ Alerta si consumo está fuera de rango" }, "response": [] }, { "name": "Servicios Publicos - Solo Servicio", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "host", "value": "apidian2026-8.oo", "type": "text", "disabled": true } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": 2,\r\n \"type_document_id\": 24,\r\n \"type_operation_id\": 28,\r\n \"date\": \"2025-11-04\",\r\n \"time\": \"04:08:12\",\r\n \"resolution_number\": \"SSP\",\r\n \"prefix\": \"SSP\",\r\n \"notes\": \"ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA\",\r\n \"sendmail\": true,\r\n \"sendmailtome\": true,\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"last_valid_payment_date\": \"2025-10-20\",\r\n \"payment_reference\": \"190242200835880000-107-010787002\",\r\n \"stratum_id\": 3,\r\n \"software_manufacturer\": {\r\n \"name\": \"ALEXANDER OBANDO LONDONO\",\r\n \"business_name\": \"TORRE SOFTWARE\",\r\n \"software_name\": \"BABEL\"\r\n },\r\n \"spd\": [\r\n {\r\n \"agency_information\": {\r\n \"type_spd_id\": 8,\r\n \"office_lending_company\": \"EFIGAS S.A. E.S.P\",\r\n \"contract_number\": \"XYZ-000002\",\r\n \"issue_date\": \"2025-03\",\r\n \"start_period_date\": \"2025-03-01\",\r\n \"end_period_date\": \"2025-03-01\",\r\n \"note\": \"Esta es una nota de ejemplo.\"\r\n },\r\n \"subscriber_party\": {\r\n \"party_name\": \"ALEXANDER OBANDO LONDONO\",\r\n \"street_name\": \"CLL 11 NRO 21-73\",\r\n \"additional_street_name\": \"BRR LA CABAÑA, PISO 2, HOTEL OVERLOOK\",\r\n \"municipality_id\": 822,\r\n \"stratum\": \"3-Residencial\",\r\n \"email\": \"alexanderobandolondono@gmail.com\"\r\n },\r\n \"subscriber_consumption\": {\r\n \"duration_of_the_billing_cycle\": \"31.00\",\r\n \"consumption_section_note\": \"Esta es una nota de seccion de consumo de ejemplo\",\r\n \"total_metered_unit_id\": 864,\r\n \"total_metered_quantity\": \"15.00\",\r\n \"consumption_payable_amount\": \"30000.00\",\r\n \"consumption_price_quantity\": \"15.00\",\r\n \"partial_line_extension_amount\": \"90000.00\",\r\n \"descuentos_credito_al_item\": [\r\n {\r\n \"allowance_reason\": \"Subsidio Alumbrado Publico\",\r\n \"amount\": \"4100.00\"\r\n },\r\n {\r\n \"allowance_reason\": \"Subsidio XYZ\",\r\n \"amount\": \"2000.00\"\r\n }\r\n ],\r\n \"cargos_debito_al_item\": [\r\n {\r\n \"charge_reason\": \"Alumbrado Publico\",\r\n \"amount\": \"4100.00\"\r\n },\r\n {\r\n \"charge_reason\": \"XYZ\",\r\n \"amount\": \"2000.00\"\r\n }\r\n ],\r\n \"unstructured_price\": {\r\n \"price_amount\": \"2000.10\",\r\n \"base_quantity\": \"1.00\"\r\n },\r\n \"utiliy_meter\": {\r\n \"meter_number\": \"Tech_sirius_2016637401-7\",\r\n \"previous_meter_reading_date\": \"2025-02-27\",\r\n \"previous_meter_quantity\": \"1.360\",\r\n \"latest_meter_reading_date\": \"2025-03-10\",\r\n \"latest_meter_quantity\": \"1.382\",\r\n \"meter_reading_method\": \"Directa al contador\",\r\n \"duration_measure\": \"30\"\r\n },\r\n \"consumption_history\": [\r\n {\r\n \"total_invoiced_quantity\": \"24.00\",\r\n \"start_date\": \"2025-01-01\",\r\n \"end_date\": \"2025-01-31\",\r\n \"duration_measure\": \"31\"\r\n },\r\n {\r\n \"total_invoiced_quantity\": \"20.00\",\r\n \"start_date\": \"2025-02-01\",\r\n \"end_date\": \"2025-02-28\",\r\n \"duration_measure\": \"29\"\r\n },\r\n {\r\n \"total_invoiced_quantity\": \"21.00\",\r\n \"start_date\": \"2025-03-01\",\r\n \"end_date\": \"2025-03-31\",\r\n \"duration_measure\": \"31\"\r\n }\r\n ],\r\n \"payment_agreements\": [\r\n {\r\n \"contract_number\": \"IX900-abc-001\",\r\n \"good_service_name\": \"Tuberias\",\r\n \"description\": \"Instalacion de tuberias sin IVA\",\r\n \"fees_to_pay\": \"36\",\r\n \"paid_fees\": \"31\",\r\n \"interest_rate\": \"0.77\",\r\n \"balance_to_pay\": \"250000.00\",\r\n \"transaction_description\": \"Cuota 32\",\r\n \"fee_value_to_pay\": \"50000.00\",\r\n \"item_credit_discount\": \"0.00\",\r\n \"item_debit_charge\": \"0.00\"\r\n },\r\n {\r\n \"contract_number\": \"IX900-abc-002\",\r\n \"good_service_name\": \"Revision\",\r\n \"description\": \"Revision anual de la instalacion\",\r\n \"fees_to_pay\": \"36\",\r\n \"paid_fees\": \"11\",\r\n \"interest_rate\": \"0.77\",\r\n \"balance_to_pay\": \"1250000.00\",\r\n \"transaction_description\": \"Cuota 12\",\r\n \"fee_value_to_pay\": \"55000.00\",\r\n \"item_credit_discount\": \"0.00\",\r\n \"item_debit_charge\": \"0.00\"\r\n }\r\n ]\r\n }\r\n }\r\n ],\r\n \"customer\": {\r\n \"identification_number\": 89008003,\r\n \"dv\": 2,\r\n \"name\": \"ALEXANDER OBANDO LONDONO\",\r\n \"phone\": \"3103891693\",\r\n \"address\": \"CLL 4 NRO 33-90\",\r\n \"email\": \"alexanderobandolondono@gmail.com\",\r\n \"merchant_registration\": \"0000000-00\",\r\n \"type_document_identification_id\": 3,\r\n \"type_organization_id\": 2,\r\n \"type_liability_id\": 117,\r\n \"municipality_id\": 820,\r\n \"type_regime_id\": 2\r\n },\r\n \"payment_form\": {\r\n \"payment_form_id\": 1,\r\n \"payment_method_id\": 30,\r\n \"payment_due_date\": \"2025-11-04\",\r\n \"duration_measure\": \"0\"\r\n },\r\n \"allowance_charges\": [\r\n {\r\n \"discount_id\": 1,\r\n \"charge_indicator\": true,\r\n \"allowance_charge_reason\": \"Acuerdo de Pago\",\r\n \"amount\": \"700.00\",\r\n \"base_amount\": \"10000.00\"\r\n }\r\n ],\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"8403.36134\",\r\n \"tax_exclusive_amount\": \"8403.36134\",\r\n \"tax_inclusive_amount\": \"10000.00\",\r\n \"allowance_total_amount\": \"0.00\",\r\n \"charge_total_amount\": \"700.00\",\r\n \"payable_amount\": \"10700.00\"\r\n },\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"1596.63865\",\r\n \"percent\": \"19.00\",\r\n \"taxable_amount\": \"8403.36134\"\r\n }\r\n ],\r\n \"invoice_lines\": [\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"8403.36134\",\r\n \"notes\": \"ESTA ES UNA NOTA DE PRUEBA DE SERVICIO INVOICE LINE\",\r\n \"free_of_charge_indicator\": false,\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"1596.63865\",\r\n \"taxable_amount\": \"8403.36134\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"8403.36134\"\r\n }\r\n ],\r\n \"description\": \"CONSUMO DE GAS\",\r\n \"seller_code\": \"0001\",\r\n \"code\": \"SPD-GAS\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"8403.36134\",\r\n \"base_quantity\": \"1\"\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/eqdoc", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "eqdoc" ] }, "description": "# ⚡ SERVICIOS PÚBLICOS - SIMPLIFICADO (type_document_id 24, Un Solo Servicio)\n\n## 📄 Descripción General\n\nEsta es una **variante simplificada** del documento de servicios públicos con **un único servicio** (gas). Es la configuración típica para:\n- Empresas con un único producto/servicio\n- Suscriptores residenciales monoservicio\n- Primeras integraciones ESP (estructura menos compleja)\n- Pruebas y validaciones iniciales\n\n**Simplificaciones respecto a ejemplo anterior:**\n- Solo 1 objeto `spd` (no array múltiple)\n- Menos cargos/descuentos\n- Financiación simple (2 acuerdos)\n- Válida para pequeñas ESP o filiales especializadas\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/eqdoc\n```\n\n**Características:**\n- Tipo: Documento Equivalente - Servicios Públicos\n- Modo: Síncrono\n- Suscriptor: ALEXANDER OBANDO LONDONO\n- Servicio: Gas Natural (type_spd_id: 8)\n- Estrato: 3 Residencial\n- Período: Marzo 2025\n\n---\n\n## 🔑 Estructura Simplificada\n\n### Documento\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------| \n| **type_document_id** | 24 | Servicios Públicos |\n| **type_operation_id** | 28 | Operación ESP |\n| **prefix** | SSP | Prefijo |\n| **number** | 2 | Documento #2 |\n| **date** | 2025-11-04 | Expedición |\n\n### SPD Único: Gas\n\n| Nivel | Campo | Valor | Descripción |\n|-------|-------|-------|-------------| \n| **agency_info** | type_spd_id | 8 | Gas/Otros |\n| | office_company | EFIGAS SA ESP | Prestador |\n| | contract_number | XYZ-000002 | Contrato |\n| | issue_date | 2025-03 | Desde |\n| | | | |\n| **subscriber** | party_name | ALEXANDER OBANDO | Titular |\n| | street_name | CLL 11 NRO 21-73 | Dirección |\n| | stratum | 3-Residencial | Estrato |\n| | | | |\n| **consumption** | total_metered_quantity | 15,00 m³ | Consumo |\n| | consumption_payable | 30.000,00 | Valor |\n| | utility_meter | ✓ | Lectura física |\n\n### Medidor: Lectura Real\n\n| Dato | Valor | Descripción |\n|------|-------|----------| \n| **meter_number** | Tech_sirius_... | Serial |\n| **previous_date** | 2025-02-27 | Lectura anterior |\n| **previous_qty** | 1.360 m³ | Valor anterior |\n| **latest_date** | 2025-03-10 | Lectura actual |\n| **latest_qty** | 1.382 m³ | Valor actual |\n| **duration** | 30 días | Período |\n\n### Consumo Histórico: 3 Meses\n\n| Período | Consumo | Días |\n|---------|---------|------| \n| Enero | 24,00 m³ | 31 |\n| Febrero | 20,00 m³ | 29 |\n| Marzo | 21,00 m³ | 31 |\n\n### Financiaciones: 2 Acuerdos Activos\n\n**Acuerdo 1: Tuberías**\n- Cuota: 50.000,00 (cuota #32 de 36)\n- Saldo pendiente: 250.000,00\n- Tasa: 0,77%\n\n**Acuerdo 2: Revisión Anual**\n- Cuota: 55.000,00 (cuota #12 de 36)\n- Saldo pendiente: 1.250.000,00\n- Tasa: 0,77%\n\n---\n\n## 💰 Cálculo de Totales\n\n| Rubro | Valor |\n|-------|-------| \n| **Consumo Gas** | 8.403,36 |\n| **IVA 19%** | 1.596,64 |\n| **Subtotal** | 10.000,00 |\n| **Subsidio Estrato 3** | -6.100,00 |\n| **Cargo Alumbrado** | 4.100,00 |\n| **Acuerdo Tuberías** | 50.000,00 |\n| **Acuerdo Revisión** | 55.000,00 |\n| **TOTAL A PAGAR** | **113.000,00** |\n\n---\n\n## 📝 Notas sobre Simplificación\n\n### 📌 1. Un Solo SPD: Estructura Mínima\n\n```json\n\"spd\": [\n {\n \"agency_information\": { ... },\n \"subscriber_party\": { ... },\n \"subscriber_consumption\": { ... }\n }\n] // Array con 1 elemento, no múltiple\n```\n\n**Ventajas:**\n- Menos complejidad JSON\n- Validación más rápida\n- Ideal para empresas especializadas (solo gas, solo agua)\n- Menor ancho banda de transmisión\n\n### 📌 2. Medidor Completo: Lectura Física\n\n```json\n\"utility_meter\": {\n \"meter_number\": \"Tech_sirius_2016637401-7\",\n \"previous_meter_reading_date\": \"2025-02-27\",\n \"previous_meter_quantity\": \"1.360\",\n \"latest_meter_reading_date\": \"2025-03-10\",\n \"latest_meter_quantity\": \"1.382\",\n \"meter_reading_method\": \"Directa al contador\",\n \"duration_measure\": \"30\"\n}\n```\n\n**Diferencia con ejemplo anterior:**\n- Anterior: 2 medidores (agua + gas)\n- Simplificado: 1 medidor (solo gas)\n- Cálculo: 1.382 - 1.360 = 0.022 m³\n\n### 📌 3. Consumo Histórico: Comparativa Básica\n\n```json\n\"consumption_history\": [\n { \"total_invoiced_quantity\": \"24.00\", \"start_date\": \"2025-01-01\", \"end_date\": \"2025-01-31\", \"duration_measure\": \"31\" },\n { \"total_invoiced_quantity\": \"20.00\", \"start_date\": \"2025-02-01\", \"end_date\": \"2025-02-28\", \"duration_measure\": \"29\" },\n { \"total_invoiced_quantity\": \"21.00\", \"start_date\": \"2025-03-01\", \"end_date\": \"2025-03-31\", \"duration_measure\": \"31\" }\n]\n```\n\n**Uso en análisis:**\n```\nEnero: 24 m³\nFebrero: 20 m³ (- 16% mes anterior)\nMarzo: 21 m³ (+ 5% vs febrero)\nPromedio: 21,67 m³\n\n→ Mes actual (21 m³): Dentro de rango normal\n→ PDF muestra gráfica de línea con tendencia\n```\n\n### 📌 4. Descuentos y Cargos: Simplificación\n\n```json\n\"descuentos_credito_al_item\": [\n { \"allowance_reason\": \"Subsidio Alumbrado Publico\", \"amount\": \"4100\" },\n { \"allowance_reason\": \"Subsidio XYZ\", \"amount\": \"2000\" }\n]\n```\n\n**Vs. ejemplo anterior:**\n- Anterior: 4 descuentos separados\n- Simplificado: 2 descuentos consolidados\n- Resultado: -6.100,00 (igual beneficio, menos líneas)\n\n### 📌 5. Acuerdos de Pago: Dos Financiaciones Activas\n\n```json\n\"payment_agreements\": [\n {\n \"contract_number\": \"IX900-abc-001\",\n \"good_service_name\": \"Tuberias\",\n \"fees_to_pay\": \"36\",\n \"paid_fees\": \"31\",\n \"balance_to_pay\": \"250000.00\",\n \"fee_value_to_pay\": \"50000.00\"\n },\n {\n \"contract_number\": \"IX900-abc-002\",\n \"good_service_name\": \"Revision\",\n \"fees_to_pay\": \"36\",\n \"paid_fees\": \"11\",\n \"balance_to_pay\": \"1250000.00\",\n \"fee_value_to_pay\": \"55000.00\"\n }\n]\n```\n\n**Estado de deudas:**\n- Tuberías: Cuota 32/36 (quedan 5)\n- Revisión: Cuota 12/36 (quedan 25)\n- Total actual a pagar: 50.000 + 55.000 = 105.000,00\n\n### 📌 6. Comparativa: Completo vs Simplificado\n\n| Aspecto | Completo | Simplificado |\n|--------|----------|---------------|\n| **SPD** | 2 (agua + gas) | 1 (solo gas) |\n| **Medidores** | 2 | 1 |\n| **Descuentos** | 4 líneas | 2 líneas |\n| **Acuerdos** | 2 | 2 |\n| **Líneas invoice** | 1 | 1 |\n| **JSON size** | ~500 líneas | ~300 líneas |\n| **Tiempo proceso** | ~2s | ~1s |\n| **Uso típico** | Edificios/empresas | Residencias/pequeña ESP |\n\n### 📌 7. Casos de Uso: Simplificado\n\n**Caso A: Pequeño Municipio con Acueducto Único**\n```json\n\"spd\": [{ \"type_spd_id\": 3, ... }] // Solo agua\n```\n\n**Caso B: Empresa Gas Especializada**\n```json\n\"spd\": [{ \"type_spd_id\": 2, ... }] // Solo gas combustible\n```\n\n**Caso C: ESP Telecomunicaciones**\n```json\n\"spd\": [{ \"type_spd_id\": 5, ... }] // Solo telecom\n```\n\n**Caso D: Empresa Aseo Residencial**\n```json\n\"spd\": [{ \"type_spd_id\": 6, ... }] // Solo recolección\n```\n\n### 📌 8. Validaciones Mismo que Completo\n\n- ✓ DIAN validación UUID único\n- ✓ Lecturas coherentes (latest > previous)\n- ✓ Subsidios según estrato\n- ✓ Fechas no futuras\n- ✓ payment_reference único\n- ✓ consumption_history cronológica\n\n### 📌 9. Flujo Operativo: Gas Residencial\n\n**Día 10 del mes:**\n```\nLecturador llega a casa ALEXANDER\n→ Lee medidor: 1.382 m³ (anterior 1.360)\n→ Registra en tablet: Fecha, hora, serial medidor\n```\n\n**Día 15:**\n```\nSistema calcula:\nConsumo = 1.382 - 1.360 = 0.022 m³\nValor = 0.022 × $1.363.636,36 = 30.000,00\nCargo alumbrado = 4.100,00\nDescuento estrato 3 = -6.100,00\nSubtotal consumo = 28.000,00\nCuota 1 tuberías = 50.000,00\nCuota 2 revisión = 55.000,00\n────────────────────────\nTOTAL = 133.000,00\n```\n\n**Día 20:**\n```\nPOST /api/ubl2.1/eqdoc → Factura electrónica\nDIAN: ✓ Validada\nCUFE: Generado\nPDF: Enviado a alexander@gmail.com\n```\n\n**Día 25-31:**\n```\nALEXANDER recibe PDF con:\n- Consumo histórico gráfico\n- Dos acuerdos de pago\n- Código de pago PSE\n- Número de teléfono EFIGAS emergencias\n\nAlexander paga:\n133.000,00 COP en banco con ref: 190242200835880000-107-010787002\n```\n\n### 📌 10. PDF: Lo que Suscriptor ve\n\n**Encabezado:**\n```\n┌─────────────────────────────────┐\n│ EFIGAS S.A. E.S.P. │\n│ FACTURA DE SERVICIOS PUBLICOS │\n│ Número: SSP-2 │\n│ Fecha: 2025-11-04 │\n└─────────────────────────────────┘\n```\n\n**Datos Suscriptor:**\n```\nNombre: ALEXANDER OBANDO LONDONO\nDirección: Cll 11 Nro 21-73, Barrio La Cabaña\nContrato: XYZ-000002\nEstrato: 3 (Residencial) → BENEFICIARIO SUBSIDIOS\n```\n\n**Consumo:**\n```\nConsumo Mes: 21,00 m³\nPromedio 3 meses: 21,67 m³\nTendencia: NORMAL ✓\n\n┌─ GRÁFICA DE BARRAS ─────┐\n│ ███ │ Enero (24)\n│ ███ │ Febrero (20)\n│ ███ │ Marzo (21)\n└────────────────────────┘\n```\n\n**Detalle Financiero:**\n```\nConsumo Gas 30.000,00\nIVA 19% 1.596,64\n────────────────────────────\nSubtotal 31.596,64\nSubsidio Estrato -3 -6.100,00\nAlumbrado público +4.100,00\n────────────────────────────\nServicios 29.596,64\n\n+ Acuerdo Tuberías 50.000,00\n+ Acuerdo Revisión 55.000,00\n════════════════════════════════════\nTOTAL A PAGAR 134.596,64\n\nFecha límite: 2025-10-20\n```\n\n**Métodos Pago:**\n```\n💳 PSE (Pago Seguro por Internet)\n Referencia: 190242200835880000-107-010787002\n\n🏦 Banco\n Cuenta: Servicios Públicos\n Referencia: 190242200835880000-107-010787002\n\n🚗 Efectivo\n Oficina EFIGAS, Cll 15 Nro 10-20\n Horario: Lunes a viernes 8-17h\n```\n\n**Acuerdos de Pago:**\n```\n📋 ACUERDO TUBERÍAS (IX900-abc-001)\n Instalación: $2.000.000,00\n Plan: 36 meses\n Cuota 32/36: $50.000,00 ← ESTE MES\n Saldo pendiente: $250.000,00\n Próxima cuota: $50.000,00\n\n📋 ACUERDO REVISIÓN (IX900-abc-002)\n Revisión anual: $1.500.000,00\n Plan: 36 meses\n Cuota 12/36: $55.000,00 ← ESTE MES\n Saldo pendiente: $1.250.000,00\n Próximas cuotas: $55.000,00 × 25\n```\n\n### 📌 11. Errores Comunes en Simplificado\n\n| Error | Cause | Fix |\n|-------|-------|-----|\n| \"Medidor incompleto\" | Falta latest_meter_reading | Agregar fecha/cantidad actual |\n| \"Lecturas invertidas\" | latest < previous | Verificar: nueva debe ser > anterior |\n| \"Stratum inconsistent\" | stratum_id 3 pero texto \"Comercial\" | Mantener consistencia |\n| \"Acuerdo futuro\" | payment_agreement con fecha > hoy | Usar fechas pasadas/presentes |\n| \"SPD vacío\" | array sin objetos | Agregar mínimo 1 SPD |\n\n### 📌 12. Diferencia Gas (type_spd_id 8) vs tipo 2\n\n```json\n// type_spd_id 2: Gas Combustible estricto\n\"type_spd_id\": 2,\n\"office_lending_company\": \"GASES DEL VALLE\",\n\n// type_spd_id 8: Otros servicios públicos (incluye gas)\n\"type_spd_id\": 8,\n\"office_lending_company\": \"EFIGAS (servicios complementarios)\",\n```\n\n**En este ejemplo:** type_spd_id 8 indica \"otros\" (gas como producto secundario, posible combo servicios).\n\n### 📌 13. Auditoría: Simplificado vs Completo\n\n**DIAN valida igual:**\n- UUID único (igual)\n- Fechas precedentes (igual)\n- Cálculos coherentes (igual)\n- consumption_history (igual)\n- Subsidios por estrato (igual)\n\n**Diferencia:**\n- Simplificado: 1 SPD → más rápido procesar\n- Completo: 2 SPD → más riguroso en múltiples servicios\n\n### 📌 14. Recomendación: Cuándo usar Simplificado\n\n✓ **USA SIMPLIFICADO si:**\n- Tu ESP tiene 1 único servicio\n- Suscriptores no contratan múltiples servicios\n- Querés integración rápida\n- Bajo volumen inicial\n\n✓ **USA COMPLETO si:**\n- Servicios múltiples (agua + gas + energía)\n- Clientes corporativos/edificios\n- Necesitas comparativas complejas\n- Alto volumen/estabilidad requerida\n\n### 📌 15. Resumen: Simplificado\n\n- **Propósito:** Factura gas residencial estrato 3\n- **SPD:** 1 servicio (gas)\n- **Medidor:** Lectura real (1.382 m³)\n- **Histórico:** 3 meses (24→20→21 m³)\n- **Descuentos:** Subsidios estrato 3\n- **Acuerdos:** 2 financiaciones activas\n- **Total:** 133.000,00 COP\n- **Validez:** Igual que completo (DIAN reconoce igual)" }, "response": [] }, { "name": "NC Documento Equivalente Servicios Publicos", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"is_eqdoc\": true,\r\n \"type_operation_id\": 32,\r\n\t\"billing_reference\": {\r\n\t\t\"number\": \"SSP1\",\r\n\t\t\"uuid\": \"3090a7891af570633f197db65a28f817f631b11441acbcab0137bf252774ea5d99b39b3018bfccf394d673a26e788867\",\r\n\t\t\"issue_date\": \"2025-11-04\",\r\n \"type_document_id\": 24\r\n\t},\r\n\t\"discrepancyresponsecode\": 2,\r\n \"notes\": \"PRUEBA DE NOTA CREDITO A DOCUMENTO EQUIVALENTE BOLETA DE INGRESO A CINE\",\r\n \"prefix\": \"NCP\",\r\n\t\"number\": 5,\r\n\t\"type_document_id\": 26,\r\n\t\"date\": \"2025-11-04\",\r\n\t\"time\": \"06:00:13\",\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"sendmail\": false,\r\n \"sendmailtome\": false,\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 900166483,\r\n\t\t\"dv\": 1,\r\n\t\t\"name\": \"INVERSIONES DAVAL SAS\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexanderobandolondono@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 6,\r\n\t\t\"type_organization_id\": 1,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1\r\n\t},\r\n\t\"tax_totals\": [\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"15966.386\",\r\n\t\t\t\"percent\": \"19\",\r\n\t\t\t\"taxable_amount\": \"84033.614\"\r\n\t\t}\r\n\t],\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"84033.614\",\r\n\t\t\"tax_exclusive_amount\": \"84033.614\",\r\n\t\t\"tax_inclusive_amount\": \"100000.00\",\r\n\t\t\"payable_amount\": \"100000.00\"\r\n\t},\r\n\t\"credit_note_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"84033.614\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"15966.386\",\r\n\t\t\t\t\t\"taxable_amount\": \"84033.614\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"CONSUMO DE GAS\",\r\n\t\t\t\"code\": \"SPD-GAS\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"100000.00\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/credit-note", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "credit-note" ] }, "description": "# 💡 NOTA CRÉDITO DOCUMENTO EQUIVALENTE SERVICIOS PÚBLICOS\n\n## 📄 Descripción General\n\nEste ejemplo demuestra cómo emitir una **Nota Crédito** (`type_document_id: 26`) que referencia un **Documento Equivalente de Servicios Públicos** (`type_document_id: 24`). Las Empresas de Servicios Públicos (ESP) utilizan este tipo de NC para corregir errores en facturación, anular cargos, o ajustar consumos.\n\n**Características clave:**\n- **Tipo:** Nota Crédito a Documento Equivalente\n- **Referencia:** SSP1 (Factura Servicios Públicos)\n- **type_operation_id:** 32 (específico para servicios públicos)\n- **is_eqdoc:** true (documento equivalente)\n- **Escenario:** Error en lectura de medidor de gas\n- **Monto:** $100.000 (IVA incluido)\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/credit-note\n```\n\n**Características:**\n- **Método:** POST\n- **Tipo documento:** 26 (Nota Crédito)\n- **Modo:** Síncrono\n- **Referencia:** type_document_id 24 (Servicios Públicos)\n- **Operación:** type_operation_id 32\n\n---\n\n## 🔑 Campos Principales\n\n### Documento\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **type_document_id** | 26 | Nota Crédito |\n| **is_eqdoc** | true | Documento Equivalente |\n| **type_operation_id** | **32** | **Operación servicios públicos** |\n| **prefix** | NCP | Prefijo NC |\n| **number** | 5 | Consecutivo |\n| **date** | 2025-11-04 | Fecha emisión |\n| **discrepancyresponsecode** | 2 | Código de discrepancia (crédito) |\n\n### Billing Reference (Documento Original)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **number** | SSP1 | Número factura servicios públicos |\n| **uuid** | 3090a789... | CUFE documento original |\n| **issue_date** | 2025-11-04 | Fecha factura original |\n| **type_document_id** | **24** | **Servicios Públicos Domiciliarios** |\n\n### Cliente (Empresa)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **identification_number** | 900166483 | NIT |\n| **dv** | 1 | Dígito verificación |\n| **name** | INVERSIONES DAVAL SAS | Razón social |\n| **type_organization_id** | 1 | Empresa |\n| **type_regime_id** | 1 | Responsable IVA |\n\n### Credit Note Lines\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **description** | CONSUMO DE GAS | Concepto |\n| **code** | SPD-GAS | Código servicio |\n| **invoiced_quantity** | 1 | Cantidad |\n| **line_extension_amount** | 84.033,61 | Base gravable |\n| **tax_id** | 1 | IVA 19% |\n| **tax_amount** | 15.966,39 | Valor IVA |\n| **price_amount** | 100.000,00 | Precio con IVA |\n\n---\n\n## 💰 Cálculo de Totales\n\n### Desglose\n\n```\nBase gravable: 84.033,61\nIVA 19%: + 15.966,39\n─────────────────────────\nTotal NC: 100.000,00\n```\n\n### Legal Monetary Totals\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **line_extension_amount** | 84.033,61 | Subtotal sin IVA |\n| **tax_exclusive_amount** | 84.033,61 | Base gravable |\n| **tax_inclusive_amount** | 100.000,00 | Total con IVA |\n| **payable_amount** | 100.000,00 | A abonar al cliente |\n\n---\n\n## 📝 Notas Críticas sobre NC Servicios Públicos\n\n### 📌 1. type_operation_id 32: Servicios Públicos\n\n```json\n{\n \"type_operation_id\": 32 // Específico para ESP\n}\n```\n\n**Diferencia con otras NC:**\n\n| type_operation_id | Uso | Tipo documento referenciado |\n|-------------------|-----|-----------------------------|\n| **31** | NC a documento equivalente genérico | POS (15), otros |\n| **32** | **NC a servicios públicos** | **Servicios Públicos (24)** |\n| 22 | NC a factura electrónica | Factura (1) |\n\n**Crítico:** Usar `type_operation_id: 32` **solo** cuando se anula/corrige un documento tipo 24 (Servicios Públicos).\n\n### 📌 2. billing_reference: Documento Servicios Públicos\n\n```json\n\"billing_reference\": {\n \"number\": \"SSP1\",\n \"uuid\": \"3090a789...\",\n \"issue_date\": \"2025-11-04\",\n \"type_document_id\": 24 // Servicios Públicos\n}\n```\n\n**Validación DIAN:**\n- ✓ `type_document_id: 24` debe existir en BD\n- ✓ `uuid` (CUFE) debe coincidir con factura original\n- ✓ `issue_date` debe ser igual o anterior a fecha NC\n- ✓ Factura SSP1 debe estar en estado \"Processed\" o \"Validating\"\n\n### 📌 3. is_eqdoc: true (Documento Equivalente)\n\n```json\n{\n \"is_eqdoc\": true // Obligatorio para NC de documentos equivalentes\n}\n```\n\n**Por qué es necesario:**\n- Indica que la NC pertenece al régimen de Documentos Equivalentes\n- Aplica validaciones específicas de SSPD (Superintendencia de Servicios Públicos)\n- Estructura diferente a NC de facturas electrónicas normales\n\n**Diferencia:**\n```json\n// NC a Factura Electrónica (tipo 1)\n{\n \"is_eqdoc\": false, // o no incluir\n \"type_operation_id\": 22\n}\n\n// NC a Documento Equivalente Servicios Públicos (tipo 24)\n{\n \"is_eqdoc\": true,\n \"type_operation_id\": 32\n}\n```\n\n### 📌 4. discrepancyresponsecode 2: Crédito\n\n```json\n{\n \"discrepancyresponsecode\": 2 // Código de discrepancia\n}\n```\n\n**Códigos disponibles:**\n\n| Código | Descripción | Uso |\n|--------|-------------|-----|\n| **1** | Devolución parcial | Cliente devuelve parte del servicio |\n| **2** | **Anulación/Crédito** | **Error facturación, cancelación** |\n| **3** | Rebaja por precio | Descuento posterior |\n| **4** | Rebaja por descuento | Promoción aplicada |\n| **5** | Avería/Defecto | Servicio defectuoso |\n\n**Para servicios públicos:**\n- Código `2` es el más común (error lectura medidor, sobrefacturación)\n\n### 📌 5. Motivos Comunes: NC Servicios Públicos\n\n**Motivo 1: Error en Lectura de Medidor**\n```\nFactura original (SSP1):\nLectura anterior: 1.000 m³\nLectura actual (ERROR): 1.100 m³\nConsumo facturado: 100 m³\nTotal: $300.000\n\nRealidad:\nLectura correcta: 1.021 m³\nConsumo real: 21 m³\n\nNC por diferencia:\nConsumo erróneo: 100 m³\nConsumo real: 21 m³\nDiferencia: 79 m³ × $3.000 = $237.000\n\nNC emitida: $237.000\n```\n\n**Motivo 2: Doble Facturación**\n```\nProblema:\nSistema facturó dos veces el mismo período\n- Factura SSP1: Enero 2025 - $150.000\n- Factura SSP2: Enero 2025 - $150.000 (duplicada)\n\nSolución:\nNC a SSP2 por $150.000 (anulación total)\n```\n\n**Motivo 3: Cambio de Tarifa Retroactivo**\n```\nEscenario:\nTarifa aplicada: $3.000/m³\nTarifa correcta (estrato 2): $2.500/m³\nConsumo: 50 m³\n\nFactura SSP1: 50 × $3.000 = $150.000\nDebe ser: 50 × $2.500 = $125.000\n\nNC: $25.000 (diferencia)\n```\n\n**Motivo 4: Subsidio No Aplicado**\n```\nProblema:\nCliente estrato 1 con subsidio 60%\nFactura SSP1 sin subsidio: $100.000\n\nCorrección:\nConsumo: $100.000\nSubsidio 60%: -$60.000\nTotal correcto: $40.000\n\nNC: $60.000 (subsidio)\n```\n\n### 📌 6. code: SPD-GAS (Código de Servicio)\n\n```json\n{\n \"code\": \"SPD-GAS\",\n \"description\": \"CONSUMO DE GAS\"\n}\n```\n\n**Códigos típicos ESP:**\n\n| Código | Descripción | Servicio |\n|--------|-------------|----------|\n| **SPD-GAS** | Gas natural | Gas domiciliario |\n| **SPD-AGUA** | Acueducto | Agua potable |\n| **SPD-LUZ** | Energía eléctrica | Electricidad |\n| **SPD-ALCANT** | Alcantarillado | Saneamiento |\n| **SPD-ASEO** | Aseo | Recolección basuras |\n| **SPD-TELEF** | Telefonía | Telefonía fija |\n| **SPD-INTERNET** | Internet | Conectividad |\n\n**Crítico:** Código debe coincidir con el de la factura original SSP1.\n\n### 📌 7. Cliente: Empresa vs Residencial\n\n**Este ejemplo:**\n```json\n{\n \"type_organization_id\": 1, // Empresa\n \"name\": \"INVERSIONES DAVAL SAS\"\n}\n```\n\n**Diferencia:**\n\n| Tipo | type_organization_id | Ejemplo |\n|------|---------------------|----------|\n| **Empresa** | 1 | Industrial, comercial |\n| **Persona Natural** | 2 | Residencial, doméstico |\n\n**Implicaciones:**\n- Empresas: Tarifa industrial (sin subsidio)\n- Residencial: Tarifa con subsidio/sobretasa según estrato\n- IVA: Ambas pagan 19% (servicios públicos gravados)\n\n### 📌 8. Comparativa: NC Servicios Públicos vs NC POS\n\n| Aspecto | NC Servicios Públicos | NC POS |\n|---------|----------------------|--------|\n| **type_document_id** | 26 | 26 |\n| **type_operation_id** | **32** | 31 |\n| **Referencia** | Tipo 24 (SPD) | Tipo 15 (POS) |\n| **is_eqdoc** | true | true |\n| **Endpoint** | /credit-note | /credit-note |\n| **Sector** | ESP (gas, agua, luz) | Comercio, restaurantes |\n| **Regulación** | SSPD + DIAN | Solo DIAN |\n| **Motivos** | Error medidor, tarifa | Devolución, error precio |\n\n### 📌 9. Auditoría SSPD\n\n**Superintendencia de Servicios Públicos Domiciliarios:**\n\nLas ESP están sujetas a auditoría SSPD, que verifica:\n\n✓ Correcta aplicación de tarifas por estrato \n✓ Subsidios y sobretasas \n✓ Lecturas de medidores \n✓ Facturación sin errores \n✓ Notas Crédito justificadas \n\n**Documentación NC:**\n```json\n{\n \"notes\": \"Error en lectura de medidor - Lectura correcta: 1021 m³\"\n}\n```\n\n**Recomendación:** Incluir en `notes` el motivo específico de la NC para auditorías.\n\n### 📌 10. Validaciones DIAN Específicas\n\n**DIAN valida:**\n\n✓ `type_operation_id: 32` solo si referencia tipo 24 \n✓ `is_eqdoc: true` presente \n✓ `billing_reference.uuid` coincide con CUFE en BD \n✓ Factura SSP1 existe y está procesada \n✓ Fecha NC ≥ Fecha factura original \n✓ `payable_amount` ≤ monto factura original \n✓ `discrepancyresponsecode` válido (1-5) \n\n❌ **Rechaza si:**\n- `type_operation_id: 31` en lugar de 32\n- Referencia a tipo_document_id diferente de 24\n- `is_eqdoc` faltante o false\n- CUFE inválido\n- NC mayor que factura original\n\n### 📌 11. Flujo Operativo: Error en Facturación\n\n**Escenario Real:**\nEmpresa de Gas Natural detecta error en factura.\n\n**Paso 1: Factura Original (SSP1)**\n```\nFecha: 2025-11-04\nConsumo facturado: 100 m³\nTarifa: $3.000/m³\nSubtotal: $300.000\nIVA 19%: $57.000\nTotal: $357.000\n```\n\n**Paso 2: Detección de Error**\n```\nCliente reclama: \"Estuve de viaje, no pudo consumir 100 m³\"\nESP revisa medidor: Lectura correcta es 21 m³\nError: 79 m³ sobrefacturados\n```\n\n**Paso 3: Cálculo de NC**\n```\nConsumo erróneo: 79 m³\nTarifa: $3.000/m³\nSubtotal: $237.000\nIVA 19%: $45.030\nTotal NC: $282.030\n```\n\n**Paso 4: Emisión NC**\n```json\nPOST /api/ubl2.1/credit-note\n{\n \"type_operation_id\": 32,\n \"billing_reference\": {\n \"number\": \"SSP1\",\n \"type_document_id\": 24\n },\n \"credit_note_lines\": [\n {\n \"description\": \"CONSUMO DE GAS - AJUSTE POR ERROR LECTURA\",\n \"invoiced_quantity\": \"79\",\n \"price_amount\": \"3000.00\"\n }\n ]\n}\n```\n\n**Paso 5: DIAN Aprueba**\n```\nStatus: Processed\nCUFE NC: xyz789...\nPDF: NC-5.pdf\n```\n\n**Paso 6: Ajuste en Facturación**\n```\nFactura SSP1: $357.000\nNC-5: - $282.030\n─────────────────────\nSaldo real: $74.970\n```\n\n### 📌 12. Errores Comunes\n\n| Error | Causa | Solución |\n|-------|-------|----------|\n| \"Invalid type_operation_id\" | Usar 31 en lugar de 32 | Usar `type_operation_id: 32` para SPD |\n| \"is_eqdoc required\" | Falta campo is_eqdoc | Agregar `\"is_eqdoc\": true` |\n| \"Document not found\" | billing_reference.uuid inválido | Verificar CUFE de SSP1 |\n| \"Type mismatch\" | Referenciar tipo diferente de 24 | billing_reference.type_document_id: 24 |\n| \"Amount exceeds original\" | NC mayor que factura | Validar cálculo: NC ≤ SSP1 |\n| \"Invalid discrepancy code\" | Código fuera de rango 1-5 | Usar código válido (2 para crédito) |\n\n### 📌 13. PDF: Lo que Cliente Ve\n\n```\n┌──────────────────────────────────┐\n│ EMPRESA DE GAS NATURAL S.A. │\n│ NOTA CRÉDITO DOCUMENTO EQUIV. │\n│ NCP-5 │\n│ 2025-11-04 │\n└──────────────────────────────────┘\n\nREFERENCIA:\nFactura Servicios Públicos: SSP1\nFecha original: 2025-11-04\n\nCLIENTE:\nINVERSIONES DAVAL SAS\nNIT: 900166483-1\nCLL 4 NRO 33-90\n\nDETALLE DE AJUSTE:\n\nCONSUMO DE GAS\nCódigo: SPD-GAS\nCantidad: 1\nValor: $84.033,61\nIVA 19%: $15.966,39\n─────────────────────────────────\n\nMOTIVO:\nError en lectura de medidor\nConsumo facturado: 100 m³\nConsumo real: 21 m³\nAjuste: 79 m³\n\n═════════════════════════════════\nTOTAL NOTA CRÉDITO: $100.000,00\n═════════════════════════════════\n\nEste valor será abonado en su\npróxima facturación o puede\nsolicitar devolución.\n\nConsultas: 018000123456\n```\n\n### 📌 14. Impacto en Próxima Factura\n\n**Escenario:**\n```\nFactura SSP1 (Nov): $357.000\nNC-5 (Nov): - $282.030\nSaldo Nov: $74.970\n\nFactura SSP2 (Dic): $150.000\nSaldo pendiente: + $74.970\n─────────────────────────────\nTotal a pagar Dic: $224.970\n```\n\n**Alternativa: Devolución**\n```\nCliente solicita devolución de NC-5\nESP procesa:\n- Transferencia bancaria: $282.030\n- Plazo: 30 días hábiles\n- Sin impacto en próxima factura\n```\n\n### 📌 15. Resumen: NC Servicios Públicos\n\n- **Propósito:** Corregir errores en facturación de servicios públicos\n- **type_operation_id:** 32 (específico SPD)\n- **Referencia:** Documento tipo 24 (Servicios Públicos)\n- **is_eqdoc:** true (obligatorio)\n- **Motivos:** Error medidor, doble facturación, tarifa incorrecta, subsidio\n- **Regulación:** DIAN + SSPD\n- **Cliente:** Empresa o residencial\n- **Código:** SPD-GAS, SPD-AGUA, SPD-LUZ, etc.\n- **Validación:** CUFE original, monto, fecha\n- **Impacto:** Abono próxima factura o devolución" }, "response": [] } ] }, { "name": "NC Una Linea, Sin Descuentos, Una Tarifa de IVA", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"is_eqdoc\": true,\r\n \"type_operation_id\": 31, // No colocar si es documento POS\r\n\t\"billing_reference\": {\r\n\t\t\"number\": \"EPOS11\",\r\n\t\t\"uuid\": \"4330571e42ae249e98025c8fb6312fef97a58cbda65584ef43e2e002c6d6be107fcc0dd1dd662273c871f6ee0bb72de7\",\r\n\t\t\"issue_date\": \"2025-11-04\",\r\n \"type_document_id\": 15\r\n\t},\r\n\t\"discrepancyresponsecode\": 2,\r\n \"notes\": \"PRUEBA DE NOTA CREDITO A DOCUMENTO EQUIVALENTE POS\",\r\n \"prefix\": \"NCP\",\r\n\t\"number\": 1,\r\n\t\"type_document_id\": 26,\r\n\t\"date\": \"2025-11-04\",\r\n\t\"time\": \"06:00:13\",\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"sendmail\": false,\r\n \"sendmailtome\": false,\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 900166483,\r\n\t\t\"dv\": 1,\r\n\t\t\"name\": \"INVERSIONES DAVAL SAS\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexanderobandolondono@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 6,\r\n\t\t\"type_organization_id\": 1,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1\r\n\t},\r\n\t\"tax_totals\": [\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"15966.386\",\r\n\t\t\t\"percent\": \"19\",\r\n\t\t\t\"taxable_amount\": \"84033.614\"\r\n\t\t}\r\n\t],\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"84033.614\",\r\n\t\t\"tax_exclusive_amount\": \"84033.614\",\r\n\t\t\"tax_inclusive_amount\": \"100000.00\",\r\n\t\t\"payable_amount\": \"100000.00\"\r\n\t},\r\n\t\"credit_note_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"84033.614\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"15966.386\",\r\n\t\t\t\t\t\"taxable_amount\": \"84033.614\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"COMISION POR SERVICIOS\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"COMISION\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"100000.00\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/credit-note", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "credit-note" ] }, "description": "# 📋 NOTA CRÉDITO A DOCUMENTO EQUIVALENTE POS\n\n## 📄 Descripción General\n\nEste ejemplo demuestra cómo emitir una **Nota Crédito** (`type_document_id: 26`) que referencia un **Documento Equivalente POS** (`type_document_id: 15`). Este es un ejemplo adicional/variante del ejemplo principal de NC a POS documentado anteriormente, con la misma estructura pero diferente numeración para propósitos de testing y validación.\n\n**Características clave:**\n- **Tipo:** Nota Crédito a Documento Equivalente\n- **Referencia:** EPOS11 (Factura POS)\n- **type_operation_id:** 31 (documento equivalente genérico)\n- **is_eqdoc:** true\n- **discrepancyresponsecode:** 2 (anulación/crédito)\n- **Monto:** $100.000,00\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/credit-note\n```\n\n**Características:**\n- **Método:** POST\n- **Tipo documento:** 26 (Nota Crédito)\n- **Modo:** Síncrono\n- **Referencia:** type_document_id 15 (POS)\n- **Operación:** type_operation_id 31\n\n---\n\n## 🔑 Campos Principales\n\n### Documento\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **type_document_id** | 26 | Nota Crédito |\n| **is_eqdoc** | true | Documento Equivalente |\n| **type_operation_id** | 31 | Operación documento equivalente |\n| **prefix** | NCP | Prefijo NC |\n| **number** | 1 | Consecutivo |\n| **date** | 2025-11-04 | Fecha emisión |\n| **discrepancyresponsecode** | 2 | Anulación/Crédito |\n\n### Billing Reference\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **number** | EPOS11 | Número POS original |\n| **uuid** | 4330571e... | CUFE documento original |\n| **issue_date** | 2025-11-04 | Fecha documento original |\n| **type_document_id** | 15 | POS |\n\n### Credit Note Lines\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **description** | COMISION POR SERVICIOS | Concepto |\n| **code** | COMISION | Código |\n| **invoiced_quantity** | 1 | Cantidad |\n| **line_extension_amount** | 84.033,61 | Base gravable |\n| **tax_id** | 1 | IVA 19% |\n| **tax_amount** | 15.966,39 | Valor IVA |\n| **price_amount** | 100.000,00 | Precio unitario |\n\n---\n\n## 💰 Cálculo de Totales\n\n```\nBase gravable: 84.033,61\nIVA 19%: + 15.966,39\n─────────────────────────\nTotal NC: 100.000,00\n```\n\n---\n\n## 📝 Notas sobre Este Ejemplo\n\n### 📌 1. Variante del Ejemplo Principal\n\nEste ejemplo es una **variante** del ejemplo principal \"NC POS - Una Linea, Sin Descuentos, Una Tarifa de IVA\" documentado previamente en la colección. La diferencia principal es:\n\n**Ejemplo Principal:**\n- Número: NC-1\n- Documentación completa: 15+ notas, escenarios, errores\n\n**Este Ejemplo (Variante):**\n- Número: NC-1 (mismo, para testing)\n- Estructura idéntica\n- Propósito: Validación y testing de diferentes consecutivos\n\n### 📌 2. Estructura Idéntica\n\n```json\n{\n \"type_document_id\": 26,\n \"is_eqdoc\": true,\n \"type_operation_id\": 31,\n \"billing_reference\": {\n \"number\": \"EPOS11\",\n \"type_document_id\": 15\n },\n \"discrepancyresponsecode\": 2,\n \"credit_note_lines\": [...],\n \"legal_monetary_totals\": {...}\n}\n```\n\n**Todos los campos son iguales al ejemplo principal**, solo cambia el consecutivo o el contexto de uso.\n\n### 📌 3. Propósito: Testing y Validación\n\n**Casos de uso de este ejemplo:**\n\n1. **Testing de Numeración**\n - Probar diferentes consecutivos NC\n - Validar rangos de resolución\n - Verificar secuencia de prefijos\n\n2. **Ambiente de Desarrollo**\n - Pruebas sin afectar consecutivos productivos\n - Validación de estructura\n - Debug de integración\n\n3. **Capacitación**\n - Ejemplo adicional para entrenamiento\n - Práctica de emisión NC\n - Simulación de escenarios\n\n### 📌 4. Referencia al Ejemplo Principal\n\nPara documentación completa sobre **Notas Crédito a POS**, consulte el ejemplo principal que incluye:\n\n✓ 15+ notas críticas sobre NC a documentos equivalentes \n✓ Motivos comunes (devolución, anulación, descuento) \n✓ Flujo operativo completo \n✓ Errores comunes y soluciones \n✓ Validaciones DIAN \n✓ Comparativa NC vs ND \n✓ Escenarios reales \n✓ PDF de ejemplo \n✓ Impacto contable \n\n**Ubicación:** Sección \"Notas Crédito\" → \"NC POS - Una Linea, Sin Descuentos, Una Tarifa de IVA\"\n\n### 📌 5. Diferencias con NC Servicios Públicos\n\nAunque ambos son NC tipo 26, hay diferencias:\n\n| Aspecto | NC a POS (este) | NC a Servicios Públicos |\n|---------|-----------------|-------------------------|\n| **type_operation_id** | 31 | 32 |\n| **Referencia** | Tipo 15 (POS) | Tipo 24 (SPD) |\n| **Sector** | Comercio/servicios | Empresas de servicios públicos |\n| **Regulación** | Solo DIAN | DIAN + SSPD |\n| **Motivos** | Devolución, anulación | Error medidor, tarifa |\n\n### 📌 6. Uso Recomendado\n\n**Cuándo usar este ejemplo:**\n- ✓ Testing de NC en ambiente desarrollo\n- ✓ Validación de estructura antes de producción\n- ✓ Capacitación de equipo de facturación\n- ✓ Debug de integración con DIAN\n- ✓ Pruebas de secuencia de numeración\n\n**Cuándo usar el ejemplo principal:**\n- ✓ Referencia completa de documentación\n- ✓ Entender motivos y escenarios\n- ✓ Resolver errores específicos\n- ✓ Implementación inicial\n\n### 📌 7. Validaciones DIAN\n\nDIAN aplica las **mismas validaciones** que al ejemplo principal:\n\n✓ `type_document_id: 26` (Nota Crédito) \n✓ `is_eqdoc: true` presente \n✓ `type_operation_id: 31` para POS \n✓ `billing_reference.uuid` válido \n✓ Factura EPOS11 existe y está procesada \n✓ `credit_note_lines` (no debit_note_lines) \n✓ `legal_monetary_totals` (no requested_monetary_totals) \n✓ Fecha NC ≥ Fecha factura original \n\n### 📌 8. Testing con Postman\n\n**Flujo de prueba:**\n\n```javascript\n// 1. Crear POS original\nPOST /api/ubl2.1/eqdoc\n{\n \"number\": 11,\n \"prefix\": \"EPOS\",\n \"type_document_id\": 15\n}\n// Guardar CUFE retornado\n\n// 2. Emitir NC usando este ejemplo\nPOST /api/ubl2.1/credit-note\n{\n \"billing_reference\": {\n \"number\": \"EPOS11\",\n \"uuid\": \"\"\n }\n}\n\n// 3. Validar respuesta\nif (status === 'Processed') {\n console.log('NC emitida correctamente');\n}\n```\n\n### 📌 9. Comparación: Ejemplo Principal vs Este Ejemplo\n\n**Similitudes:**\n- ✓ Misma estructura JSON\n- ✓ Mismos campos obligatorios\n- ✓ Mismo endpoint\n- ✓ Mismas validaciones DIAN\n- ✓ Mismo comportamiento\n\n**Diferencias:**\n- ✗ Número consecutivo puede variar\n- ✗ Documentación: Este es variante, principal es completo\n- ✗ Propósito: Este es testing, principal es producción\n\n### 📌 10. Resumen: Este Ejemplo\n\n- **Propósito:** Variante/testing de NC a POS\n- **Estructura:** Idéntica al ejemplo principal\n- **type_document_id:** 26 (Nota Crédito)\n- **type_operation_id:** 31 (documento equivalente)\n- **Referencia:** EPOS11 (POS tipo 15)\n- **Uso:** Testing, validación, capacitación\n- **Documentación completa:** Ver ejemplo principal en colección\n- **Validaciones:** Mismas que ejemplo principal\n\n**Para información detallada sobre NC a POS (motivos, errores, escenarios, flujos), consulte el ejemplo principal documentado anteriormente en esta colección.**" }, "response": [] }, { "name": "ND Una Linea, Sin Descuentos, Una Tarifa de IVA", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"is_eqdoc\": true,\r\n \"type_operation_id\": 31, // No colocar si es documento POS\r\n\t\"billing_reference\": {\r\n\t\t\"number\": \"EPOS11\",\r\n\t\t\"uuid\": \"4330571e42ae249e98025c8fb6312fef97a58cbda65584ef43e2e002c6d6be107fcc0dd1dd662273c871f6ee0bb72de7\",\r\n\t\t\"issue_date\": \"2025-11-04\",\r\n \"type_document_id\": 15\r\n\t},\r\n\t\"discrepancyresponsecode\": 3,\r\n\t\"discrepancyresponsedescription\": \"PRUEBA DE MOTIVO NOTA DEBITO A DOCUMENTO EQUIVALENTE POS\",\r\n \"notes\": \"PRUEBA DE NOTA DEBITO\",\r\n \"prefix\": \"NDP\",\r\n\t\"number\": 1,\r\n\t\"type_document_id\": 25,\r\n\t\"date\": \"2025-11-04\",\r\n\t\"time\": \"06:00:13\",\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"sendmail\": true,\r\n \"sendmailtome\": true,\r\n \"seze\": \"2021-2017\",\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 900166483,\r\n\t\t\"dv\": 1,\r\n\t\t\"name\": \"INVERSIONES DAVAL SAS\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexanderobandolondono@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 6,\r\n\t\t\"type_organization_id\": 1,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1\r\n\t},\r\n\t\"allowance_charges\": [\r\n\t\t{\r\n\t\t\t\"discount_id\": 1,\r\n\t\t\t\"charge_indicator\": false,\r\n\t\t\t\"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n\t\t\t\"amount\": \"50000.00\",\r\n\t\t\t\"base_amount\": \"1000000.00\"\r\n\t\t}\r\n\t],\r\n\t\"requested_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\"tax_exclusive_amount\": \"840336.134\",\r\n\t\t\"tax_inclusive_amount\": \"1000000.00\",\r\n\t\t\"allowance_total_amount\": \"50000.00\",\r\n\t\t\"payable_amount\": \"950000.00\"\r\n\t},\r\n\t\"tax_totals\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\"percent\": \"19\",\r\n\t\t\t\"taxable_amount\": \"840336.134\"\r\n\t\t}\r\n\t],\r\n\t\"debit_note_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\t\t\"taxable_amount\": \"840336.134\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"COMISION POR SERVICIOS\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"COMISION\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"1000000.00\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/debit-note", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "debit-note" ] }, "description": "# ➕ NOTA DÉBITO A DOCUMENTO EQUIVALENTE POS\n\n## 📄 Descripción General\n\nEste ejemplo demuestra cómo emitir una **Nota Débito** (`type_document_id: 25`) que referencia un **Documento Equivalente POS** (`type_document_id: 15`). Las Notas Débito se utilizan para **incrementar** el valor de una transacción previamente facturada, aplicando cargos adicionales por intereses, penalidades, ajustes de precio, o servicios no incluidos originalmente.\n\n**Características clave:**\n- **Tipo:** Nota Débito a Documento Equivalente\n- **Referencia:** EPOS11 (Factura POS)\n- **type_operation_id:** 31 (documento equivalente genérico)\n- **is_eqdoc:** true\n- **discrepancyresponsecode:** 3 (cargo adicional)\n- **Monto adicional:** $950.000,00\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/debit-note\n```\n\n**Características:**\n- **Método:** POST\n- **Tipo documento:** 25 (Nota Débito)\n- **Modo:** Síncrono\n- **Referencia:** type_document_id 15 (POS)\n- **Operación:** type_operation_id 31\n\n---\n\n## 🔑 Campos Principales\n\n### Documento\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **type_document_id** | 25 | Nota Débito |\n| **is_eqdoc** | true | Documento Equivalente |\n| **type_operation_id** | 31 | Operación documento equivalente |\n| **prefix** | NDP | Prefijo ND |\n| **number** | 1 | Consecutivo |\n| **date** | 2025-11-04 | Fecha emisión |\n| **discrepancyresponsecode** | **3** | **Débito/Cargo adicional** |\n\n### Billing Reference (Documento Original)\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **number** | EPOS11 | Número POS original |\n| **uuid** | 4330571e... | CUFE documento original |\n| **issue_date** | 2025-11-04 | Fecha documento original |\n| **type_document_id** | 15 | POS |\n\n### Diferencia Clave: requested_monetary_totals\n\n**Nota Débito usa `requested_monetary_totals` (NO `legal_monetary_totals`):**\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **line_extension_amount** | 840.336,13 | Base gravable |\n| **tax_exclusive_amount** | 840.336,13 | Subtotal sin IVA |\n| **tax_inclusive_amount** | 1.000.000,00 | Total con IVA |\n| **allowance_total_amount** | 50.000,00 | Descuento global |\n| **payable_amount** | 950.000,00 | **Total adicional a cobrar** |\n\n### Debit Note Lines\n\n**Nota Débito usa `debit_note_lines` (NO `credit_note_lines`):**\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **description** | COMISION POR SERVICIOS | Concepto |\n| **code** | COMISION | Código |\n| **invoiced_quantity** | 1 | Cantidad |\n| **line_extension_amount** | 840.336,13 | Base gravable |\n| **tax_id** | 1 | IVA 19% |\n| **tax_amount** | 159.663,87 | Valor IVA |\n| **price_amount** | 1.000.000,00 | Precio unitario |\n\n---\n\n## 💰 Cálculo de Totales\n\n### Desglose\n\n```\nBase gravable: 840.336,13\nIVA 19%: + 159.663,87\n─────────────────────────────\nSubtotal: 1.000.000,00\nDescuento global: - 50.000,00\n─────────────────────────────\nTotal ND: 950.000,00\n```\n\n### Impacto en Factura Original\n\n```\nFactura EPOS11: 1.000.000,00\nND-1 (adicional): + 950.000,00\n─────────────────────────────\nNuevo total: 1.950.000,00\n```\n\n---\n\n## 📝 Notas Críticas sobre Notas Débito\n\n### 📌 1. Nota Débito vs Nota Crédito: Diferencias Fundamentales\n\n| Aspecto | Nota Crédito (NC) | Nota Débito (ND) |\n|---------|-------------------|------------------|\n| **type_document_id** | 26 | **25** |\n| **Propósito** | Reducir/anular monto | **Incrementar monto** |\n| **discrepancyresponsecode** | 1, 2, 4, 5 | **3** |\n| **Líneas** | `credit_note_lines` | **`debit_note_lines`** |\n| **Totales** | `legal_monetary_totals` | **`requested_monetary_totals`** |\n| **Impacto** | Cliente recibe abono | **Cliente debe pagar más** |\n| **Ejemplo** | Devolución $100K | **Cargo adicional $100K** |\n\n**Crítico:** NO confundir estructuras. Usar `debit_note_lines` y `requested_monetary_totals` en ND.\n\n### 📌 2. discrepancyresponsecode 3: Débito/Cargo Adicional\n\n```json\n{\n \"discrepancyresponsecode\": 3, // Código específico para ND\n \"discrepancyresponsedescription\": \"AJUSTE DE PRECIO POR ERROR\"\n}\n```\n\n**Códigos de discrepancia:**\n\n| Código | Tipo | Uso |\n|--------|------|-----|\n| **1** | NC | Devolución parcial |\n| **2** | NC | Anulación/crédito |\n| **3** | **ND** | **Débito/cargo adicional** |\n| **4** | NC | Rebaja por descuento |\n| **5** | NC | Avería/defecto |\n\n**Solo código 3 es válido para Notas Débito.**\n\n### 📌 3. requested_monetary_totals vs legal_monetary_totals\n\n**Nota Crédito (26):**\n```json\n{\n \"legal_monetary_totals\": { // ← NC usa LEGAL\n \"payable_amount\": \"100000.00\"\n }\n}\n```\n\n**Nota Débito (25):**\n```json\n{\n \"requested_monetary_totals\": { // ← ND usa REQUESTED\n \"payable_amount\": \"950000.00\"\n }\n}\n```\n\n**Validación DIAN:**\n- ❌ Si ND usa `legal_monetary_totals` → Rechazo\n- ❌ Si NC usa `requested_monetary_totals` → Rechazo\n- ✓ Cada tipo debe usar su estructura específica\n\n### 📌 4. debit_note_lines: Estructura Específica\n\n```json\n\"debit_note_lines\": [ // NO credit_note_lines\n {\n \"unit_measure_id\": 70,\n \"invoiced_quantity\": \"1\",\n \"line_extension_amount\": \"840336.134\",\n \"free_of_charge_indicator\": false,\n \"tax_totals\": [\n {\n \"tax_id\": 1,\n \"tax_amount\": \"159663.865\",\n \"percent\": \"19.00\"\n }\n ],\n \"description\": \"COMISION POR SERVICIOS\",\n \"code\": \"COMISION\",\n \"price_amount\": \"1000000.00\"\n }\n]\n```\n\n**Diferencia con NC:**\n- NC: `credit_note_lines`\n- ND: `debit_note_lines`\n\n### 📌 5. Motivos Comunes: Notas Débito\n\n**Motivo 1: Error en Precio (Cobró Menos)**\n```\nFactura EPOS11:\nProducto: Servicio consultoría\nPrecio cobrado: $500.000 (ERROR)\nPrecio correcto: $1.000.000\n\nDiferencia: $500.000\nND-1: Cargo adicional por $500.000\n\nTotal a pagar:\nEPOS11: $500.000\nND-1: $500.000\n─────────────────\nTotal: $1.000.000 ✓\n```\n\n**Motivo 2: Intereses por Mora**\n```\nFactura EPOS11: $1.000.000\nFecha vencimiento: 2025-10-15\nFecha pago: 2025-11-15 (30 días tarde)\n\nInterés mora: 2% mensual\nCálculo: $1.000.000 × 2% = $20.000\n\nND-1: $20.000 (intereses)\n\nTotal a pagar:\nEPOS11: $1.000.000\nND-1: $ 20.000\n─────────────────\nTotal: $1.020.000\n```\n\n**Motivo 3: Servicios Adicionales No Incluidos**\n```\nFactura EPOS11:\n- Servicio básico: $1.000.000\n\nCliente solicita después:\n- Servicio premium adicional: $500.000\n\nND-1: $500.000 (servicio extra)\n\nTotal:\nEPOS11: $1.000.000\nND-1: $ 500.000\n─────────────────\nTotal: $1.500.000\n```\n\n**Motivo 4: Descuento Aplicado Incorrectamente**\n```\nFactura EPOS11:\nBase: $1.000.000\nDescuento 50% (ERROR): -$500.000\nTotal cobrado: $500.000\n\nDescuento correcto: 10% = -$100.000\nTotal correcto: $900.000\n\nDiferencia: $900.000 - $500.000 = $400.000\n\nND-1: $400.000 (ajuste descuento)\n```\n\n**Motivo 5: Penalidad Contractual**\n```\nFactura EPOS11: $1.000.000\nContrato: Pago máximo 15 días\nPago recibido: 45 días\n\nPenalidad contractual: 5% por mes\nCálculo: $1.000.000 × 5% × 1 mes = $50.000\n\nND-1: $50.000 (penalidad)\n```\n\n### 📌 6. type_operation_id 31: Documento Equivalente\n\n```json\n{\n \"type_operation_id\": 31 // Genérico para documentos equivalentes\n}\n```\n\n**Aplicación:**\n- ND a POS (tipo 15): type_operation_id 31\n- ND a Factura Electrónica (tipo 1): type_operation_id 23\n- ND a Servicios Públicos (tipo 24): type_operation_id 31 o 32\n\n**Diferencia:**\n\n| Referencia | type_operation_id |\n|------------|-------------------|\n| POS (15) | 31 |\n| Factura (1) | 23 |\n| Servicios Públicos (24) | 32 |\n\n### 📌 7. allowance_charges en Nota Débito\n\n**Este ejemplo incluye descuento global:**\n\n```json\n\"allowance_charges\": [\n {\n \"discount_id\": 1,\n \"charge_indicator\": false, // false = descuento\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\n \"amount\": \"50000.00\",\n \"base_amount\": \"1000000.00\"\n }\n]\n```\n\n**Cálculo:**\n```\nBase línea: 1.000.000,00\nDescuento 5%: - 50.000,00\n─────────────────────────────\nBase gravable: 950.000,00\nIVA 19%: + 180.500,00\n─────────────────────────────\nTotal ND: 1.130.500,00\n```\n\n**Nota:** Aunque se llama `allowance_charges`, en ND se usa para aplicar descuentos sobre el cargo adicional.\n\n### 📌 8. Flujo Operativo: Ajuste de Precio\n\n**Escenario Real:**\nRestaurante cobra menos de lo debido en POS.\n\n**Paso 1: Factura Original (EPOS11)**\n```\nFecha: 2025-11-04 12:30 PM\nMesero registra:\n- Plato principal: $30.000\n- Bebida: $10.000\nTotal: $40.000 + IVA = $47.600\nPago: $47.600 (efectivo)\n```\n\n**Paso 2: Error Detectado**\n```\nSupervisor revisa cuenta:\nDebe incluir:\n- Plato principal: $30.000\n- Bebida: $10.000\n- Postre: $15.000 (OLVIDADO)\n\nTotal correcto: $55.000 + IVA = $65.450\nCobrado: $47.600\nDiferencia: $17.850\n```\n\n**Paso 3: Cliente Aún en Restaurante**\n```\nSupervisor:\n\"Disculpe, nos faltó incluir el postre en la cuenta\"\n\nCliente acepta pagar diferencia\n```\n\n**Paso 4: Emisión ND**\n```json\nPOST /api/ubl2.1/debit-note\n{\n \"type_document_id\": 25,\n \"billing_reference\": {\n \"number\": \"EPOS11\",\n \"type_document_id\": 15\n },\n \"debit_note_lines\": [\n {\n \"description\": \"POSTRE - AJUSTE FACTURA\",\n \"price_amount\": \"15000.00\"\n }\n ]\n}\n```\n\n**Paso 5: Pago Adicional**\n```\nND-1 emitida: $17.850\nCliente paga: $17.850\n\nTotal pagado:\nEPOS11: $47.600\nND-1: $17.850\n─────────────────\nTotal: $65.450 ✓\n```\n\n### 📌 9. Validaciones DIAN\n\n**DIAN verifica:**\n\n✓ `type_document_id: 25` (Nota Débito) \n✓ `discrepancyresponsecode: 3` (único código válido para ND) \n✓ `debit_note_lines` (no credit_note_lines) \n✓ `requested_monetary_totals` (no legal_monetary_totals) \n✓ `billing_reference.uuid` existe en BD \n✓ Factura EPOS11 está en estado \"Processed\" \n✓ Fecha ND ≥ Fecha factura original \n✓ `is_eqdoc: true` si referencia documento equivalente \n\n❌ **Rechaza si:**\n- Usa `credit_note_lines` en lugar de `debit_note_lines`\n- Usa `legal_monetary_totals` en lugar de `requested_monetary_totals`\n- `discrepancyresponsecode` diferente de 3\n- CUFE inválido o factura no existe\n- Fecha ND anterior a factura\n\n### 📌 10. Comparativa: Estructura NC vs ND\n\n**Nota Crédito (26):**\n```json\n{\n \"type_document_id\": 26,\n \"discrepancyresponsecode\": 2, // 1, 2, 4, o 5\n \"credit_note_lines\": [...], // ← credit\n \"legal_monetary_totals\": { // ← legal\n \"payable_amount\": \"100000.00\"\n }\n}\n```\n\n**Nota Débito (25):**\n```json\n{\n \"type_document_id\": 25,\n \"discrepancyresponsecode\": 3, // Solo 3\n \"debit_note_lines\": [...], // ← debit\n \"requested_monetary_totals\": { // ← requested\n \"payable_amount\": \"950000.00\"\n }\n}\n```\n\n### 📌 11. Errores Comunes\n\n| Error | Causa | Solución |\n|-------|-------|----------|\n| \"Invalid lines structure\" | Usar credit_note_lines | Cambiar a `debit_note_lines` |\n| \"Invalid totals structure\" | Usar legal_monetary_totals | Cambiar a `requested_monetary_totals` |\n| \"Invalid discrepancy code\" | Usar código 1, 2, 4, o 5 | Usar solo código `3` |\n| \"Document not found\" | billing_reference.uuid inválido | Verificar CUFE de EPOS11 |\n| \"Type mismatch\" | type_operation_id incorrecto | Usar 31 para POS, 23 para facturas |\n| \"Date error\" | ND anterior a factura | ND.date ≥ billing_reference.issue_date |\n\n### 📌 12. Cuándo Usar ND vs NC\n\n**Usar Nota Débito (ND):**\n- ✓ Cobró menos de lo debido (error precio)\n- ✓ Intereses por mora\n- ✓ Penalidades contractuales\n- ✓ Servicios adicionales posteriores\n- ✓ Descuento aplicado incorrectamente (muy alto)\n- ✓ Cargo por gestión o administración\n\n**Usar Nota Crédito (NC):**\n- ✓ Cobró más de lo debido\n- ✓ Devolución de productos\n- ✓ Anulación de factura\n- ✓ Descuento posterior\n- ✓ Error a favor del cliente\n\n**Resumen:**\n```\nND: Cliente debe pagar MÁS\nNC: Cliente recibe abono/devolución\n```\n\n### 📌 13. PDF: Lo que Cliente Ve\n\n```\n┌────────────────────────────────┐\n│ RESTAURANTE EL BUEN SABOR │\n│ NOTA DÉBITO │\n│ NDP-1 │\n│ 2025-11-04 │\n└────────────────────────────────┘\n\nREFERENCIA:\nFactura POS: EPOS11\nFecha original: 2025-11-04\n\nCLIENTE:\nINVERSIONES DAVAL SAS\nNIT: 900166483-1\n\nMOTIVO:\nAjuste por error en precio\nDescuento aplicado incorrectamente\n\nDETALLE:\n\nCOMISION POR SERVICIOS\nCantidad: 1\nBase: $840.336,13\nIVA 19%: $159.663,87\nSubtotal: $1.000.000,00\nDescuento: -$50.000,00\n─────────────────────────────\n\n═══════════════════════════════\nTOTAL ADICIONAL: $950.000,00\n═══════════════════════════════\n\nRESUMEN DE CUENTA:\n\nFactura EPOS11: $1.000.000,00\nNota Débito ND-1: +$950.000,00\n────────────────────────────────\nNUEVO TOTAL: $1.950.000,00\n────────────────────────────────\n\nPago pendiente: $950.000,00\n\nFecha vencimiento: 2025-11-19\n```\n\n### 📌 14. Impacto Contable\n\n**Registro contable ND:**\n\n```\nCuenta por Cobrar $950.000 (Débito)\n Ingresos $798.319 (Crédito)\n IVA por Pagar $151.681 (Crédito)\n\nExplicación:\nND incrementa cuenta por cobrar\nReconoce ingreso adicional\nGenera obligación de IVA\n```\n\n**Comparación con NC:**\n\n```\nNota Crédito (reduce ingreso):\nIngresos $798.319 (Débito)\nIVA por Pagar $151.681 (Débito)\n Cuenta por Cobrar $950.000 (Crédito)\n\nNota Débito (incrementa ingreso):\nCuenta por Cobrar $950.000 (Débito)\n Ingresos $798.319 (Crédito)\n IVA por Pagar $151.681 (Crédito)\n```\n\n### 📌 15. Resumen: Nota Débito\n\n- **Propósito:** Incrementar valor factura original\n- **type_document_id:** 25\n- **discrepancyresponsecode:** 3 (único código válido)\n- **Líneas:** `debit_note_lines` (no credit)\n- **Totales:** `requested_monetary_totals` (no legal)\n- **Motivos:** Error precio, intereses, penalidades, servicios adicionales\n- **Impacto:** Cliente debe pagar MONTO ADICIONAL\n- **Diferencia NC:** NC reduce, ND incrementa\n- **Validación:** Estructura específica diferente a NC\n- **Endpoint:** POST /api/ubl2.1/debit-note" }, "response": [] } ] }, { "name": "Contingencia Tipo 4", "item": [ { "name": "Contingencia Tipo 4 - Una Linea, Descuento Global, Una Tarifa de IVA", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "7692a20fec92af0aa5729d796b019d27c83c9955407994630a0cdd7702ca2329", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"number\": 994500032,\r\n\t\"type_document_id\": 12,\r\n\t\"date\": \"2025-06-03\",\r\n\t\"time\": \"04:08:12\",\r\n\t\"resolution_number\": \"18760000001\",\r\n\t\"prefix\": \"SETP\",\r\n \"notes\": \"ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA\",\r\n \"disable_confirmation_text\": true,\r\n \"establishment_name\": \"TORRE SOFTWARE NRO 1\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"establishment_email\": \"alternate_email@alternate.com\",\r\n\t\"sendmail\": false,\r\n \"sendmailtome\": false,\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 41946692,\r\n\t\t\"dv\": 6,\r\n\t\t\"name\": \"ELIZABETH CARDONA VILLADA\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexander_obando@hotmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 3,\r\n\t\t\"type_organization_id\": 2,\r\n \"type_liability_id\": 7,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1,\r\n \"tax_id\": 1\r\n\t},\r\n\t\"payment_form\": {\r\n\t\t\"payment_form_id\": 1,\r\n\t\t\"payment_method_id\": 30,\r\n\t\t\"payment_due_date\": \"2025-06-03\",\r\n\t\t\"duration_measure\": \"0\"\r\n\t},\t\r\n\t\"allowance_charges\": [\r\n\t\t{\r\n\t\t\t\"discount_id\": 1,\r\n\t\t\t\"charge_indicator\": false,\r\n\t\t\t\"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n\t\t\t\"amount\": \"50000.00\",\r\n\t\t\t\"base_amount\": \"1000000.00\"\r\n\t\t}\r\n\t],\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\"tax_exclusive_amount\": \"840336.134\",\r\n\t\t\"tax_inclusive_amount\": \"1000000.00\",\r\n\t\t\"allowance_total_amount\": \"50000.00\",\r\n\t\t\"payable_amount\": \"950000.00\"\r\n\t},\r\n\t\"tax_totals\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\"percent\": \"19\",\r\n\t\t\t\"taxable_amount\": \"840336.134\"\r\n\t\t}\r\n\t],\r\n\t\"invoice_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"840336.134\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"159663.865\",\r\n\t\t\t\t\t\"taxable_amount\": \"840336.134\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"COMISION POR SERVICIOS\",\r\n \"notes\": \"ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.\",\r\n\t\t\t\"code\": \"COMISION\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"1000000.00\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t]\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice-contingency-4", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice-contingency-4" ] }, "description": "# 🚨 FACTURA ELECTRÓNICA CONTINGENCIA TIPO 4\n\n## 📄 Descripción General\n\nEste ejemplo demuestra cómo emitir una **Factura Electrónica en Modo Contingencia Tipo 4** (`type_document_id: 12`). Este tipo de factura se utiliza cuando el emisor **no puede conectarse a los servicios de la DIAN en tiempo real** debido a problemas técnicos, pero puede emitir documentos que serán enviados posteriormente.\n\n**Características clave:**\n- **Tipo:** Factura Contingencia Tipo 4\n- **type_document_id:** 12\n- **Escenario:** Falla temporal en servicios DIAN\n- **Emisión:** Offline/Diferida\n- **Envío posterior:** Mediante endpoint send_pendings\n- **Validez:** Legal mientras se envíe dentro del plazo (48 horas)\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/invoice-contingency-4\n```\n\n**Características:**\n- **Método:** POST\n- **Tipo documento:** 12 (Contingencia Tipo 4)\n- **Modo:** Generación local + envío diferido\n- **Plazo envío:** Máximo 48 horas desde emisión\n- **Resolución:** Requiere resolución específica para contingencia\n\n---\n\n## 🔑 Campos Principales\n\n### Documento\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **type_document_id** | **12** | **Factura Contingencia Tipo 4** |\n| **number** | 994500032 | Consecutivo alto (rango contingencia) |\n| **prefix** | SETP | Prefijo específico contingencia |\n| **date** | 2025-06-03 | Fecha emisión |\n| **time** | 04:08:12 | Hora exacta |\n| **resolution_number** | 18760000001 | Resolución DIAN para contingencia |\n\n### Cliente\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **identification_number** | 41946692 | Cédula |\n| **name** | ELIZABETH CARDONA VILLADA | Persona natural |\n| **type_organization_id** | 2 | Persona natural |\n| **type_liability_id** | 7 | No responsable IVA |\n\n### Descuento Global\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **discount_id** | 1 | Código descuento |\n| **amount** | 50.000,00 | Valor descuento |\n| **base_amount** | 1.000.000,00 | Base para calcular |\n\n### Totales\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **line_extension_amount** | 840.336,13 | Base gravable |\n| **tax_inclusive_amount** | 1.000.000,00 | Total con IVA |\n| **allowance_total_amount** | 50.000,00 | Descuentos |\n| **payable_amount** | 950.000,00 | Total a pagar |\n\n---\n\n## 💰 Cálculo de Totales\n\n```\nPrecio unitario: 1.000.000,00\nDescuento 5%: - 50.000,00\n─────────────────────────────\nBase gravable: 950.000,00\nIVA 19%: + 180.500,00\n─────────────────────────────\nTotal: 1.130.500,00\n\nNota: Revisar cálculo, ejemplo muestra:\nBase: 840.336,13 + IVA 159.663,87 = 1.000.000\ncon descuento: 950.000,00\n```\n\n---\n\n## 📝 Notas Críticas sobre Contingencia Tipo 4\n\n### 📌 1. ¿Qué es Contingencia Tipo 4?\n\n**Definición DIAN:**\n\nLa **Contingencia Tipo 4** es un mecanismo que permite al facturador electrónico continuar emitiendo facturas cuando **no puede conectarse a los servicios web de la DIAN** debido a:\n\n- Caída de servidores DIAN\n- Problemas de red del emisor\n- Mantenimiento programado DIAN\n- Saturación de servicios (ej: cierre de mes)\n- Problemas certificado digital temporal\n\n**Diferencia con otros tipos:**\n\n| Tipo | Descripción | Cuándo usar |\n|------|-------------|-------------|\n| **Tipo 1** | Factura normal | Conectividad normal |\n| **Tipo 4** | **Sin conexión DIAN** | **Falla temporal servicios** |\n| **Tipo 12** | Contingencia offline | Alternativa contingencia |\n\n### 📌 2. type_document_id 12: Factura Contingencia\n\n```json\n{\n \"type_document_id\": 12 // Contingencia Tipo 4\n}\n```\n\n**Códigos de tipo:**\n\n| Código | Descripción |\n|--------|-------------|\n| 1 | Factura electrónica normal |\n| **12** | **Factura contingencia Tipo 4** |\n| 15 | Documento equivalente POS |\n| 24 | Servicios públicos |\n\n**Crítico:** Usar `type_document_id: 12` **solo** en contingencia. No confundir con tipo 1.\n\n### 📌 3. Resolución DIAN Específica\n\n```json\n{\n \"resolution_number\": \"18760000001\",\n \"prefix\": \"SETP\"\n}\n```\n\n**Requisitos:**\n\n✓ Resolución DIAN específica para contingencia \n✓ Rango de numeración separado (ej: 994500001-994600000) \n✓ Prefijo único (SETP, CONT, EMRG, etc.) \n✓ Vigencia activa \n\n**Diferencia con factura normal:**\n\n```\nFactura Normal:\nResolución: 18760000001\nPrefijo: SETP\nRango: 1-1000000\n\nContingencia Tipo 4:\nResolución: 18760000002 (específica)\nPrefijo: SETP o CONT\nRango: 994500001-994600000 (alto)\n```\n\n### 📌 4. Consecutivo de Contingencia\n\n```json\n{\n \"number\": 994500032, // Consecutivo alto\n \"prefix\": \"SETP\"\n}\n```\n\n**Numeración contingencia:**\n\n- Rango separado (ej: 994500000-995000000)\n- NO se mezcla con consecutivos normales\n- Secuencial dentro del rango contingencia\n- Se agota antes que el rango normal\n\n**Ejemplo:**\n```\nFactura normal: SETP-1, SETP-2, SETP-3...\nContingencia: SETP-994500001, SETP-994500002...\n```\n\n### 📌 5. disable_confirmation_text: true\n\n```json\n{\n \"disable_confirmation_text\": true\n}\n```\n\n**Propósito:**\n- Deshabilita texto de confirmación en PDF\n- Útil en contingencia (documento no validado aún)\n- Evita confusión al cliente\n\n**PDF sin confirmación:**\n```\n┌────────────────────────────┐\n│ FACTURA CONTINGENCIA │\n│ Pendiente validación DIAN│\n└────────────────────────────┘\n\n(Sin texto \"Validado por DIAN\")\n```\n\n### 📌 6. Flujo: Emisión en Contingencia\n\n**Escenario:**\nTienda intenta emitir factura pero servicios DIAN caídos.\n\n**Paso 1: Detección de Falla**\n```javascript\ntry {\n // Intenta factura normal\n POST /api/ubl2.1/invoice\n} catch (error) {\n if (error.code === 'DIAN_TIMEOUT') {\n // Activar modo contingencia\n useContingency = true;\n }\n}\n```\n\n**Paso 2: Emisión Contingencia**\n```json\nPOST /api/ubl2.1/invoice-contingency-4\n{\n \"type_document_id\": 12,\n \"number\": 994500032,\n \"resolution_number\": \"18760000001\",\n \"customer\": {...},\n \"invoice_lines\": [...]\n}\n```\n\n**Respuesta:**\n```json\n{\n \"status\": \"pending_transmission\",\n \"cufe\": \"abc123...\",\n \"pdf_url\": \"/storage/pdf/SETP-994500032.pdf\",\n \"message\": \"Documento generado. Enviar a DIAN en 48h\"\n}\n```\n\n**Paso 3: Almacenamiento Local**\n```\nFactura guardada en BD con:\n- status: 'pending_transmission'\n- type_document_id: 12\n- transmission_deadline: 2025-06-05 04:08:12\n```\n\n**Paso 4: Envío Diferido (cuando DIAN vuelva)**\n```json\nPOST /api/ubl2.1/invoice-contingency-4/send_pendings\n// Sin body\n```\n\n**Paso 5: Validación DIAN**\n```json\n{\n \"status\": \"Processed\",\n \"cufe\": \"abc123...\",\n \"ApplicationResponse\": {\n \"ResponseCode\": \"00\",\n \"ResponseDescription\": \"Aprobado\"\n }\n}\n```\n\n### 📌 7. Plazo de 48 Horas\n\n**Normativa DIAN:**\n\n```\nFactura contingencia emitida: 2025-06-03 04:08:12\nPlazo máximo envío: 2025-06-05 04:08:12 (48 horas)\n\nSi NO se envía en 48h:\n❌ Factura inválida\n❌ Posible sanción DIAN\n❌ Cliente puede rechazar\n```\n\n**Monitoreo:**\n```sql\nSELECT * FROM invoices\nWHERE type_document_id = 12\nAND status = 'pending_transmission'\nAND transmission_deadline < NOW()\n-- Facturas vencidas sin enviar\n```\n\n### 📌 8. Cuándo Usar Contingencia Tipo 4\n\n**✓ Usar cuando:**\n- Servicios DIAN caídos (timeout, 500, 503)\n- Mantenimiento programado DIAN\n- Problemas red del emisor (temporal)\n- Saturación servidores DIAN (fin de mes)\n- Horario no hábil DIAN (emergencia)\n\n**✗ NO usar cuando:**\n- Conexión normal funciona\n- Error en datos de factura (422)\n- Certificado vencido (resolver primero)\n- Resolución expirada (obtener nueva)\n- Solo por conveniencia (no es modo offline voluntario)\n\n### 📌 9. Diferencias con POS Offline\n\n| Aspecto | POS Offline (dont_send_yet) | Contingencia Tipo 4 |\n|---------|----------------------------|---------------------|\n| **type_document_id** | 15 (POS) | 12 (Contingencia) |\n| **Motivo** | Conveniencia, batch | Falla DIAN |\n| **Plazo** | Sin plazo específico | 48 horas |\n| **Resolución** | Normal | Específica contingencia |\n| **Uso** | Voluntario | Solo en emergencia |\n| **Endpoint envío** | /eqdoc/send_pendings | /invoice-contingency-4/send_pendings |\n\n### 📌 10. Validaciones DIAN\n\n**DIAN valida al enviar (no al crear):**\n\n✓ `type_document_id: 12` correcto \n✓ Resolución contingencia válida y activa \n✓ Consecutivo dentro del rango autorizado \n✓ Fecha emisión dentro de 48h del envío \n✓ CUFE calculado correctamente \n✓ Totales correctos \n✓ Cliente con datos válidos \n✓ Certificado digital vigente al momento del envío \n\n### 📌 11. Errores Comunes\n\n| Error | Causa | Solución |\n|-------|-------|----------|\n| \"Invalid type_document_id\" | Usar tipo 1 en lugar de 12 | Usar `type_document_id: 12` |\n| \"Resolution not for contingency\" | Resolución normal en contingencia | Usar resolución específica contingencia |\n| \"Number out of range\" | Consecutivo fuera de rango | Verificar rango resolución contingencia |\n| \"Transmission deadline exceeded\" | Más de 48h desde emisión | Enviar dentro de 48 horas |\n| \"Contingency not justified\" | Usar sin falla DIAN | Solo usar cuando DIAN caída |\n| \"Invalid prefix\" | Prefijo no coincide con resolución | Verificar prefijo en resolución |\n\n### 📌 12. PDF: Lo que Cliente Ve\n\n```\n┌────────────────────────────────┐\n│ EMPRESA XYZ S.A.S. │\n│ FACTURA CONTINGENCIA TIPO 4 │\n│ SETP-994500032 │\n│ 2025-06-03 04:08:12 │\n└────────────────────────────────┘\n\n⚠️ FACTURA EN CONTINGENCIA\n Emitida sin conexión a DIAN\n Será validada en 48 horas\n\nCLIENTE:\nELIZABETH CARDONA VILLADA\nC.C. 41946692-6\n\nDETALLE:\n\nCOMISION POR SERVICIOS\nCantidad: 1\nPrecio: $1.000.000,00\nDescuento: -$50.000,00\nBase: $950.000,00\nIVA 19%: $180.500,00\n─────────────────────────────\n\n════════════════════════════════\nTOTAL A PAGAR: $1.130.500,00\n════════════════════════════════\n\n⚠️ IMPORTANTE:\nEsta factura fue emitida bajo\ncontingencia debido a problemas\ntécnicos temporales con los\nservicios de la DIAN.\n\nLa factura será transmitida a\nla DIAN dentro de las próximas\n48 horas y usted recibirá\nconfirmación de validación.\n\nEsta factura es VÁLIDA para\nefectos tributarios y contables.\n```\n\n### 📌 13. Monitoreo y Alertas\n\n**Sistema de alertas recomendado:**\n\n```javascript\n// Revisar cada hora\nsetInterval(async () => {\n const pending = await db.query(`\n SELECT * FROM invoices\n WHERE type_document_id = 12\n AND status = 'pending_transmission'\n AND transmission_deadline < DATE_ADD(NOW(), INTERVAL 6 HOUR)\n `);\n \n if (pending.length > 0) {\n alert(`${pending.length} facturas contingencia próximas a vencer`);\n // Intentar envío automático\n await sendPendingContingencies();\n }\n}, 3600000);\n```\n\n**Dashboard:**\n```\n┌─────────────────────────────────┐\n│ FACTURAS CONTINGENCIA │\n├─────────────────────────────────┤\n│ Pendientes envío: 23 │\n│ Plazo venciendo (6h): 5 │\n│ Vencidas: 0 │\n│ Última transmisión: hace 2h │\n└─────────────────────────────────┘\n```\n\n### 📌 14. Registro de Contingencias\n\n**Obligatorio mantener registro:**\n\n```json\n{\n \"contingency_log\": [\n {\n \"date\": \"2025-06-03 04:08:12\",\n \"reason\": \"Timeout DIAN - Servidores no responden\",\n \"invoices_affected\": 45,\n \"first_invoice\": \"SETP-994500001\",\n \"last_invoice\": \"SETP-994500045\",\n \"resolution_used\": \"18760000001\",\n \"transmission_date\": \"2025-06-03 14:30:00\",\n \"successful\": 43,\n \"rejected\": 2\n }\n ]\n}\n```\n\n### 📌 15. Resumen: Contingencia Tipo 4\n\n- **Propósito:** Facturar cuando DIAN caída temporalmente\n- **type_document_id:** 12 (Contingencia)\n- **Plazo:** 48 horas máximo desde emisión\n- **Resolución:** Específica para contingencia\n- **Consecutivo:** Rango alto separado (ej: 994500000+)\n- **Envío:** Diferido mediante send_pendings\n- **Uso:** Solo en falla técnica DIAN\n- **Validez:** Legal si se envía dentro de plazo\n- **Monitoreo:** Crítico alertas de vencimiento\n- **Registro:** Obligatorio mantener log de contingencias" }, "response": [] }, { "name": "Contingencia Tipo 4 - Enviar Pendientes", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "7692a20fec92af0aa5729d796b019d27c83c9955407994630a0cdd7702ca2329", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "http://apidian2026-6.oo/api/ubl2.1/invoice-contingency-4/send_pendings", "protocol": "http", "host": [ "apidian2026-6", "oo" ], "path": [ "api", "ubl2.1", "invoice-contingency-4", "send_pendings" ] }, "description": "# 📤 ENVIAR FACTURAS CONTINGENCIA TIPO 4 PENDIENTES\n\n## 📄 Descripción General\n\nEndpoint especializado para **transmitir a DIAN** todas las facturas de contingencia Tipo 4 (`type_document_id: 12`) que fueron generadas localmente durante una falla de servicios. Este endpoint es crítico porque las facturas de contingencia **deben enviarse dentro de las 48 horas** desde su emisión para mantener su validez legal.\n\n**Características clave:**\n- **Sin body requerido**: Endpoint sin parámetros JSON\n- **Procesamiento automático**: Busca todas las contingencias pendientes\n- **Plazo crítico**: 48 horas desde emisión\n- **Envío secuencial**: Transmite cada factura una por una\n- **Validación DIAN**: Cada factura se valida individualmente\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/invoice-contingency-4/send_pendings\n```\n\n**Características:**\n- **Método:** POST\n- **Body:** Vacío (sin JSON)\n- **Autenticación:** Bearer token (obligatorio)\n- **Timeout:** 180 segundos (mayor que POS por validaciones extras)\n- **Rate limit:** 30 documentos por minuto (más estricto)\n\n---\n\n## 🔑 Estructura del Request\n\n### Headers\n\n| Header | Valor | Obligatorio |\n|--------|-------|-------------|\n| **Authorization** | Bearer {token} | ✓ Sí |\n| **Content-Type** | application/json | ✓ Sí |\n| **Accept** | application/json | ✓ Sí |\n\n### Body\n\n```json\n\"\" // Vacío, sin parámetros\n```\n\n**El endpoint automáticamente:**\n1. Identifica el usuario por el `api_token`\n2. Busca todas las facturas con `type_document_id: 12` y `status: 'pending_transmission'`\n3. Filtra por plazo: solo envía las que tienen menos de 48 horas\n4. Procesa en orden cronológico (FIFO)\n\n---\n\n## 📦 Estructura de la Respuesta\n\n### Respuesta Exitosa (200 OK)\n\n```json\n[\n {\n \"id\": 54321,\n \"number\": \"SETP-994500032\",\n \"type_document_id\": 12,\n \"cufe\": \"abc123...def789\",\n \"status\": \"Processed\",\n \"emission_date\": \"2025-06-03 04:08:12\",\n \"transmission_date\": \"2025-06-03 14:30:00\",\n \"hours_elapsed\": 10.36,\n \"pdf_url\": \"https://api.com/storage/pdf/SETP-994500032.pdf\",\n \"xml_url\": \"https://api.com/storage/xml/SETP-994500032.xml\",\n \"ApplicationResponse\": {\n \"ResponseCode\": \"00\",\n \"ResponseDescription\": \"Documento validado exitosamente\"\n }\n },\n {\n \"id\": 54322,\n \"number\": \"SETP-994500033\",\n \"type_document_id\": 12,\n \"cufe\": \"xyz456...uvw123\",\n \"status\": \"Rejected\",\n \"emission_date\": \"2025-06-03 05:15:00\",\n \"transmission_date\": \"2025-06-03 14:30:05\",\n \"hours_elapsed\": 9.25,\n \"ApplicationResponse\": {\n \"ResponseCode\": \"02\",\n \"ResponseDescription\": \"Total no coincide - verificar cálculo\"\n }\n }\n]\n```\n\n### Campos de la Respuesta\n\n| Campo | Tipo | Descripción |\n|-------|------|-------------|\n| **id** | integer | ID interno del documento |\n| **number** | string | Número consecutivo (SETP-XXXXXX) |\n| **type_document_id** | integer | 12 (Contingencia) |\n| **status** | string | Processed, Rejected, o Validating |\n| **emission_date** | datetime | Fecha/hora emisión original |\n| **transmission_date** | datetime | Fecha/hora envío a DIAN |\n| **hours_elapsed** | float | Horas transcurridas (max 48) |\n\n---\n\n## 📝 Notas Críticas sobre send_pendings Contingencia\n\n### 📌 1. Diferencia con send_pendings POS\n\n| Aspecto | POS send_pendings | Contingencia send_pendings |\n|---------|-------------------|----------------------------|\n| **Endpoint** | /eqdoc/send_pendings | **/invoice-contingency-4/send_pendings** |\n| **type_document_id** | 15 (POS) | **12 (Contingencia)** |\n| **Plazo** | Sin límite estricto | **48 horas obligatorio** |\n| **Motivo** | Conveniencia (offline voluntario) | **Emergencia (falla DIAN)** |\n| **Validaciones DIAN** | Estándar | **Más estrictas (contingencia)** |\n| **Timeout** | 120 seg | **180 seg** |\n| **Rate limit** | 50 docs/min | **30 docs/min** |\n\n### 📌 2. Filtrado Automático por Plazo 48h\n\n**El endpoint solo envía facturas dentro del plazo:**\n\n```sql\nSELECT * FROM invoices\nWHERE type_document_id = 12\nAND status = 'pending_transmission'\nAND emission_date >= DATE_SUB(NOW(), INTERVAL 48 HOUR)\nORDER BY emission_date ASC\n```\n\n**Facturas excluidas (vencidas):**\n```sql\nSELECT * FROM invoices\nWHERE type_document_id = 12\nAND status = 'pending_transmission'\nAND emission_date < DATE_SUB(NOW(), INTERVAL 48 HOUR)\n-- Estas NO se envían (plazo vencido)\n```\n\n**Acción recomendada para vencidas:**\n```javascript\nconst expired = await getExpiredContingencies();\nif (expired.length > 0) {\n // Anular facturas vencidas\n await markAsExpired(expired);\n // Generar nuevas facturas normales\n await reissueAsNormalInvoices(expired);\n}\n```\n\n### 📌 3. Flujo: Recuperación de Servicios\n\n**Escenario:**\nDIAN estuvo caída 6 horas. Se generaron 50 facturas contingencia.\n\n**Paso 1: Detección Servicios Activos**\n```javascript\n// Monitoreo cada 10 minutos\nsetInterval(async () => {\n const dianStatus = await checkDIAN();\n if (dianStatus.available) {\n console.log('DIAN disponible - iniciando transmisión');\n await sendPendingContingencies();\n }\n}, 600000);\n```\n\n**Paso 2: Listar Pendientes**\n```javascript\nconst pending = await db.query(`\n SELECT COUNT(*) as total,\n MIN(emission_date) as oldest,\n MAX(emission_date) as newest\n FROM invoices\n WHERE type_document_id = 12\n AND status = 'pending_transmission'\n`);\n\nconsole.log(`${pending.total} facturas pendientes`);\nconsole.log(`Más antigua: ${pending.oldest}`);\n// Si oldest > 48h atrás: ¡ALERTA CRÍTICA!\n```\n\n**Paso 3: Invocar send_pendings**\n```bash\ncurl -X POST https://api.com/api/ubl2.1/invoice-contingency-4/send_pendings \\\n -H \"Authorization: Bearer {token}\" \\\n -H \"Content-Type: application/json\"\n```\n\n**Paso 4: Procesar Respuesta**\n```javascript\nconst results = await sendPendings();\n\nconst processed = results.filter(r => r.status === 'Processed');\nconst rejected = results.filter(r => r.status === 'Rejected');\nconst validating = results.filter(r => r.status === 'Validating');\n\nconsole.log(`✓ Procesadas: ${processed.length}`);\nconsole.log(`✗ Rechazadas: ${rejected.length}`);\nconsole.log(`⏳ Validando: ${validating.length}`);\n\nif (rejected.length > 0) {\n // Revisar y corregir rechazadas\n await handleRejections(rejected);\n}\n```\n\n**Paso 5: Actualizar PDFs**\n```javascript\n// PDFs originales tenían aviso \"Pendiente validación\"\n// Regenerar PDFs con sello DIAN\nprocessed.forEach(async (invoice) => {\n await regeneratePDF(invoice.id);\n await emailCustomer(invoice.customer_email, invoice.pdf_url);\n});\n```\n\n### 📌 4. Validaciones DIAN Específicas\n\n**DIAN valida en contingencia:**\n\n✓ Plazo 48 horas no excedido \n✓ Resolución contingencia válida \n✓ Consecutivo dentro del rango contingencia \n✓ CUFE calculado correctamente \n✓ Certificado digital vigente **al momento del envío** \n✓ Totales correctos \n✓ Cliente con datos válidos \n✓ No duplicidad (mismo número no enviado antes) \n✓ **Justificación de contingencia** (logs de falla) \n\n**Validación especial:**\n```json\n{\n \"contingency_reason\": \"DIAN timeout 2025-06-03 04:00:00\",\n \"logs_attached\": true\n}\n```\n\n### 📌 5. Manejo de Errores Parciales\n\n**Escenario: 50 facturas, 3 rechazadas**\n\n```json\n[\n {\"number\": \"SETP-994500001\", \"status\": \"Processed\"}, // ✓\n {\"number\": \"SETP-994500002\", \"status\": \"Processed\"}, // ✓\n ...\n {\"number\": \"SETP-994500015\", \"status\": \"Rejected\", // ✗\n \"ApplicationResponse\": {\n \"ResponseCode\": \"02\",\n \"ResponseDescription\": \"IVA mal calculado\"\n }},\n {\"number\": \"SETP-994500016\", \"status\": \"Processed\"}, // ✓\n ...\n {\"number\": \"SETP-994500050\", \"status\": \"Processed\"} // ✓\n]\n```\n\n**Comportamiento:**\n- Proceso NO se detiene si una factura falla\n- Continúa con las siguientes\n- HTTP 200 OK (no 422, porque endpoint funcionó)\n- Desarrollador debe revisar array de resultados\n\n**Acción para rechazadas:**\n```javascript\nconst rejected = results.filter(r => r.status === 'Rejected');\n\nfor (const invoice of rejected) {\n // Opción 1: Corregir y reenviar como contingencia\n await correctInvoice(invoice.id);\n await resendContingency(invoice.id);\n \n // Opción 2: Anular y generar nueva factura normal\n await voidContingency(invoice.id);\n await issueNormalInvoice(invoice.customer_id, invoice.items);\n}\n```\n\n### 📌 6. Monitoreo de Plazo Crítico\n\n**Dashboard en tiempo real:**\n\n```javascript\nconst getContingencyStatus = async () => {\n const pending = await db.query(`\n SELECT \n COUNT(*) as total,\n SUM(CASE WHEN TIMESTAMPDIFF(HOUR, emission_date, NOW()) > 42 THEN 1 ELSE 0 END) as critical,\n SUM(CASE WHEN TIMESTAMPDIFF(HOUR, emission_date, NOW()) > 36 THEN 1 ELSE 0 END) as warning,\n SUM(CASE WHEN TIMESTAMPDIFF(HOUR, emission_date, NOW()) > 48 THEN 1 ELSE 0 END) as expired\n FROM invoices\n WHERE type_document_id = 12\n AND status = 'pending_transmission'\n `);\n \n return {\n total: pending.total,\n critical: pending.critical, // > 42h (quedan 6h)\n warning: pending.warning, // > 36h (quedan 12h)\n expired: pending.expired // > 48h (VENCIDAS)\n };\n};\n```\n\n**Alertas automáticas:**\n```javascript\nif (status.critical > 0) {\n sendAlert('CRÍTICO', `${status.critical} facturas vencen en 6h`);\n}\nif (status.warning > 0) {\n sendAlert('ADVERTENCIA', `${status.warning} facturas vencen en 12h`);\n}\nif (status.expired > 0) {\n sendAlert('URGENTE', `${status.expired} facturas VENCIDAS`);\n}\n```\n\n### 📌 7. Reintentos Automáticos\n\n**Sistema de reintentos:**\n\n```javascript\nconst sendWithRetry = async (maxRetries = 3) => {\n for (let attempt = 1; attempt <= maxRetries; attempt++) {\n try {\n const results = await sendPendings();\n console.log(`Intento ${attempt}: Éxito`);\n return results;\n } catch (error) {\n if (attempt === maxRetries) {\n throw error;\n }\n const delay = attempt * 60000; // 1min, 2min, 3min\n console.log(`Intento ${attempt} falló. Reintentando en ${delay/1000}s`);\n await sleep(delay);\n }\n }\n};\n```\n\n**Estrategia escalonada:**\n```\nIntento 1: Inmediato\nIntento 2: Espera 5 minutos\nIntento 3: Espera 15 minutos\nIntento 4: Espera 30 minutos\nIntento 5: Espera 1 hora\n```\n\n### 📌 8. Logs de Transmisión\n\n**Registro detallado:**\n\n```json\n{\n \"transmission_log\": {\n \"timestamp\": \"2025-06-03 14:30:00\",\n \"trigger\": \"automatic\", // o \"manual\"\n \"user_id\": 123,\n \"invoices_pending\": 50,\n \"invoices_sent\": 50,\n \"successful\": 47,\n \"rejected\": 3,\n \"duration_seconds\": 185,\n \"dian_response_time_avg\": 3.7,\n \"failed_invoices\": [\n {\n \"number\": \"SETP-994500015\",\n \"error\": \"IVA mal calculado\",\n \"code\": \"02\"\n },\n {\n \"number\": \"SETP-994500032\",\n \"error\": \"Cliente NIT inválido\",\n \"code\": \"04\"\n },\n {\n \"number\": \"SETP-994500048\",\n \"error\": \"Total no coincide\",\n \"code\": \"02\"\n }\n ]\n }\n}\n```\n\n### 📌 9. Comparativa: Endpoints de Envío Diferido\n\n| Aspecto | POS send_pendings | Contingencia send_pendings |\n|---------|-------------------|----------------------------|\n| **Endpoint** | /eqdoc/send_pendings | /invoice-contingency-4/send_pendings |\n| **Tipo doc** | 15 (POS) | 12 (Contingencia) |\n| **Uso** | Voluntario (batch) | Obligatorio (emergencia) |\n| **Plazo** | Sin plazo | 48 horas |\n| **Validación** | Estándar | Estricta + justificación |\n| **Frecuencia** | Bajo demanda | Urgente (ASAP) |\n| **Monitoreo** | Recomendado | **Crítico** |\n\n### 📌 10. Errores Comunes\n\n| Error | Causa | Solución |\n|-------|-------|----------|\n| \"No pending contingencies\" | No hay facturas tipo 12 pendientes | Normal si ya se enviaron todas |\n| \"Deadline exceeded\" | Factura > 48h | Anular y reemitir como factura normal |\n| \"Authentication failed\" | Token inválido | Renovar bearer token |\n| \"Certificate expired\" | Certificado vencido al momento envío | Renovar certificado antes de enviar |\n| \"Resolution inactive\" | Resolución contingencia expirada | Obtener nueva resolución |\n| \"Timeout\" | Muchas facturas (>40) | Enviar en lotes de 20-30 |\n\n### 📌 11. Testing de Contingencia\n\n**Flujo de prueba completo:**\n\n```javascript\n// 1. Simular falla DIAN (en desarrollo)\nconst mockDIANFailure = true;\n\n// 2. Generar facturas contingencia\nfor (let i = 1; i <= 10; i++) {\n await createContingencyInvoice({\n number: 994500000 + i,\n type_document_id: 12,\n customer: testCustomer,\n items: testItems\n });\n}\n\n// 3. Verificar estado pendiente\nconst pending = await countPendingContingencies();\nconsole.log(`${pending} facturas contingencia pendientes`);\n\n// 4. Simular recuperación DIAN\nconst mockDIANFailure = false;\n\n// 5. Enviar pendientes\nconst results = await sendPendingContingencies();\n\n// 6. Validar resultados\nconst allProcessed = results.every(r => r.status === 'Processed');\nassert(allProcessed, 'Todas las facturas deben procesarse');\n\n// 7. Verificar que no quedan pendientes\nconst remaining = await countPendingContingencies();\nassert(remaining === 0, 'No deben quedar facturas pendientes');\n```\n\n### 📌 12. Notificaciones a Clientes\n\n**Después de envío exitoso:**\n\n```javascript\nprocessed.forEach(async (invoice) => {\n await sendEmail({\n to: invoice.customer_email,\n subject: 'Factura contingencia validada por DIAN',\n body: `\n Estimado cliente,\n \n Su factura ${invoice.number} emitida en contingencia\n ha sido validada exitosamente por la DIAN.\n \n Fecha emisión: ${invoice.emission_date}\n Fecha validación: ${invoice.transmission_date}\n \n Puede descargar su factura actualizada en:\n ${invoice.pdf_url}\n \n Gracias.\n `\n });\n});\n```\n\n### 📌 13. Auditoría y Cumplimiento\n\n**Registro para auditoría DIAN:**\n\n```json\n{\n \"contingency_event\": {\n \"date_start\": \"2025-06-03 04:00:00\",\n \"date_end\": \"2025-06-03 14:30:00\",\n \"duration_hours\": 10.5,\n \"reason\": \"Caída servidores DIAN - Timeout en todas las peticiones\",\n \"evidence\": [\n \"logs/dian_errors_2025-06-03.log\",\n \"monitoring/dian_status_2025-06-03.csv\"\n ],\n \"invoices_affected\": 50,\n \"first_invoice\": \"SETP-994500001\",\n \"last_invoice\": \"SETP-994500050\",\n \"transmission_date\": \"2025-06-03 14:30:00\",\n \"successful_transmissions\": 47,\n \"rejected_transmissions\": 3,\n \"compliance_status\": \"All invoices sent within 48h deadline\"\n }\n}\n```\n\n### 📌 14. Performance y Optimización\n\n**Para lotes grandes (>50 facturas):**\n\n```javascript\nconst sendInBatches = async (batchSize = 30) => {\n const pending = await getPendingContingencies();\n const batches = chunkArray(pending, batchSize);\n \n for (let i = 0; i < batches.length; i++) {\n console.log(`Enviando lote ${i+1}/${batches.length}`);\n const results = await sendPendings();\n \n // Esperar entre lotes para no saturar\n if (i < batches.length - 1) {\n await sleep(30000); // 30 segundos\n }\n }\n};\n```\n\n### 📌 15. Resumen: send_pendings Contingencia\n\n- **Propósito:** Enviar facturas contingencia tipo 4 a DIAN\n- **Endpoint:** /invoice-contingency-4/send_pendings\n- **Body:** Vacío (automático)\n- **Plazo:** 48 horas máximo (crítico)\n- **Filtrado:** Solo envía facturas dentro del plazo\n- **Procesamiento:** Secuencial, una por una\n- **Monitoreo:** Crítico - alertas de vencimiento\n- **Reintentos:** Automáticos con backoff exponencial\n- **Errores:** No detienen proceso, continúa con siguientes\n- **Notificaciones:** Email a clientes tras validación\n- **Auditoría:** Registro completo obligatorio" }, "response": [] }, { "name": "Paso 14 - Config-Type 4 Contingency Resolution", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "7692a20fec92af0aa5729d796b019d27c83c9955407994630a0cdd7702ca2329", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "accept", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"type_document_id\": 12,\r\n\t\"prefix\": \"SETP\",\r\n\t\"resolution\": \"18760000001\",\r\n\t\"resolution_date\": \"2019-01-19\",\r\n\t\"technical_key\": \"fc8eac422eba16e22ffd8c6f94b3f40a6e38162c\",\r\n\t\"from\": 990000000,\r\n\t\"to\": 995000000,\r\n\t\"generated_to_date\": 0,\r\n\t\"date_from\": \"2019-01-19\",\r\n\t\"date_to\": \"2030-01-19\"\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/config/resolution", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "config", "resolution" ] }, "description": "# ⚙️ CONFIGURAR RESOLUCIÓN CONTINGENCIA TIPO 4\n\n## 📄 Descripción General\n\nEste endpoint permite **configurar una resolución específica para Facturas de Contingencia Tipo 4** en el sistema. Antes de poder emitir facturas en modo contingencia, es **obligatorio** registrar una resolución DIAN con rango de numeración exclusivo para este tipo de documentos.\n\n**Características clave:**\n- **Tipo:** Configuración de resolución contingencia\n- **type_document_id:** 12 (Contingencia Tipo 4)\n- **Rango exclusivo:** Separado de facturas normales\n- **Requisito previo:** Obligatorio antes de emitir contingencias\n- **Vigencia:** date_from hasta date_to (ej: 2019-2030)\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPUT {{url}}/api/ubl2.1/config/resolution\n```\n\n**Características:**\n- **Método:** PUT (actualiza/crea configuración)\n- **Autenticación:** Bearer token (obligatorio)\n- **Propósito:** Registrar resolución contingencia en sistema\n- **Frecuencia:** Una vez (o cuando cambie resolución)\n\n---\n\n## 🔑 Campos de Configuración\n\n### Resolución Contingencia\n\n| Campo | Valor | Descripción |\n|-------|-------|-------------|\n| **type_document_id** | **12** | **Contingencia Tipo 4** |\n| **prefix** | SETP | Prefijo autorizado |\n| **resolution** | 18760000001 | Número resolución DIAN |\n| **resolution_date** | 2019-01-19 | Fecha resolución |\n| **technical_key** | fc8eac42... | Clave técnica DIAN |\n| **from** | 990000000 | Consecutivo inicial |\n| **to** | 995000000 | Consecutivo final |\n| **generated_to_date** | 0 | Contador actual (inicia en 0) |\n| **date_from** | 2019-01-19 | Vigencia desde |\n| **date_to** | 2030-01-19 | Vigencia hasta |\n\n### Body Completo\n\n```json\n{\n \"type_document_id\": 12,\n \"prefix\": \"SETP\",\n \"resolution\": \"18760000001\",\n \"resolution_date\": \"2019-01-19\",\n \"technical_key\": \"fc8eac422eba16e22ffd8c6f94b3f40a6e38162c\",\n \"from\": 990000000,\n \"to\": 995000000,\n \"generated_to_date\": 0,\n \"date_from\": \"2019-01-19\",\n \"date_to\": \"2030-01-19\"\n}\n```\n\n---\n\n## 📝 Notas Críticas sobre Configuración Contingencia\n\n### 📌 1. Resolución Separada: Normal vs Contingencia\n\n**Configuración Dual Obligatoria:**\n\n```json\n// Resolución 1: Facturas Normales (tipo 1)\n{\n \"type_document_id\": 1,\n \"prefix\": \"SETP\",\n \"resolution\": \"18760000001\",\n \"from\": 1,\n \"to\": 10000000\n}\n\n// Resolución 2: Contingencia (tipo 12)\n{\n \"type_document_id\": 12,\n \"prefix\": \"SETP\",\n \"resolution\": \"18760000002\", // Diferente\n \"from\": 990000000, // Rango alto\n \"to\": 995000000\n}\n```\n\n**Crítico:** NO usar la misma resolución/rango para tipo 1 y tipo 12.\n\n### 📌 2. Rango de Numeración Alto\n\n**Estrategia de rangos:**\n\n```\nFactura Normal (tipo 1):\nfrom: 1\nto: 10.000.000\nEjemplo: SETP-1, SETP-2, SETP-3...\n\nContingencia (tipo 12):\nfrom: 990.000.000\nto: 995.000.000\nEjemplo: SETP-990000001, SETP-990000002...\n```\n\n**Beneficios:**\n- ✓ Diferenciación visual inmediata\n- ✓ No se mezclan consecutivos\n- ✓ Auditoría más fácil\n- ✓ Reportes separados\n\n**Capacidad:**\n```\nRango: 990.000.000 - 995.000.000\nCapacidad: 5.000.000 facturas contingencia\n```\n\n### 📌 3. technical_key: Clave Técnica DIAN\n\n```json\n{\n \"technical_key\": \"fc8eac422eba16e22ffd8c6f94b3f40a6e38162c\"\n}\n```\n\n**Ambientes:**\n\n| Ambiente | Clave Técnica | Uso |\n|----------|---------------|-----|\n| **Habilitación** | fc8eac422eba16e22ffd8c6f94b3f40a6e38162c | **Testing (fija)** |\n| **Producción** | Variable por empresa | Obtener con getnumberingrange |\n\n**Obtener clave producción:**\n```bash\n# Endpoint DIAN\nGET https://vpfe.dian.gov.co/WcfDianCustomerServices.svc/getnumberingrange\n\n# Respuesta incluye:\n{\n \"technical_key\": \"a1b2c3d4e5f6...\"\n}\n```\n\n### 📌 4. generated_to_date: Contador de Uso\n\n```json\n{\n \"generated_to_date\": 0 // Inicia en 0\n}\n```\n\n**Funcionamiento:**\n```\nConfiguración inicial:\ngenerated_to_date: 0\n\nPrimera factura contingencia:\nnumber: 990000000 + 0 + 1 = 990000001\ngenerated_to_date: 1\n\nSegunda factura:\nnumber: 990000000 + 1 + 1 = 990000002\ngenerated_to_date: 2\n\n...después de 50 facturas:\ngenerated_to_date: 50\nPróxima factura: 990000051\n```\n\n**Monitoreo:**\n```sql\nSELECT \n type_document_id,\n prefix,\n generated_to_date,\n (to - from) as capacity,\n ((generated_to_date / (to - from)) * 100) as percent_used\nFROM resolutions\nWHERE type_document_id = 12;\n\n-- Si percent_used > 80%: ALERTA (solicitar nueva resolución)\n```\n\n### 📌 5. Vigencia de Resolución\n\n```json\n{\n \"date_from\": \"2019-01-19\",\n \"date_to\": \"2030-01-19\" // 11 años vigencia\n}\n```\n\n**Validación sistema:**\n```javascript\nconst isResolutionValid = (resolution) => {\n const now = new Date();\n const dateFrom = new Date(resolution.date_from);\n const dateTo = new Date(resolution.date_to);\n \n if (now < dateFrom) {\n return { valid: false, reason: 'Resolución aún no vigente' };\n }\n if (now > dateTo) {\n return { valid: false, reason: 'Resolución expirada' };\n }\n return { valid: true };\n};\n```\n\n**Alerta de vencimiento:**\n```javascript\nconst daysUntilExpiry = (dateTo) => {\n const now = new Date();\n const expiry = new Date(dateTo);\n const diff = expiry - now;\n return Math.floor(diff / (1000 * 60 * 60 * 24));\n};\n\nif (daysUntilExpiry(resolution.date_to) < 180) {\n alert('Resolución contingencia vence en 6 meses');\n}\n```\n\n### 📌 6. Prefijo: Estrategias de Identificación\n\n**Opción 1: Prefijo Común**\n```json\n// Factura normal\n{\"prefix\": \"SETP\"}\n\n// Contingencia (mismo prefijo)\n{\"prefix\": \"SETP\"}\n\n// Resultado:\n// SETP-1, SETP-2 (normales)\n// SETP-990000001, SETP-990000002 (contingencia)\n// Diferenciación por rango numérico\n```\n\n**Opción 2: Prefijo Específico**\n```json\n// Factura normal\n{\"prefix\": \"SETP\"}\n\n// Contingencia (prefijo diferente)\n{\"prefix\": \"CONT\"}\n\n// Resultado:\n// SETP-1, SETP-2 (normales)\n// CONT-990000001, CONT-990000002 (contingencia)\n// Diferenciación visual inmediata\n```\n\n**Recomendación:** Opción 2 (prefijo específico) para claridad.\n\n### 📌 7. Flujo: Configuración Inicial\n\n**Paso 1: Obtener Resolución DIAN**\n```\n1. Solicitar a DIAN resolución para contingencia\n2. DIAN entrega documento 1876 con:\n - Número resolución\n - Prefijo autorizado\n - Rango (from-to)\n - Fechas vigencia\n```\n\n**Paso 2: Obtener Clave Técnica**\n```bash\n# Producción: Consultar endpoint DIAN\nGET getnumberingrange\n\n# Habilitación: Usar clave fija\nfc8eac422eba16e22ffd8c6f94b3f40a6e38162c\n```\n\n**Paso 3: Configurar en API**\n```json\nPUT /api/ubl2.1/config/resolution\n{\n \"type_document_id\": 12,\n \"resolution\": \"18760000002\",\n \"from\": 990000000,\n \"to\": 995000000,\n // ... demás campos\n}\n```\n\n**Paso 4: Verificar Configuración**\n```bash\nGET /api/ubl2.1/config/resolutions\n# Debe listar resolución tipo 12\n```\n\n**Paso 5: Probar Emisión**\n```json\nPOST /api/ubl2.1/invoice-contingency-4\n{\n \"type_document_id\": 12,\n \"number\": 990000001,\n // ... demás campos\n}\n# Debe generar factura exitosamente\n```\n\n### 📌 8. Validaciones del Sistema\n\n**Al configurar resolución, sistema valida:**\n\n✓ `type_document_id` válido (1, 12, 15, etc.) \n✓ `from` < `to` (rango válido) \n✓ `date_from` < `date_to` (vigencia válida) \n✓ `technical_key` formato correcto (40 caracteres hex) \n✓ `resolution` único por type_document_id \n✓ `prefix` no vacío \n✓ No solapamiento de rangos con otras resoluciones \n\n**Validaciones adicionales tipo 12:**\n```javascript\nif (config.type_document_id === 12) {\n // Rango debe ser alto (para distinguir)\n if (config.from < 900000000) {\n throw new Error('Rango contingencia debe iniciar en 900M+');\n }\n \n // Capacidad mínima recomendada\n const capacity = config.to - config.from;\n if (capacity < 1000000) {\n console.warn('Capacidad contingencia < 1M facturas');\n }\n}\n```\n\n### 📌 9. Errores Comunes\n\n| Error | Causa | Solución |\n|-------|-------|----------|\n| \"Resolution already exists\" | Ya hay resolución tipo 12 | Actualizar existente o eliminar primero |\n| \"Invalid range\" | from > to | Verificar orden: from < to |\n| \"Range overlap\" | Rango se cruza con otra resolución | Usar rango más alto (990M+) |\n| \"Invalid technical_key\" | Clave incorrecta | Usar fc8eac42... (habilitación) |\n| \"Date range invalid\" | date_from > date_to | Corregir fechas |\n| \"Expired resolution\" | date_to < hoy | Solicitar nueva resolución DIAN |\n\n### 📌 10. Múltiples Resoluciones\n\n**Escenario: Empresa con varias resoluciones**\n\n```json\n// Resolución 1: Facturas normales\n{\n \"type_document_id\": 1,\n \"prefix\": \"SETP\",\n \"from\": 1,\n \"to\": 10000000\n}\n\n// Resolución 2: POS\n{\n \"type_document_id\": 15,\n \"prefix\": \"EPOS\",\n \"from\": 1,\n \"to\": 5000000\n}\n\n// Resolución 3: Contingencia\n{\n \"type_document_id\": 12,\n \"prefix\": \"CONT\",\n \"from\": 990000000,\n \"to\": 995000000\n}\n\n// Resolución 4: Servicios Públicos\n{\n \"type_document_id\": 24,\n \"prefix\": \"SSP\",\n \"from\": 1,\n \"to\": 1000000\n}\n```\n\n### 📌 11. Actualización de Resolución\n\n**Cuándo actualizar:**\n- Cambio de rango (ampliación)\n- Nueva resolución DIAN\n- Renovación por vencimiento\n- Cambio de prefijo\n\n**Método:**\n```json\nPUT /api/ubl2.1/config/resolution\n{\n \"type_document_id\": 12,\n \"resolution\": \"18760000003\", // Nueva resolución\n \"from\": 995000000, // Nuevo rango\n \"to\": 999000000,\n \"date_from\": \"2030-01-20\", // Nueva vigencia\n \"date_to\": \"2040-01-20\"\n}\n```\n\n**Crítico:** No actualizar resolución en uso activo. Esperar a que termine.\n\n### 📌 12. Testing de Configuración\n\n**Pruebas recomendadas:**\n\n```javascript\n// 1. Configurar resolución\nconst config = await configureResolution({\n type_document_id: 12,\n from: 990000000,\n to: 995000000,\n // ...\n});\n\n// 2. Verificar guardado\nconst resolutions = await getResolutions();\nconst contingency = resolutions.find(r => r.type_document_id === 12);\nassert(contingency !== undefined, 'Resolución contingencia debe existir');\n\n// 3. Probar consecutivo\nconst invoice = await createContingencyInvoice();\nassert(invoice.number === 990000001, 'Primer consecutivo debe ser 990000001');\n\n// 4. Verificar incremento\nconst invoice2 = await createContingencyInvoice();\nassert(invoice2.number === 990000002, 'Segundo consecutivo debe ser 990000002');\n\n// 5. Validar límite\nconst resolution = await getResolution(12);\nassert(resolution.generated_to_date === 2, 'Contador debe ser 2');\n```\n\n### 📌 13. Documento 1876 DIAN\n\n**Información en documento DIAN:**\n\n```\n╔════════════════════════════════════════════╗\n║ DIAN - DOCUMENTO 1876 ║\n║ RESOLUCIÓN DE FACTURACIÓN ELECTRÓNICA ║\n╠════════════════════════════════════════════╣\n║ Número Resolución: 18760000002 ║\n║ Fecha: 2019-01-19 ║\n║ NIT Empresa: 900123456-7 ║\n║ Razón Social: EMPRESA XYZ S.A.S. ║\n╠════════════════════════════════════════════╣\n║ TIPO DOCUMENTO: Contingencia Tipo 4 ║\n║ Prefijo Autorizado: CONT ║\n║ Rango Numeración: ║\n║ Desde: 990.000.000 ║\n║ Hasta: 995.000.000 ║\n║ Vigencia: ║\n║ Desde: 2019-01-19 ║\n║ Hasta: 2030-01-19 ║\n╠════════════════════════════════════════════╣\n║ Clave Técnica: ║\n║ (Consultar en portal DIAN) ║\n╚════════════════════════════════════════════╝\n```\n\n### 📌 14. Monitoreo de Uso\n\n**Dashboard de resoluciones:**\n\n```javascript\nconst getResolutionStats = async () => {\n const resolution = await db.query(`\n SELECT \n type_document_id,\n prefix,\n \\`from\\`,\n \\`to\\`,\n generated_to_date,\n (\\`to\\` - \\`from\\`) as capacity,\n ((generated_to_date / (\\`to\\` - \\`from\\`)) * 100) as percent_used,\n date_to,\n DATEDIFF(date_to, NOW()) as days_until_expiry\n FROM resolutions\n WHERE type_document_id = 12\n `);\n \n return {\n used: resolution.generated_to_date,\n capacity: resolution.capacity,\n percent: resolution.percent_used,\n remaining: resolution.capacity - resolution.generated_to_date,\n days_valid: resolution.days_until_expiry\n };\n};\n\n// Alertas\nif (stats.percent > 80) {\n alert('Resolución contingencia al 80% - solicitar ampliación');\n}\nif (stats.days_valid < 180) {\n alert('Resolución contingencia vence en 6 meses - renovar');\n}\n```\n\n### 📌 15. Resumen: Configuración Contingencia\n\n- **Propósito:** Registrar resolución DIAN para contingencias\n- **Endpoint:** PUT /api/ubl2.1/config/resolution\n- **type_document_id:** 12 (Contingencia Tipo 4)\n- **Rango:** Alto (990M+) separado de facturas normales\n- **technical_key:** fc8eac42... (habilitación), variable (producción)\n- **Vigencia:** date_from hasta date_to (11 años típico)\n- **Contador:** generated_to_date inicia en 0\n- **Requisito:** Obligatorio antes de emitir contingencias\n- **Monitoreo:** Uso (%) y vencimiento (días)\n- **Actualización:** Solo cuando termine resolución actual" }, "response": [] } ] } ], "description": "Aqui se encuentran los envios mas sencillos de documentos electronicos, por medio de estos podra realizar\r\nlas primeras pruebas con la DIAN", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "7692a20fec92af0aa5729d796b019d27c83c9955407994630a0cdd7702ca2329", "type": "string" } ] }, "event": [ { "listen": "prerequest", "script": { "type": "text/javascript", "exec": [ "" ] } }, { "listen": "test", "script": { "type": "text/javascript", "exec": [ "" ] } } ] }, { "name": "03 - Consultas de Estado", "item": [ { "name": "Paso 1 - GetStatus-zip Factura", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n\t\"sendmail\": false,\n \"sendmailtome\": false,\n \"is_payroll\": false,\n \"is_eqdoc\": false\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/status/zip/8aed1b48-1e89-4e8c-a631-97833974aa8a", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "status", "zip", "8aed1b48-1e89-4e8c-a631-97833974aa8a" ] }, "description": "# 🔍 CONSULTA DE ESTADO DE FACTURA ELECTRÓNICA POR ZIP_KEY\n\nEndpoint para verificar el resultado de la validación DIAN de facturas electrónicas enviadas en modo asíncrono. Utiliza el `zip_key` (UUID) retornado al enviar el documento para consultar si fue aceptado o rechazado por la DIAN.\n\n## 🔗 URL\n**POST** `/api/ubl2.1/status/zip/{zip_key}`\n\n## 🔑 Parámetros\n\n**URL:** `zip_key` (string UUID) - Clave única retornada por DIAN en envío asíncrono\n\n**Body JSON:**\n- `sendmail` (boolean): Enviar email al cliente con resultado\n- `sendmailtome` (boolean): Enviar copia al emisor\n- `is_payroll` (boolean): **false** para facturas\n- `is_eqdoc` (boolean): **false** para facturas\n- `email_cc_list` (array): Emails adicionales para CC\n- `atacheddocument_name_prefix` (string): Prefijo para AttachedDocument\n\n## ⚙️ Funcionamiento\n1. Valida token y certificado digital\n2. Verifica disponibilidad de DIAN\n3. Crea y firma request SOAP GetStatusZip\n4. Consulta estado en DIAN\n5. Si IsValid=true:\n - Genera AttachedDocument firmado\n - Actualiza estado documento (state_document_id=1)\n - Envía email (si sendmail=true)\n6. Retorna respuesta DIAN con CUFE y XMLs\n\n## 📤 Respuesta Exitosa\n```json\n{\n \"message\": \"Consulta generada con éxito\",\n \"ResponseDian\": {\n \"Envelope\": {\n \"Body\": {\n \"GetStatusZipResponse\": {\n \"GetStatusZipResult\": {\n \"IsValid\": \"true\",\n \"StatusCode\": \"00\",\n \"XmlDocumentKey\": \"[CUFE]\",\n \"XmlBase64Bytes\": \"[ApplicationResponse]\"\n }\n }\n }\n }\n },\n \"reqzip\": \"[Request XML Base64]\",\n \"rptazip\": \"[Response XML Base64]\",\n \"attacheddocument\": \"[AttachedDocument Base64]\",\n \"cufecude\": \"abc123...\",\n \"certificate_days_left\": 347\n}\n```\n\n## ⚠️ Errores\n- **401**: Token inválido\n- **422**: is_payroll e is_eqdoc ambos true\n- **500**: DIAN no disponible o certificado inválido\n\n## 🔄 Flujo Asíncrono\n1. POST /api/ubl2.1/invoice/{testSetId} → zip_key\n2. Esperar 30-60 seg\n3. POST /api/ubl2.1/status/zip/{zip_key} → Resultado\n\n## 📌 Notas\n- ZIP_KEY único por documento\n- Disponible en DIAN 24-48 horas\n- Genera 3 archivos XML: ReqZIP, RptaZIP, AttachedDocument\n- Email incluye PDF + XML + validación DIAN\n- Controlador: `StateController@zip`\n- Clase SOAP: `GetStatusZip`" }, "response": [] }, { "name": "Paso 1 - GetStatus-zip Nomina", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n\t\"sendmail\": false,\n \"sendmailtome\": false,\n \"is_payroll\": true,\n \"is_eqdoc\": false \n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/status/zip/c7e204cc-8a61-4c09-b13e-f1477a9af196", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "status", "zip", "c7e204cc-8a61-4c09-b13e-f1477a9af196" ] }, "description": "# 💼 CONSULTA DE ESTADO DE NÓMINA ELECTRÓNICA POR ZIP_KEY\n\nEndpoint para verificar el resultado de la validación DIAN de documentos de nómina electrónica enviados en modo asíncrono. Usa el `zip_key` retornado al enviar la nómina para consultar el estado de validación.\n\n## 🔗 URL\n**POST** `/api/ubl2.1/status/zip/{zip_key}`\n\n## 🔑 Diferencias con Factura\n**Parámetro clave:** `is_payroll` debe ser `true`\n**URL DIAN:** Usa `software->url_payroll` (servicio específico de nómina)\n\n## 🔑 Parámetros\n\n**URL:** `zip_key` (string UUID) - Clave única retornada por DIAN\n\n**Body JSON:**\n- `sendmail` (boolean): Enviar email al trabajador\n- `sendmailtome` (boolean): Enviar copia al emisor\n- `is_payroll` (boolean): **true** para nómina\n- `is_eqdoc` (boolean): false\n- `atacheddocument_name_prefix` (string): Prefijo para archivos\n\n## ⚙️ Funcionamiento Específico Nómina\n1. Valida que is_payroll=true e is_eqdoc=false\n2. Usa URL de servicio DIAN para nómina electrónica\n3. Busca documento en tabla `document_payrolls`\n4. Extrae datos del trabajador (Employee)\n5. Actualiza estado con CUNE (no CUFE)\n6. Envía email al trabajador (no al cliente)\n7. Verifica que no sea nómina de eliminación\n\n## 📤 Respuesta\n```json\n{\n \"message\": \"Consulta generada con éxito\",\n \"ResponseDian\": {\n \"GetStatusZipResult\": {\n \"IsValid\": \"true\",\n \"XmlDocumentKey\": \"[CUNE]\",\n \"XmlFileName\": \"ni990000123\"\n }\n },\n \"cufecude\": \"[CUNE]\",\n \"reqzip\": \"[Base64]\",\n \"rptazip\": \"[Base64]\"\n}\n```\n\n## 📋 Tipos de Documento Nómina\n- **NominaIndividual:** Nómina regular\n- **NominaIndividualDeAjuste:** Ajuste de nómina\n\n## 📧 Envío de Email\n- Destinatario: Email del trabajador (Employee)\n- Clase Mail: `PayrollMail` (no InvoiceMail)\n- No envía si es eliminación de predecesor\n- Incluye XML y PDF de nómina\n\n## 📌 Notas\n- Tabla BD: `document_payrolls` (no documents)\n- UUID: CUNE (no CUFE)\n- Busca por: prefix + consecutive + employee_id\n- Controlador: `StateController@zip` con is_payroll=true" }, "response": [] }, { "name": "Paso 1 - GetStatus-zip EqDoc", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n\t\"sendmail\": false,\n \"sendmailtome\": false,\n \"is_payroll\": false,\n \"is_eqdoc\": true\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/status/zip/251a6015-070c-4599-9eac-41dde8123287", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "status", "zip", "251a6015-070c-4599-9eac-41dde8123287" ] }, "description": "# 📝 CONSULTA DE ESTADO DE DOCUMENTO EQUIVALENTE POR ZIP_KEY\n\nEndpoint para verificar el resultado de la validación DIAN de documentos equivalentes electrónicos (documento soporte) enviados en modo asíncrono. Usa el `zip_key` retornado para consultar el estado.\n\n## 🔗 URL\n**POST** `/api/ubl2.1/status/zip/{zip_key}`\n\n## 🔑 Diferencias con Factura\n**Parámetro clave:** `is_eqdoc` debe ser `true`\n**URL DIAN:** Usa `software->url_eqdocs` (servicio específico de documentos equivalentes)\n\n## 🔑 Parámetros\n\n**URL:** `zip_key` (string UUID) - Clave única retornada por DIAN\n\n**Body JSON:**\n- `sendmail` (boolean): Enviar email al proveedor\n- `sendmailtome` (boolean): Enviar copia al emisor\n- `is_payroll` (boolean): false\n- `is_eqdoc` (boolean): **true** para documentos equivalentes\n\n## 📚 Qué es un Documento Equivalente\nDocumento soporte en adquisiciones efectuadas a sujetos no obligados a facturar (personas naturales, ventas informales, etc). Permite al adquirente soportar costos y deducciones ante DIAN.\n\n## ⚙️ Funcionamiento\n1. Valida que is_eqdoc=true e is_payroll=false\n2. Usa URL de servicio DIAN para documentos equivalentes\n3. Procesa respuesta según perfil UBL 2.1 de documento soporte\n4. Identifica AccountingSupplierParty (no Customer)\n5. Actualiza estado con CUDE\n\n## 📤 Respuesta\n```json\n{\n \"message\": \"Consulta generada con éxito\",\n \"ResponseDian\": {\n \"GetStatusZipResult\": {\n \"IsValid\": \"true\",\n \"XmlDocumentKey\": \"[CUDE]\",\n \"XmlFileName\": \"dse990000123\"\n }\n },\n \"cufecude\": \"[CUDE]\",\n \"attacheddocument\": \"[Base64]\"\n}\n```\n\n## 📊 ProfileID\n- `DIAN 2.1: documento soporte en adquisiciones efectuadas a no obligados a facturar`\n- `DIAN 2.1: Nota de ajuste al documento soporte`\n\n## 📌 Notas\n- UUID: CUDE (no CUFE)\n- AccountingSupplierParty = Proveedor (vendedor no obligado)\n- AccountingCustomerParty = Adquirente (comprador)\n- Soporta costos/deducciones tributarias\n- Controlador: `StateController@zip` con is_eqdoc=true" }, "response": [] }, { "name": "Paso 2 - GetStatus-Document Factura", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n\t\"sendmail\": true,\n \"sendmailtome\": false,\n \"is_payroll\": false,\n \"is_eqdoc\": false\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/status/document/cc27b2660d2e97eb8dc4aaea32d0284fc834485d7ed4b0234407d5e4c40cd48d6adcd97e38483e5e1739766aa3f6cd00", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "status", "document", "cc27b2660d2e97eb8dc4aaea32d0284fc834485d7ed4b0234407d5e4c40cd48d6adcd97e38483e5e1739766aa3f6cd00" ] }, "description": "# 🎯 CONSULTA DE ESTADO POR CUFE (Factura Electrónica)\n\nEndpoint para consultar el estado de validación DIAN de facturas electrónicas usando directamente el **CUFE** (Código Único de Facturación Electrónica) del documento. A diferencia de GetStatus-zip, este no requiere zip_key sino el identificador único del documento.\n\n## 🔗 URL\n**POST** `/api/ubl2.1/status/document/{cufe}`\n\n**Parámetro:** `cufe` - String de 96 caracteres hexadecimales\n\n## 🆚 Diferencias vs GetStatus-zip\n- **GetStatus-zip:** Usa ZIP_KEY retornado en envío asíncrono\n- **GetStatus-Document:** Usa CUFE/CUDE/CUNE del documento ya emitido\n- **Uso:** Cuando ya tienes el CUFE pero necesitas re-consultar estado\n\n## 🔑 Parámetros\n\n**URL:** `cufe` (string 96 chars) - CUFE del documento\n\n**Body JSON:**\n- `sendmail` (boolean): Enviar email al cliente\n- `sendmailtome` (boolean): Enviar copia al emisor\n- `is_payroll` (boolean): **false** para facturas\n- `is_eqdoc` (boolean): **false** para facturas\n- `email_cc_list` (array): Emails CC\n\n## ⚙️ Funcionamiento\n1. Valida formato CUFE (96 caracteres hexadecimales)\n2. Usa clase SOAP `GetStatus` (no GetStatusZip)\n3. Consulta estado en DIAN por CUFE\n4. Busca documento en BD local por CUFE\n5. Genera AttachedDocument si IsValid=true\n6. Actualiza estado del documento\n\n## 📤 Respuesta\n```json\n{\n \"message\": \"Consulta generada con éxito\",\n \"ResponseDian\": {\n \"GetStatusResult\": {\n \"IsValid\": \"true\",\n \"XmlBase64Bytes\": \"[ApplicationResponse]\"\n }\n },\n \"cufecude\": \"[CUFE]\",\n \"attacheddocument\": \"[Base64]\"\n}\n```\n\n## 📌 Casos de Uso\n- Re-consultar documento ya emitido\n- Verificar estado sin tener zip_key\n- Generar AttachedDocument faltante\n- Reenviar email de notificación\n\n## 📋 Notas\n- Controlador: `StateController@document`\n- Clase SOAP: `GetStatus` (no GetStatusZip)\n- Archivos: ReqZIP-{cufe}.xml, RptaZIP-{cufe}.xml" }, "response": [] }, { "name": "Paso 2 - GetStatus-Document Nomina", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n\t\"sendmail\": true,\n \"sendmailtome\": false,\n \"is_payroll\": true,\n \"atacheddocument_name_prefix\": \"FES-SETP990000263-\",\n \"html_header\": \"

Señor(es), XXXXXXXXXXXXXXXXXXX identificado con NIT 99999999-9

Le informamos que ha recibido un documento electronico de: YYYYYYYYYYYYYYYYYYYYYYYYY

\",\n \"html_buttons\": \"

Puede descargar su factura mediante el siguiente enlace:

Haga click aqui para descargar su factura.

\",\n \"html_footer\": \"

Previamente recibio un correo con las credenciales de ingreso a la plataforma.

Este es un sistema automático de aviso, por favor no responda este mensaje de correo.

\"\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/status/document/5413ba00c7f89e48dffb228192f6b6c08fe331b5fe7daa446041044bd5d36e645ff8da93fb9821b2a7d2195a4fd92044", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "status", "document", "5413ba00c7f89e48dffb228192f6b6c08fe331b5fe7daa446041044bd5d36e645ff8da93fb9821b2a7d2195a4fd92044" ] }, "description": "# 💼 CONSULTA DE ESTADO POR CUNE (Nómina Electrónica)\n\nEndpoint para consultar el estado de validación DIAN de documentos de nómina electrónica usando el **CUNE** (Código Único de Nómina Electrónica). Similar a GetStatus-Document Factura pero para nóminas.\n\n## 🔗 URL\n**POST** `/api/ubl2.1/status/document/{cune}`\n\n## 🔑 Parámetros\n\n**URL:** `cune` (string 96 chars) - CUNE del documento de nómina\n\n**Body JSON:**\n- `sendmail` (boolean): Enviar email al trabajador\n- `sendmailtome` (boolean): Enviar copia al emisor\n- `is_payroll` (boolean): **true** para nómina\n- `is_eqdoc` (boolean): false\n- `atacheddocument_name_prefix` (string): Prefijo archivos\n- `html_header`, `html_buttons`, `html_footer`: HTML personalizado para email\n\n## ⚙️ Diferencias con Factura\n- Usa `software->url_payroll`\n- Parámetro `is_payroll=true`\n- Busca en tabla `document_payrolls`\n- Email se envía al trabajador (Employee)\n- Clase Mail: `PayrollMail`\n\n## 📋 Tipos Documento\n- NominaIndividual (ni)\n- NominaIndividualDeAjuste (nia)\n\n## 📌 Notas\n- CUNE: 96 caracteres hexadecimales\n- No envía si es eliminación de predecesor\n- Soporta HTML custom en emails\n- Controlador: `StateController@document` con is_payroll=true" }, "response": [] }, { "name": "Paso 2 - GetStatus-Document EqDoc", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n\t\"sendmail\": true,\n \"sendmailtome\": false,\n \"is_payroll\": false,\n \"is_eqdoc\": true\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/status/document/c5cb3cb8872cab8fcedaff43ec594e4901a85a233af05f37a495352b44966dfffaf035ba4935d119c8b74ba5dcaf2e18", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "status", "document", "c5cb3cb8872cab8fcedaff43ec594e4901a85a233af05f37a495352b44966dfffaf035ba4935d119c8b74ba5dcaf2e18" ] }, "description": "# 📝 CONSULTA DE ESTADO POR CUDE (Documento Equivalente)\n\nEndpoint para consultar el estado de validación DIAN de documentos equivalentes electrónicos (documento soporte) usando el **CUDE** (Código Único de Documento Equivalente).\n\n## 🔗 URL\n**POST** `/api/ubl2.1/status/document/{cude}`\n\n## 🔑 Parámetros\n\n**URL:** `cude` (string 96 chars) - CUDE del documento equivalente\n\n**Body JSON:**\n- `sendmail` (boolean): Enviar email al proveedor\n- `sendmailtome` (boolean): Enviar copia al emisor\n- `is_payroll` (boolean): false\n- `is_eqdoc` (boolean): **true** para documento equivalente\n\n## ⚙️ Diferencias con Factura\n- Usa `software->url_eqdocs`\n- Parámetro `is_eqdoc=true`\n- Busca AccountingSupplierParty (proveedor)\n- ProfileID de documento soporte\n\n## 📌 Notas\n- CUDE: 96 caracteres hexadecimales\n- Documento soporte para no obligados a facturar\n- Controlador: `StateController@document` con is_eqdoc=true" }, "response": [] }, { "name": "Paso 4 - GetStatus-Document Events CUFE", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "7692a20fec92af0aa5729d796b019d27c83c9955407994630a0cdd7702ca2329", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/status/events-document/60f3eee79b3f7d019524f554a40e8c87008cd6686a66816246861609a54bc90e5266af9b989f84168cf68d3a88104e72", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "status", "events-document", "60f3eee79b3f7d019524f554a40e8c87008cd6686a66816246861609a54bc90e5266af9b989f84168cf68d3a88104e72" ] }, "description": "# 📊 CONSULTA DE EVENTOS DE DOCUMENTO POR CUFE\n\nEndpoint para consultar todos los **eventos RADIAN** asociados a un documento electrónico mediante su CUFE/CUDE/CUNE. Retorna el historial completo de eventos (Acuse de Recibo, Aceptación, Rechazo, etc).\n\n## 🔗 URL\n**POST** `/api/ubl2.1/status/events-document/{cufe}`\n\n## 🔑 Parámetros\n\n**URL:** `cufe` (string 96 chars) - CUFE/CUDE/CUNE del documento\n\n**Body:** Vacío (no requiere body)\n\n## ⚙️ Funcionamiento\n1. Valida formato UUID (96 caracteres)\n2. Usa clase SOAP `GetStatusEvents`\n3. Consulta eventos RADIAN en DIAN\n4. Parsea ApplicationResponse de eventos\n5. Extrae lista de eventos con detalles\n\n## 📤 Respuesta Exitosa\n```json\n{\n \"success\": true,\n \"message\": \"Consulta de eventos generada con éxito\",\n \"events\": [\n {\n \"event_number\": \"1\",\n \"dian_code\": \"030\",\n \"description\": \"Acuse de recibo de Factura Electrónica\",\n \"date\": \"2024-01-15\",\n \"time\": \"14:30:00\",\n \"cude\": \"[CUDE del evento]\"\n }\n ],\n \"ResponseDian\": {...},\n \"cufecude\": \"[CUFE del documento]\"\n}\n```\n\n## 📝 Códigos de Eventos RADIAN\n- **030:** Acuse de recibo\n- **031:** Recibo del bien/servicio\n- **032:** Aceptación expresa\n- **033:** Aceptación tácita\n- **034:** Rechazo\n- **035:** Mandato\n- **036:** Terminación mandato\n\n## 📌 Notas\n- Retorna array de eventos ordenados\n- Cada evento incluye CUDE propio\n- Si no hay eventos: IsValid=false\n- Controlador: `StateController@events_document`\n- Clase SOAP: `GetStatusEvents`" }, "response": [] }, { "name": "Paso 5 - Get Document Info CUFE", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "7692a20fec92af0aa5729d796b019d27c83c9955407994630a0cdd7702ca2329", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "http://apidian2026-6.oo/api/ubl2.1/status/document-info/7b44a4e40f83bdba575c73616fa686cfa2a27b2077b23ec6287e1ff598c847b6e8da4f5b6b82acb4a28cec24059c442d", "protocol": "http", "host": [ "apidian2026-6", "oo" ], "path": [ "api", "ubl2.1", "status", "document-info", "7b44a4e40f83bdba575c73616fa686cfa2a27b2077b23ec6287e1ff598c847b6e8da4f5b6b82acb4a28cec24059c442d" ] }, "description": "# 🔎 CONSULTA DE INFORMACIÓN COMPLETA DE DOCUMENTO\n\nEndpoint para obtener **información detallada completa** de un documento electrónico mediante su UUID (CUFE/CUDE/CUNE). Retorna datos del documento, estado actual y todos los eventos RADIAN asociados.\n\n## 🔗 URL\n**POST** `/api/ubl2.1/status/document-info/{uuid}`\n\n## 🔑 Parámetros\n\n**URL:** `uuid` (string 96 chars) - UUID del documento (CUFE/CUDE/CUNE)\n\n**Body:** Vacío (no requiere body)\n\n## ⚙️ Funcionamiento\n1. Valida longitud UUID (debe ser 96 caracteres)\n2. Usa clase SOAP `GetDocumentInfo`\n3. Consulta información completa en DIAN\n4. Retorna datos del documento + eventos\n\n## 📤 Respuesta Exitosa\n```json\n{\n \"success\": true,\n \"message\": \"Consulta de información del documento.\",\n \"ResponseDian\": {\n \"Envelope\": {\n \"Body\": {\n \"GetDocumentInfoResponse\": {\n \"GetDocumentInfoResult\": {\n \"DocumentInfo\": {\n \"Documento\": {\n \"NumeroDocumento\": \"FE123\",\n \"FechaEmision\": \"2024-01-15\",\n \"Estado\": \"Aceptado\",\n \"Eventos\": [\n {\n \"CodigoEvento\": \"030\",\n \"Descripcion\": \"Acuse de recibo\"\n }\n ]\n }\n }\n }\n }\n }\n }\n },\n \"certificate_days_left\": 347\n}\n```\n\n## ⚠️ Errores\n\n**400 Bad Request**\n```json\n{\n \"success\": false,\n \"message\": \"El UUID del documento a consultar debe contener 96 caracteres.\"\n}\n```\n\n**503 Service Unavailable**\n```json\n{\n \"success\": false,\n \"message\": \"El servicio DIAN no está disponible en este momento, reintente mas tarde...\"\n}\n```\n\n## 📊 Información Retornada\n- Datos básicos del documento\n- Estado actual en DIAN\n- Lista completa de eventos RADIAN\n- Fechas de emisión y validación\n- Información de partes (emisor/receptor)\n\n## 🎯 Diferencias con Otros Endpoints\n- **vs. GetStatus-Document:** Este retorna info completa, no solo estado\n- **vs. GetStatus-Events:** Este incluye documento + eventos, no solo eventos\n\n## 📌 Notas\n- UUID debe ser exactamente 96 caracteres\n- Valida disponibilidad de DIAN antes de consultar\n- Controlador: `StateController@get_document_info`\n- Clase SOAP: `GetDocumentInfo`\n- Archivos: ReqDocumenInfo-{uuid}.xml, RptaDocumenInfo-{uuid}.xml" }, "response": [] } ], "description": "Son los request que nos permiten una vez se haya enviado los primeros documentos, consultar el estado de\r\nestos envios para saber el porque fueron rechazados o en su defecto, saber si fue autorizado dicho \r\ndocumento.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "7692a20fec92af0aa5729d796b019d27c83c9955407994630a0cdd7702ca2329", "type": "string" } ] } }, { "name": "04 - Casuisticas de Envios", "item": [ { "name": "SendInvoice-TestSetId Order Reference", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n\t\"number\": 990000201,\r\n\t\"type_document_id\": 1,\r\n\t\"date\": \"2025-11-06\",\r\n\t\"time\": \"04:08:12\",\r\n\t\"resolution_number\": \"18760000001\",\r\n\t\"prefix\": \"SETP\",\r\n\t\"sendmail\": true,\r\n\t\"customer\": {\r\n\t\t\"identification_number\": 900166483,\r\n\t\t\"dv\": 1,\r\n\t\t\"name\": \"INVERSIONES DAVAL SAS\",\r\n\t\t\"phone\": \"3103891693\",\r\n\t\t\"address\": \"CLL 4 NRO 33-90\",\r\n\t\t\"email\": \"alexanderobandolondono@gmail.com\",\r\n\t\t\"merchant_registration\": \"0000000-00\",\r\n\t\t\"type_document_identification_id\": 6,\r\n\t\t\"type_organization_id\": 1,\r\n\t\t\"municipality_id\": 822,\r\n\t\t\"type_regime_id\": 1\r\n\t},\r\n \"order_reference\": {\r\n \"id_order\": \"A23061977FBC\",\r\n \"issue_date_order\": \"2020-10-01\"\r\n },\r\n\t\"payment_form\": {\r\n\t\t\"payment_form_id\": 2,\r\n\t\t\"payment_method_id\": 30,\r\n\t\t\"payment_due_date\": \"2025-12-06\",\r\n\t\t\"duration_measure\": \"30\"\r\n\t},\t\r\n\t\"allowance_charges\": [\r\n\t\t{\r\n\t\t\t\"discount_id\": 1,\r\n\t\t\t\"charge_indicator\": false,\r\n\t\t\t\"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n\t\t\t\"amount\": \"0.00\",\r\n\t\t\t\"base_amount\": \"840336.13\"\r\n\t\t}\r\n\t],\r\n\t\"legal_monetary_totals\": {\r\n\t\t\"line_extension_amount\": \"840336.13\",\r\n\t\t\"tax_exclusive_amount\": \"840336.13\",\r\n\t\t\"tax_inclusive_amount\": \"1000000.00\",\r\n\t\t\"allowance_total_amount\": \"0.00\",\r\n\t\t\"charge_total_amount\": \"0.00\",\r\n\t\t\"payable_amount\": \"1000000.00\"\r\n\t},\r\n\t\"tax_totals\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"tax_id\": 1,\r\n\t\t\t\"tax_amount\": \"159663.86\",\r\n\t\t\t\"percent\": \"19\",\r\n\t\t\t\"taxable_amount\": \"840336.13\"\r\n\t\t}\r\n\t],\r\n\t\"invoice_lines\": \r\n\t[\r\n\t\t{\r\n\t\t\t\"unit_measure_id\": 70,\r\n\t\t\t\"invoiced_quantity\": \"1\",\r\n\t\t\t\"line_extension_amount\": \"840336.13\",\r\n\t\t\t\"free_of_charge_indicator\": false,\r\n\t\t\t\"allowance_charges\": [{\r\n\t\t\t\t\t\"charge_indicator\": false,\r\n\t\t\t\t\t\"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n\t\t\t\t\t\"amount\": \"0.00\",\r\n\t\t\t\t\t\"base_amount\": \"1000000.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"tax_totals\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"tax_id\": 1,\r\n\t\t\t\t\t\"tax_amount\": \"159663.86\",\r\n\t\t\t\t\t\"taxable_amount\": \"840336.13\",\r\n\t\t\t\t\t\"percent\": \"19.00\"\r\n\t\t\t\t}\r\n\t\t\t],\r\n\t\t\t\"description\": \"COMISION POR SERVICIOS\",\r\n\t\t\t\"code\": \"COMISION\",\r\n\t\t\t\"type_item_identification_id\": 4,\r\n\t\t\t\"price_amount\": \"840336.13\",\r\n\t\t\t\"base_quantity\": \"1\"\r\n\t\t}\r\n\t\t\r\n\t]\r\n}\r\n\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "# 📄 ENVIAR FACTURA ELECTRÓNICA - CON ORDER REFERENCE\n\n## 📋 Descripción General\nEndpoint para envío de facturas electrónicas que incluyen referencia de orden de compra (order_reference). Permite asociar la factura con números de pedido, órdenes de compra o referencias comerciales del cliente.\n\n## 🔗 URL del Endpoint\n**Síncrono (recomendado):** `POST /api/ubl2.1/invoice`\n**Asíncrono:** `POST /api/ubl2.1/invoice/{testSetId}`\n\n## 🔑 Campos Principales Específicos\n| Campo | Tipo | Descripción |\n|-------|------|-------------|\n| `order_reference` | object | Objeto con datos de la orden de compra |\n| `order_reference.id` | string | Número de orden de compra/pedido |\n| `order_reference.issue_date` | date | Fecha de emisión de la orden (YYYY-MM-DD) |\n\n## 📦 Estructura de Order Reference\n```json\n\"order_reference\": {\n \"id\": \"OC-2025-001234\",\n \"issue_date\": \"2025-11-15\"\n}\n```\n\n## 💼 Casos de Uso\n- **B2B:** Órdenes de compra entre empresas\n- **E-commerce:** Números de pedido de tiendas online\n- **Contratos:** Referencias a contratos o licitaciones\n- **Pedidos Recurrentes:** Referencias a órdenes maestras\n\n## ⚙️ Comportamiento del Sistema\n- **Modo Síncrono:** Validación inmediata de order_reference\n- **Modo Asíncrono:** ZIP_KEY para consulta posterior\n- **XML Generation:** order_reference se incluye en el XML UBL 2.1\n- **Trazabilidad:** Facilita seguimiento de pedidos vs facturas\n- **Validación:** Verifica formato de fecha y longitud de ID\n\n## ✅ Validaciones Críticas\n- Validación de formato de fecha (YYYY-MM-DD)\n- Verificación de longitud máxima del ID (100 caracteres)\n- Validación de que issue_date no sea futura\n- Coherencia entre order_reference.issue_date y document.date\n\n## 💾 Impacto en Base de Datos\n- Tabla `documents`: Campo `order_reference_id`\n- Tabla `order_references`: Registro completo de la orden\n- Índice por order_reference.id para búsquedas rápidas\n- Trazabilidad de pedido a factura\n\n## 📤 Respuesta Exitosa (200 - Síncrono)\n```json\n{\n \"success\": true,\n \"message\": \"Factura procesada exitosamente\",\n \"ResponseDian\": {\n \"Envelope\": {\n \"Body\": {\n \"SendBillSyncResponse\": {\n \"SendBillSyncResult\": {\n \"IsValid\": \"true\",\n \"StatusCode\": \"00\",\n \"StatusDescription\": \"Procesado Correctamente\"\n }\n }\n }\n }\n },\n \"cufe\": \"...\",\n \"order_reference\": {\n \"id\": \"OC-2025-001234\",\n \"issue_date\": \"2025-11-15\"\n },\n \"pdf_url\": \"storage/pdf/...\"\n}\n```\n\n## 📤 Respuesta Exitosa (200 - Asíncrono)\n```json\n{\n \"success\": true,\n \"message\": \"Factura enviada al set de pruebas\",\n \"zip_key\": \"...\",\n \"order_reference_id\": \"OC-2025-001234\"\n}\n```\n\n## ⚠️ Errores Comunes\n- **400:** Formato de fecha inválido en order_reference\n- **401:** Token de autorización inválido\n- **422:** order_reference.id excede longitud máxima o issue_date futura\n- **500:** Error interno al procesar order_reference\n\n## 🔐 Autenticación\n```\nAuthorization: Bearer {API_TOKEN}\nContent-Type: application/json\n```\n\n## 💻 Ejemplo cURL\n```bash\ncurl -X POST \"http://midominio.com/api/ubl2.1/invoice\" \\\n -H \"Authorization: Bearer {TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"number\": 990000123,\n \"order_reference\": {\n \"id\": \"OC-2025-001234\",\n \"issue_date\": \"2025-11-15\"\n },\n \"customer\": {...},\n \"invoice_lines\": [...]\n }'\n```\n\n## 📝 Campos Relacionados\n- **despatch_document_reference:** Referencia a remisiones\n- **receipt_document_reference:** Referencia a recepciones\n- **additional_document_reference:** Otros documentos relacionados\n\n## 📌 Notas Importantes\n1. El order_reference es opcional pero recomendado para trazabilidad\n2. El ID puede incluir prefijos y caracteres alfanuméricos\n3. La issue_date debe ser igual o anterior a la fecha de la factura\n4. El order_reference aparece en el PDF de representación gráfica\n5. Facilita la conciliación de pedidos con facturas\n6. El XML incluye OrderReference en el esquema UBL 2.1\n7. Útil para auditorías y seguimiento comercial" }, "response": [] }, { "name": "SendInvoice-TestSetId Cliente Extranjero y Moneda Extranjera", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": 994600213,\r\n \"currency_id\": 149,\r\n \"calculationrate\": \"4250\",\r\n \"type_document_id\": 1,\r\n \"prefix\": \"SETP\",\r\n \"resolution_number\": \"18760000001\",\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3103891693\", \r\n \"establishment_email\": \"gerencia@torresoftware.com\",\r\n \"actividadeconomica\": \"6201\",\r\n \"notes\": null,\r\n \"date\": \"2025-11-07\",\r\n \"time\": \"16:47:01\",\r\n \"payment_form\": {\r\n \"payment_form_id\": 1,\r\n \"payment_method_id\": 10,\r\n \"payment_due_date\": \"2025-11-07\",\r\n \"duration_measure\": 0\r\n },\r\n \"customer\": {\r\n \"identification_number\": \"AB1234567\",\r\n \"name\": \"CLIENTE DEL EXTRANJERO\",\r\n \"phone\": \"3103891693\",\r\n \"address\": \"EVERGREEN AV 5 68\",\r\n \"email\": \"alexander_obando@hotmail.com\",\r\n \"merchant_registration\": \"000000\",\r\n \"type_document_identification_id\": 8,\r\n \"type_organization_id\": 2,\r\n \"municipality_name\": \"Ashville\",\r\n \"state_name\": \"Alabama\",\r\n \"type_regime_id\": 2,\r\n \"type_liability_id\": 117,\r\n \"country_id\": 65\r\n },\r\n \"tax_totals\": [{\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"0.00\",\r\n \"percent\": \"0.00\",\r\n \"taxable_amount\": \"425000.00\"\r\n }\r\n ],\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"425000.00\",\r\n \"tax_exclusive_amount\": \"425000.00\",\r\n \"tax_inclusive_amount\": \"425000.00\",\r\n \"allowance_total_amount\": \"0.00\",\r\n \"charge_total_amount\": \"0.00\",\r\n \"payable_amount\": \"425000.00\"\r\n },\r\n \"allowance_charges\": [{\r\n \"discount_id\": 1,\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"425000.00\"\r\n }\r\n ],\r\n \"invoice_lines\": [{\r\n \"unit_measure_id\": \"70\",\r\n \"invoiced_quantity\": 1,\r\n \"line_extension_amount\": \"425000.00\",\r\n \"notes\": null,\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [{\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"425000.00\"\r\n }\r\n ],\r\n \"tax_totals\": [{\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"0.00\",\r\n \"taxable_amount\": \"425000.00\",\r\n \"percent\": \"0.00\"\r\n }\r\n ],\r\n \"description\": \"PRODUCTO DE PRUEBA NRO 1\",\r\n \"code\": \"PRUEBA1\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"425000.00\",\r\n \"base_quantity\": 1\r\n }\r\n ],\r\n \"with_holding_tax_total\": [],\r\n \"web_site\": \"Facturador Torre Software\",\r\n \"firma_facturacion\": \"\\/9j\\/4AAQSkZJRgABAQEAYABgAAD\\/2wBDAAIBAQIBAQICAgICAgICAwUDAwMDAwYEBAMFBwYHBwcGBwcICQsJCAgKCAcHCg0KCgsMDAwMBwkODw0MDgsMDAz\\/2wBDAQICAgMDAwYDAwYMCAcIDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAz\\/wAARCAGXAsgDASIAAhEBAxEB\\/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL\\/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uHi4+Tl5ufo6erx8vP09fb3+Pn6\\/8QAHwEAAwEBAQEBAQEBAQAAAAAAAAECAwQFBgcICQoL\\/8QAtREAAgECBAQDBAcFBAQAAQJ3AAECAxEEBSExBhJBUQdhcRMiMoEIFEKRobHBCSMzUvAVYnLRChYkNOEl8RcYGRomJygpKjU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6goOEhYaHiImKkpOUlZaXmJmaoqOkpaanqKmqsrO0tba3uLm6wsPExcbHyMnK0tPU1dbX2Nna4uPk5ebn6Onq8vP09fb3+Pn6\\/9oADAMBAAIRAxEAPwD9\\/KKKKACiiigAooooAKKKKACiiigAooooAKKKKACkFLRQAUUUUAFFFFABRRRQAUUUUAFGaKTHNAC0jNg0tFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFGaACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKAGoSc5GPxp1FFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAVTunuVuIvKSJozIfNLuQVTBxtAByc4644zVyigBsf3BTqKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAqO7theW7Rtna\\/BwcH86kooARRtXFLRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFITgUxZhjnigCSimiQHuPzpVcMODmgBaKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKz\\/EvinT\\/AAho91qGp3ltYWVlE009xcSiOKFF5ZnY4CgDqScVm\\/FH4laP8JPA+p+INf1C10rSNJt3uru7uZRHFbxqMszMSAAB61\\/NX\\/wVG\\/4Lc33\\/AAUu8b654fF94v8ABvwftoo4fDmm2ASFvEtwZ4Umm1OTef8ARVRpGWNMhtqA4JJFxg5bAfoh+3f\\/AMHNum+APEuueHP2e\\/B9v8Vbrw5aNcax4gvLw2eiacVLgorEAzHCE5VgrcBWYnFflv8AHr\\/gvT+1N8a\\/FkzX3xrHhnRLq3R1t\\/BtmtpFbpLGDt3spl8xclTlyVbJHQV8r3emnxXd+drt9NpmkQQyTafsgK2kaJlikUGQU\\/dqCDtPIAOSa6j9mf8AZd8XftP\\/ABEiT4ceDX+Iw0x4Td6VNtga+j3heUViVUjGSM7N2T0rrjRitybnt1j\\/AMFk\\/wBpTTtSRrL9qfxexsp28v8AtLSovs9xFD80bk+UzOX2qpRgGYs2eDmvsz9k\\/wD4OhPjZ8LfCS6v8WPAuj\\/FnwHbTrYTeJfCoFlqFrMfmPnwElAdgcgbU3EDB5r85P2uf+Cf3xT\\/AGNfENtL8R\\/AEXgS21uP\\/iX2v9t20ouCOXhiZXZmcYYqXGCBjOcV50vga98J2118Q\\/hx4kudZ0XQ\\/szXGoJF\\/Z+r6G0rFFFzAGbMW8Mm9C8bbgGILbaznGHQV2f1+fsdftrfDr9vD4L6d49+GniC213Qb8bXCnbcWMoHzQTxZ3RSL3Vh6EZBBr1cHIr+UP8AYR\\/bqi\\/YR+KnhTx14a8U6xoH9tajbWHxM8N2MYiTXNLmkaVNUtEKskUkQ3h0RRhTGyfLMwT+pKL4z+GE+FEPjWXW9NtvCs2nrqo1SadY7UWrRiRZi7YAUoQ2TXO1Z2KWp1ROK8l+MP7dvwf\\/AGf\\/AB9ZeF\\/GvxI8HeF9f1GKWa3stS1SK3kZIkDuTuYBPlYEBiC3O3OK\\/P8A\\/bq\\/4OAtWu\\/hD4xvf2evDN9f2PhSyW91TxtrumvBpdlDIxjja1ilKfaZGbbtDEBhkqJOAf5\\/vjH8f\\/E\\/x4+LOueOvE+uXmt+K\\/EbSi+1m+O+7lQqq7V+VViVQu1QigKMAVrGg3uM\\/qX+L\\/8AwXZ\\/Z1+Cuo6Dbap4l1y7\\/wCEjSSayksPD17cJJCm3MwxGC0ZLAKyBgxBx0r6G\\/Z+\\/ac8FftR\\/DKz8X+Btctdd0C9B2zxhkaJlOGSRGAeN1IIKuARivwDvPGHgLxP\\/wAG32sfFDX7GLxf8Y\\/7Vg+HMWua3Ob270mSK8XyTaM+fIIswhJjIZtoyTgV0v8Awb9\\/G7wv+zp\\/wT7\\/AGhdW8d\\/Ei3+HFl4ouIvDula3qss1wljeXFreNGPJy2WQBpBgAsDyelQ4LdBpY\\/RD\\/gn\\/wD8Fy\\/+HgX\\/AAUN+Inwd8NfDq5h8I+AYr55PF\\/9o+bHcmC4jt4h5QjATzW84rl8lUBx1x+gwr8jP+CEXwf+An\\/BJ39jDxn8WtZ+PfgfxbpnjTWbfS9T8UWU8kWk2zwBxBZqsgD+cTLI7bhn5+BgV9laj\\/wWw\\/Za0zWPClkfjX4JuJvGsvk6U1rdm4jkfeEAkeMFYcsQAZSvWoa1sgPqhmC9aFYN05r8jf8Ag7K+M\\/xM+En7PPwpv\\/h54517wdp9zrN3\\/a0uia6dNub0C3VoVBR1kkXO84XIyRnqK+hP+CBOu+IPh\\/8A8EdPAHiv4q+KNWubvUbS+8R32p+JL93eyspLmaSIvLMxIiEARwScYbPSjlaVwPu+ivJP2fv27Pg9+1Pq13YfDv4k+DfGN9YFxPbaVqkVxNEEIVmKA7toLL82McjmvSPF3jTR\\/h\\/4fuNW13VdO0XS7Rd095fXKW8EI9WdyFH4mkBp0E4FYvgj4i6B8TNAi1Xw5rWla\\/pc5IjvNOu0uYHI6gOhKn8615Wwh+lAC+Yp70Bwe9fz3ad\\/wcYfGbwT\\/wAFbdd0PxD4003\\/AIUZp3xHm0C\\/sW0i3I0\\/S0uZrbzUuFXzMKqLKSSSeQOK0\\/8AgnT\\/AMF9\\/wBov9sD\\/gq34D8E3fibSJPht4s8T36f2Vb6HbwyjTglzJCDM4EnCRoc53HB6ninyvcD+gCjNUL3xPp+mXkdvc31pbXEyl44pZlR5AOpAJyQMivOf22\\/jw\\/7NX7H\\/wAT\\/H8EttDdeD\\/C+oataPPzF9oitneEMO4MgQY75pAeqZpa\\/Gz\\/AINyP+Cx37QP\\/BRX9pHxV4R+J+oeEtZ0LQvDn9sfaLfTfsF\\/DM1wkSIBH+7dBlgchT0OT3\\/Y4XK+Zt70AS0U0ygVBFq0FxcSxJKjyQECRQwJQkZGR24oAs0UxplTqw\\/xoFwpbGeaAH0UyWXYvHJr8rPid\\/wdqfAz4W\\/GPxZ4TuvA3xNvY\\/Cmqz6VJqdpa2jW908LmOR1Vpw4UMrY4yQOgzimk3sB+q1FeB\\/G7\\/gpD8Lv2fP2OrT45+JNbMPgPULC2v7GW3j864vxcKphiiiBy8h3Abe2DnGDXgP7DX\\/BxT8Cv29Pjnpfw48NWvjbRPFut+e1ha6vpGyO4SKMys3mxu6r8iscEjp9KQH31RSK+5QfUZoDg0ALRRSE4FAC0V8+ftW\\/8FRPgj+xP8S\\/DPhH4l+PNK8La94thkuLCC63BREhI82V8bYkLAqC5G5gQM4Ne3eDfGenePvDllq+k3cF9puowJc21xC4eOeNxuV1I4IIIIPoaANWikJwK5HVvj74J0HxaugXnizw5a667iNdOl1KFLpnOMKIy27JyOMd6AOvopsUyzIGU5B9KdQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFI7bUJ9KWoryTyrSRj0VSTyB\\/PigD8Nv+Drv\\/gorfrf6b+zl4duJra3urWHWvFc8MuxpomdhBZ9DwxQu3qABX43fD3wFqXxW8X6R4V8P22o3VxqU628MMSZ3zFgqBQD3+T9a9b\\/AOCq\\/wAb2\\/aS\\/wCCk3xk8XyLLCza\\/Np9kh8t1EFpi1UZjZlP+rJyDg5z3r63\\/wCDV34baR8U\\/wBv2ebVYFml8K6Jca3bwvAGRJ98EKNu6oU81sdmya9CnFRjczmfQ3\\/BQT\\/gjH8Mf2Sf+CSPjP4geNorvWvi3ZeH7aytNQub2SSHTrhnijitoox8uFLEdMbiT3r8Yf2ePGuqfCv4reGvFXh\\/XJ\\/COr6Dq6z2urREkWUyuNrOAQShAIZeQykiv39\\/4O5fi5P4F\\/Yb8F+HLd2H\\/CT+MbYTRr1mht4Zp2GOhAdYz+Ar+du5M8Wk3d48f+jK4eR\\/JKojHoN2CgPOcfXFTT99c0h7aI9c\\/bg\\/bW8V\\/t2ftRan8W\\/FS2VrrN7YWrxWNvLI1pZJDbInlxAkkAs0jkD+Jm9K+p\\/hF\\/wT11DWP+CTP\\/DVvgbxLokuueF5NQsPF3ha\\/jhFjqemCUQzQkqqMJGQg7XJJ+UoQwBPwfdTRQ\\/ZVV3Z40JmScBUiJzuQMOi\\/Nkde+cdK0vhn8TfHGm\\/DPW\\/Anh7xLf6R4T8cyRx63ZtNtstT8phIm8Y+YhkByMYG7PBIquTT3R2NLwX8Or3xF4k1nTItI1fUtT1XTrq0g0TSIzdTQbvntUkJB2xeYIWBOWwmCArV+vn\\/BJT9nLxf+1p+yR4S0P9pDxR4t8OfDb4cauPCVj4W1uCbT7XW5GcPbwurqDcACTyQz5UBECrkbq\\/Hv4W+FdY1b4r+HtC8Mya1\\/aGq69Z2sYs5iL+6kEqxxBZVOMqOnO1Rz0Ff2j6LpKR+HdPilDSvBFGN07CSTcFA3Fu7ep71FZ8mw4aan5Pf8HQfh7w3+zr\\/wAElPCPgfw3baZoumXPjLTLWC2OVDwW8FxO+SBljiJcknJ9zX4KeJ\\/g83hH4G6N4t1DXdOS71DXr7QX0hH33dt5Nnb3QuARlWjJuFQ45B7+n7Pf8Hlvilk8KfAfQFuook+2axq7QvkGdooraJSMK3IWaTAPByea+RNB\\/wCCXUnx5\\/4I2fAHxta+LtE8JeI9S8Ta7DpumXunvcv4mkvrhIowjDiLZDYnJcBFRSxZetZ0pyvZjtc+dfEXinUW\\/wCCWvgrwhHqWqWOjap8RNb8S3EMbEWV9bQWemwB35yZEumZFwMDdIScCvQfjLb6X4V\\/4Ig\\/BKWNbiLXPib8Uda1bUEjnb\\/SI7C3aygKkZGyNWQZ9Wb1rpf+CvH7Dsv\\/AATi+EPwF+HOreIIdV1q00PVNcvbm0lVUlvLi7ZwFiYeasKoCCQQNwJHIwcn\\/gpTbaj8Ef8Agn\\/+x38M\\/M01JbXwXe+NNQjtBiRV1G982KVn4+9GOnOSnaiVn8IMd8atKm+HH\\/BAD4Q6fBd2ssXxR+K9\\/wCKJYlmKzqtpaNaZZDj5POVvmGRynOTXxXrkTweG2jazhtplDyo7PxAC+xWYY4+4xHc9eeK+0P+CtPgS7+Gf7Gv7EOjtJaxWp+GFzrX2dNxmNzeXKzzO5JI2tvj2gYOd\\/px8k\\/HPQtJtbqysNCuLu6P\\/CO6dePPKpDyXF1apcyxNGVB3RvcGNSowQpYdapNKNydj7z\\/AODi\\/wCM1\\/8AEXxX+zdp93qhvYdG+D1hq0sMaHbbXdzGhkkOeCWRY\\/XA+td7\\/wAFeP2obv4Mf8Ewf2Of2fZLrV4dXuvh7beIvFFvaX01oklk9iba1gl2kF8ymRijDH7hezV8tf8ABZ20Nx+2lpfhHT76yEsPgXwporOkreWJjpcCsh47nYMEDrziuy\\/4L0a3pEn\\/AAVFn8Fbrx9O+Gvg7w\\/4OsRbkSIXhtYZtjBssVZrmRDg5DANzgqc9rBrueO\\/8Er\\/AI7az+zt\\/wAFBvgtrXhS6NpqFx4hstJuvLI8u9s7qZIZYZOQCGV2bBPBA9K+3v8Ag6t\\/be8R\\/FD9stfgXYavqFr4K8D6RbXuradFN\\/o+r6jL+\\/RpEX73lxmMKP7zH61+enw++EGsfDL9vfwr4Z8PMup+IdF+I0WkafdpbFre9uLXUUiD+WCWCEoWI5IXucZr6U\\/4KyeHvGv7K\\/8AwWF8d+Mvi34e0vWW1e9udf0+yNwlxba1pUwaxtY1+8YiqE\\/6xRhoTgHg07Jy0H0PqD\\/g0G\\/aX1zSv2kPH\\/wnkW4PhvVPDya\\/bQRhjbWF3DcbJGxghWljmGSSM+SoHTFf0Aa3fLpeiXtxIQEt4XlYt2Cgkk\\/lX84n\\/BoFos7\\/ALf\\/AI1mXzWTTfAjLKcfu1Zry1UHJPXIbAwerYxiv3J\\/4KefEM\\/DD\\/gnT8ctfPnZsfBGq7TFL5bqzWkiAq3YgsD+FRUXvaD1tc\\/j417xFJ4h8XatqD7UbUNTuLh4olwpbzH5x6EscZ55zX6Ef8Gy2g6AP+ChOpeO\\/Elufsfwg8Barr0kqpkw7RHFvA6kiKW4xx\\/F1r84bFvsWnRRCTcu1VOPvYAH5Z\\/zzX3J\\/wAEv9WT4Wf8E\\/8A9tb4nWUNx\\/aUfhHTfBdvMj\\/ubRNVuniuJGG4Z2r5Z7kc4FdNS3s+Um55T\\/wUJ\\/4KB+Nv+ClP7Sms+ONf1fUfsEMlxD4Y0yFnhGiacsm+MKqHHmFFV3bqWPXGMffZ\\/wCCrEHjX\\/g2p8f+EPih4zk1n4kahf3PgjQITM0mralbpJbyRzTqp3eWiMyGQ8MEVSSWr8k\\/DWlaZ\\/wq7Uri\\/hls9YlkhXS5o5DH9vSR5FkPklTvG0fLKGRV8tlIckBfsKPwpbfDf\\/gg4viHWbCWw8V\\/EL4jS6PpRuLdCbyxhFvdz3HmuPMUB7ULnPO5geq7cnGI02e+\\/wDBBL9ovwR\\/wT+\\/Yv8A2mP2jb26kvNe0q30zw3penSWxiW4uJmn+zxKcFm8yZQWYHhUbOSua+JNT\\/4Kl\\/tF+LvjdcfEmT4zeOoPF8s7PFJa6g8dlbgtuEKW2fKEO7A27cYFdt47uv8AhBP+CKmj21peS3E\\/xE+NE0kro+w3EGmaLCgHlZG1VubiTAAAG0Y6ivkbRPD1\\/rc7x2sF3feSgeRLSJp5YgASXKIC20fLlugyBmnTjFptk3dz9+\\/+Cjv\\/AAX8+K37P\\/7An7OHjbwLp\\/ha21z46eGLi6v5dUiknutNuIoYFaeFEKx7fMkYgtntxxX5X\\/sV\\/wDBVz4vfsz\\/ALcOl\\/Fd\\/F\\/iLxzqfibUVbxRpt9qLLb+Ilk\\/dlXXOxXVWURkL8m0AADisb\\/gox491rxdo3wA8B3lhNFH8L\\/hJpVubV4zFJBNco15Mzq4DAmNoc5XgK2MjGfPfhv+zl4jH7Z3hD4W+JrG58MeINS8R6XaSwTQ+dc2H2h4Jk+VcjfsljIBxkt8wHIpKMeUdz9M\\/wDg5b\\/4KD\\/Eb4Vf8FDfDWkfD74m+L\\/CFt4c8KWU2pafpWoyww297cTPIFZEIEjNEI85yMVwH\\/BDD\\/grN8W3\\/wCCqfh\\/TviH478U+M9H+Kk03hy+i1fVS0EV4VEsE8MTfJHsYeXiMKCHbntXzZ\\/wUyXXf2nP+CyvxR8LaTrQ1zWdY8XR+FLGS4MVr9paJY7UKzsESJVCNk5C4z161tf8EBfCk3iL\\/gtH8GLS5S2uFstR1C9gMMimIpb6beYZfvZwYu\\/JAQ55zS5VyiV7n9U\\/xE8axeBPhzrutTsTDpGn3F5ISQPliiZzyeOi1\\/EzrfiOTxfr+tam2RLrl\\/LdtnGSZZWfB\\/766+9f16\\/8FZfifB8JP+CZPxp1y7LosXg++tlKDkyzwmCMe2XkXntX8es2o2+kzWUU8Mkiz7QiRoA5wo2qAemTgZ\\/SroQ3Y5dj6U\\/a\\/wD22rv9oT9lz9m7wHZ3Wow23wj8L3GmanY+WY7Nr77bOsUir912FqIvn6gu3Oc19I\\/8GvPw2bxp\\/wAFX9P1qfUbS2h8C+FtT1acMPmmEiralQcYGPO3E54C1+bF34gXT72OBo7j5gNwKfLDxwM9\\/wD69fcX\\/BKfxJrnwl\\/Zb\\/bB+IXh7xBF4cv9L+HtrpAvZdOMyk3l2UaCNg67Z5EBCHDAEliPlpzso8qJSsz7U\\/bB\\/wCDt3xn4H\\/ai8V6R8KPCvgzxN8N\\/Dt6LGyvdQS6S81cptWWRSrhVTd5m0lemDX3Z44\\/4Lp+HNH\\/AOCRw\\/ai0HQv7XNzJFYQ+Hrm+EDx6gZfKkt3kVWxsKu33clVB4zX8q9szWxihAw3AUKvL9xnk9TX2V42+N8ngr\\/ghb8PfA1ratHN4o+LOta1fXRTdDL9jtrdU2hh63AHyZH7s5NZ+zV9A59D71m\\/4PKtdkj8PM\\/wTs7OL7U769J\\/bjS7bfd8oth5a5kCkE7+OMd81+h\\/7f8A\\/wAFs\\/AH7DX7FvhH4qmIeKNQ+INvBJ4W0OC7WOTVPNRZC7OAwWONXUuQD1AGSa\\/k4up5Z9N8zZPHCyko395clSRkjcNwxx0wa+zP+Cu\\/xyXxr8Nf2V9FayuoNO8F\\/CHTWt3v3z9snuEDOyqctgBVXJY57dM03Ti2Pm7nEf8ABUf9v\\/XP+CqHx+uPitqmh2nhiDTtCg0S302K++0iEx73kdCwHDO7HgDjHU1+93xF\\/wCCu3w9\\/wCCRf8AwTo+BP8Awl1vqPibxX4h8Jaamm6FpsiLdXCpZxAzMXOEjBKjJPOeM4r+YXR47zxhq9hA0txOby+W2NpGdhO+RUKgc9dwA+U8564r3z\\/gqr+0Drnx7\\/bZ8W32t6Z\\/Zlt4VZPCeiaWJROLCysP3EahgFyxKMxIUZJ6Cj2fM7ML9j+gv\\/gl7\\/wcKeCv+CjmteJNAPhfVvBni\\/QbOXU4dEknF\\/Pq1rGpLNblAu9wcApjOWHrX4rfs7eNNf8A2lf+DgLwb4x1ywbTvEHiT4k\\/b5LS4Te1vGjudjA8DZGirgf3Kpf8G9fxf0v4Vf8ABTzw94i1yaKPTtM8LeIL6QeWWd1h0+S4dUwfvlYmPPHB9qp\\/8EltfsviB\\/wV78N+M7jfoOl+Hv7Y8XSie3+1vDDb20823bwAcN16A\\/WjkVmhNs\\/er\\/god\\/wXy+DH\\/BNT4ueH\\/AviiPW9b1nUEWfU\\/wCxYFmTQIW+49wMg7m6hFy2ATxxn60\\/Z2\\/aK8LftNfC\\/SfF3hDVrfWdD1uFbi1uYW3KysM49iO46g8Gv4wP2nfjbe\\/E\\/wCPPifxDd3F5dXPiLUJNRubu6ZnnupJOSWQswX5W27ASABgV\\/Qj\\/wAGhutR3\\/8AwT11u0F2ZZdO8Y6hCbcyBha5jt5QoXcdo\\/eE9AMk9azrUuTYq\\/Y\\/WyikFLWRQUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAVX1SD7Tps8exZN8bLsf7r8dD7VYpsi7kI9eKAP40f2xvBt78HP2xvif4Jn0dNEv7DxReQXWmiZL2K2WSYyII32qSAJBg8HH0r6I\\/wCDfj9suD9lf\\/gq14WvvEV7b2Xhfx1YzeC7+8kPlQxTyMslvI5OBgzQxjceB5pr7N\\/4OMf+CX\\/hXRP2vNM+Nmty67ongX4mQpoPiHXNMeJI\\/C2sBBHY3lwrD5raU4SUnBXbkHJAP5V+B\\/iV4u\\/Yv8U+OPBPjHwvY6tpnirTJNC1\\/wAPanjyplYboby1mTJSSNts0U0bEMuMb0bNdimnGxGzP6f\\/APgpx\\/wSn+Hv\\/BWPwL4W0zxrq\\/iXSV8KXr6jp11ol2sZJkQI4YMrKwKjgjBHY14r4O\\/4JE\\/s1f8ABI\\/4EfFr4gX9vrniTw23h24OrQeJrtdQiW1SMloYkKhd8h+UHrlgM1+Tf7Ef\\/Bw\\/8fv2IfBth4V1qbTPH3h2PSkTR4vENwXn0+JX8tGE8eGaP5CgWXlQQc4rp\\/8Agop\\/wcAah+3L4lvPAnijwZ4x8OfCGWzFnq3hXTryG31W9uSoYSTzsPlCy7NkYGCAGYNnZWSTRas9T8zINDuk0Szu57eSCK+t1uLe2LBWuU3NHu9VQmORenO0nvmm6pfvqtyLmQBH35SKLEUMI6AKo4x3+ua9D+PWsfCKXU9L\\/wCFUaV8ULERps1ebxdqFpcNcyYGEgSBQFCtuJYn5geFXGKwPgx4c0jxf8WtI03xVqh0Lwy02dW1LzY45LG3Y\\/M6B\\/lZlySE6tggc12RvZBc+hf+CGnw4g+M3\\/BXL4I6Lqg8yytdXn1SSLcSC9pazXUeDnkb4kzj1xX9b0Y\\/cLjtX4X\\/APBsf\\/wSRm074sXP7SfiGaLU\\/C9obyx+G91JE9rdX8BeWBtRkh\\/gWSEsoViT854G0V+4PibxNYeDvDV1qep3trp2m6fC9xc3dzKIobeNAWZ3diAqgAkknAArjxD5pWJgfzuf8Ha3xJb4hf8ABRLwf4Kklggt\\/Bng06jDI0pVpJrl7h3hHbdIsMSrnqwUd6+RvhD\\/AMFWfix8DW8BR+GH8BpafBvww+k6TZ6ppZuraCT5pLiVCSCLm434ZhzxgGuq\\/wCC1n7QVn8bf+CqHxl1OafVri2ENvpujTrbeX9ijitIxBKI2YbxLuYBsgKswk25G2vk\\/wCD3w+T4mfGXQvC2lh9Ustc8QWWh2kk0P2bzxNdxQK0gDMEY7vVsA8E1vTXLHXcd7M+3v8Ag4w\\/aVv\\/AI7\\/ALZ2gRX9locH\\/CM\\/DbQrO4WCQ7Fu7+EXrHa3ICecQB2XGTziua\\/4L9vpejftieHvA+kXM2p\\/8K++FvhvwqGVdwEwtWkXaR13LNF0\\/v1wv7cWp\\/8ADZ\\/\\/AAVr8Ww2en3OkaP4q+INn4VsrW8ZEkiiimh00RsBgBtsLHGeAVzV39qzSbH47\\/8ABazxd4f0PVv+Jfr\\/AMULbw3Y3kTbPIihuYLSPYWz\\/qvLAB\\/2OMZrGINnpH\\/BxPq8lt+134R8MGyGn2\\/gX4ZaBpSw7h5sLm0MrxjuqKsyjb3ZT6V86+IPhxquqftreH\\/C3iTQ1i8av4r0zQ9S0XQ41ZII7b7LZrHEyuxeVkjYuBkBucnNe7\\/8Fp\\/EXiD9qT\\/guJ4w8EeGvst7qp8Rab4T0dI3jInuUtbS3VpHf5STIoBDcZyO9eZf8E1viff\\/ABP\\/AOCuXwu1zxi9zdPH44ufE+ptAsULecokuJZm5RFQNDvYggBQxHpR9klnU\\/theH7H9pf\\/AIOB\\/Euhxb7jR9f+KtloWFj2mO3huYLeQAYONqxMvQ8D0roPEthY\\/tq\\/8HE95ouv31vL4e8QfGV9LkOn4ZXtbe78uJA3HDR2sYLDuWNZP\\/BJTxP\\/AMLU\\/wCC4XhjxVcvpluH8Ra34pnkvrsMi7Y7q7ULJkhpDjHB+YZr5d+Gnxj1j4bfGu28a+G0tYtetZLi5tZUjSUm4cTu0i72J3p5nyyfeUqMZK4oSb0XYetj+n3w3\\/wSf\\/ZI+E\\/xj1X9ojw9oMCeI\\/Bmrah4nu7+x1+aa3t7uMTNc5i8wxrtYuSuBhgK\\/mq\\/au\\/ax8X\\/ALbX7QPi74g+MLrVNduNWMosnnmaH+ybMSvJbxKoG3ZHGrAJ1O0knNW\\/2ev2j\\/Gnwn+HfxiuNE1fVVHiXwxLpGtSxxNNavHfX9uj7x9yMld4DcHLY7mvAfFUOq+KdVmghdXsNOVGcoAqRCRi4DEDruduvTn0pxutWFz98P8Agz5+El2L34+\\/EBreC1sLm+07w3aRKAWjeFZriZAfRRNAORyT7V9uf8HHnjs+A\\/8Agjp8XsEiXWbWz0hCH25NxewIRn3Utn2zXiv\\/AAaM+Abzw1\\/wTc8Ua7exyxP4s8e6jeReZb+W0kccFtDuzgbgXSQe2CPUVg\\/8Hff7Q1l4F\\/YW8GfD\\/duv\\/iB4phkaGMhpvs1mhkZlQj5v3jwjqOoHeoesiuh\\/PHd+DdTTwJD4iaDytCW\\/k0tr0MuDdLH5zQKucswWRTn0219S+HvDfxD+G\\/8AwSNuLrVvs2n\\/AAh8XeLknYRSAv4i1QgRxed\\/HstorZ3EYGN0iswJIA8lgm1\\/4M\\/s5+ENTH2y5h1PxBqGuWtuLdmttLuLcQ2izJuXy5JSxA3YdV8ogYcEj6C\\/aI+Jt1ov\\/BA34NaYyaQlv4y+K2vaxbwWURWWGC2t\\/IZXLHLZklPzAkbdoJyMVq5dQ0R8jeGPhh4r8d+JpNH0nSvEGuatbxzCK3tIHMohiHmtsTjCqm9gFHAZjX1f+2x8PZ\\/hr\\/wS4\\/ZWtpY9Xsl8SPqurW9vqTPHJGFRfOeOIniOWadvmxlwqHpgV4Xon7b\\/AI1+Hfwf8I+H\\/C2rXOjXvhjVdR1Z9QSZJTNJciNFyCu4kJHIrMScqQowOv2B\\/wAHHXxO8Z698YPgBpHju\\/s9Y1DRvhNp+sOlvbi2gbULtpDcuY1wFBMEY2jAwnam5PoRsdUP+CZepeKv+Da\\/w18TdK0m3v8AxBp3ie48cJBBZ\\/6bDp7yy2d0XkDN5gMMVvKRtTaIcYJBJ8h\\/4N9\\/2wLb9j3\\/AIKS+B3vpIIdD8exL4U1UTW5MsRuyvkvvGdoFwkQPs5zXjPxS\\/a18ef8It4F+EsPi7WvDnw+0PwnpunTaNpF49ta3Ud7HHqFy9yPk8x2lm3ENkLt2g45rxr4G6tNL8avCUtncM1zNrdi9vFbhvtMMq3sQVO\\/zknIxn8+KUV7rUgb7H0H\\/wAFiP2gdL\\/aE\\/4KX\\/HbxVHZ3semDWl0mDcztLbratDatcNGew+zPhNyrmRMYxz5P+y\\/8Vofgp+0Z4K+Il7G+o23hLWrG7a2guJJZLye1WJkctgFUdkVh7AgcCrX7U+p2ur\\/ALcPxR8TzPpetaQfHl9clLmQtBqUTahKVT9yQXRlGTtKnaCRVn9kfwNonxd+J3iCx8QJqC6H4Z8K6zruphW8uW2ltLC4NuSvBO2TyUIGTljjAFGyEQfD9NV8R\\/tSav4s1DWLDTtW+x6v42vL3zgUguGsZbyIKW+8xkeOMDklnxX3X\\/waY\\/s8\\/wDCff8ABRmTxRqFqY4fh14NudVs33YYXF4y2UYIPO1oHuD+CnpivzY+GP8AoGn+MbyPy7eMeGLlP9UZkthNLBEqDIYgkSFQxx94fMM1+xX\\/AAZg6Al18V\\/2hNUyS1ro+gWkR2gApLLfOe3X90PzqJv3dBx3Pvv\\/AIOSPiUfhr\\/wSE+I8EV\\/HY3PiM2Wixb0ZjcedcpuiXAPzMivycDGea\\/mE034Gy6x8GvEPjiQeVpnhnXdN0qW5eUEo91HdTCNELBm2x2zMcZI+Ud6\\/oI\\/4O\\/PFFpo\\/wDwT78F2Ero11qXjq1aKJskuIra4ZiAD0GRnPqK\\/ErxD8PpfD3\\/AASo03X\\/AD3MnjD4qyxrbRqx8+HS9KUNKf4cI98R6\\/OfQVUXZFT3PLvD\\/wAPU1X4CeJvGc8bv\\/Z+q6dodusc6AK9ws85Z0zuPyW+BtB5Yk47\\/pd\\/wQBvvhDZ\\/sI\\/tdat8d7Iap8NtPg0U6raSxui3ZhNw8MUTqy\\/v2kKKqgg8rk4Nfl54t8EXfhf4LeGdbfUYZ7LxHq+oJHYo4JiezS2UyOBzk+eyjj+E8816frnxOudK\\/4Jy+D\\/AAhYrqtlpWveP9T1nVyZcW+qNDbWcVsEAPzCPM2QwOGINEk2iThv2h\\/G3hv4mfGPXtc8H+GoPBfhO8v3Oj6REMtY2gOI1c7m3SY5Y5PJNbfxt8XxTfs2\\/B7w7Fc6k40yy1bVLm2nm3Qie51OZQ8a5ON0MEIPA5B9a8r0PUG1Q3Q3wkRHZAoUjdgMMZ9ThT7mul+NXgOf4c+L7PRLmQfabbQNNuW8x12wm6tY7nGVZhgGfp7nIBzWjndaE27Hc\\/td\\/EDSr3wX8GvD2l2lnZSeGPh7Z22oCO4jnM1zPPc3rOSgG1iLlCVJ3LkKeQasf8FAfF3h3xL+0dPY6HqsPiTSPDvhzR9Ft9QDbYmNrptvC+1NoUBZFk+UcbucnNR\\/tXfBLT9B\\/ba1T4ceAViurC11Ky8PWDjn7bNsghMwZQT88mSSAe\\/rivKviog8PahqtqZ4rx4rhreWQ\\/N522QqcHtyMjocYpWbEzvP2TNJ0LxL8dfA1tf+IdN0C0OvwT3Wq6nGZLWy2SiYErnnITGCQMuK5L4t\\/ES4+MnjXxH4nvr+W\\/1bX9TuL25meMIJZJZGckEdFyTx2GBXHm2S08A28iss0kzvvjIz5eemP0+lX7XTobbRrCI3NsoKb2klR8LxkL8oJyScdPrVwui\\/I99\\/4JrfEDQ\\/gN8SfHXiPWbm18+w+GPiVdOaW88kpfXFqbOJQOd7MJnUL3D57V9J\\/wDBtl+zjb\\/tOftdfFfStS1gaFplx8NtU0u61GFglxbLdtHD5sbE4BC5yfTI718U+G\\/2Y5vG\\/wCzV4w+J9l4htlsvCes2GhXmlQpIbk\\/a4biaOcscIIs2rp1LFh0Hfsf2NP2lPFX7KnwU+LF54P1vSdK1zxvZ2fhWaeSB21KGzmMs0zWsgOyPiEI5YZw4296izZHUj\\/bn+Dnw\\/8Agr+0VrvhH4c+MW+IeneHZXt5Nd8pI4bl0HzeWQSGGcjIz071+8H\\/AAZ++HpbH\\/gnv4q1SSNsat44vnhYbdjKlvaRkjjPVT35r+a7R9WubfU\\/s67DncP3h5PXLflX9A\\/\\/AAbh\\/wDBSL4VfsffsDaL4S+JviHW\\/CVzf6tfajbXWo+G7qHRxBLcEq4vkjaNg23JaRlxwOgrOvKUoocY2P28U4XmgHNcP8Jf2lPAHx70yK98FeM\\/C\\/iq0nQOsmlapDdjB9QjEj8a7ZZBnj+dczTW5re+w+iiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigDjvjz8C\\/C37SXwj1\\/wT400i21zw14ls2stQspx8ssbeh6hgcEMOQQCOlfz3\\/8ABZr\\/AIJC\\/En9hfwLY\\/2TPffFr4H6LOIPC097JF\\/wkfgZ596\\/ZFnA8ye2BSPEex1O4lViZSzfv1+1N+1T4H\\/Y9+EGp+M\\/HuvWehaPp8ZIaVv3lzJglYYk+9JIxGFUckmviL9nD9nnxZ\\/wVV+Nel\\/G\\/wCNWh6hoPgHSEWbwP4SOqt5cZ3sRdyLGQGkddhZmzjCqmF8wvpC9uZ7B6n80\\/hS5j+H+tm5NnpNxrCxh5YrzZcR2hBIw0ch5f73yH7vHfmqd3qK2929nZukSXbfJCZI1dNwOGLFffJwR9a\\/sJ+MP\\/BLP9nj9oC4Wfxj8HPh\\/rdysjzefNo8STM7sWdi6BWJJJJye9Z+k\\/8ABIb9mTQ7qyntvgj8PorjTgBbSrpi74gBjg9enrW0a6SsTbsfyafAv4cWvxF8aR6Na+H\\/ABd4r1fVXh+z6JoliplvBI4KosxVjCDGdwk2MMLjBzX7Uf8ABKf\\/AIN6tZ8Vavo3jX4+eFrfwN4d0VoLjQ\\/AFhqLSyXEsaf8fGqSjBll3gNt3YBGNqgkH9hvh58CPBfwktVh8L+FPD3h5EiSAf2fYRQHy0+4uVAOFycDtk11WxY+eB71nKu9kO3cpWGlW\\/h\\/S4bW0ghtra2URxxwoESNR0AUcAV8MfHj4mr\\/AMFSPjVN8GPBt\\/Ivwh8P3QXx14ltLryU1y4ifcdGspAD5m0oftJXgK2zOTXUf8FJvjF4m+OOp3H7N3wj1SWy8e+KLET+ItXgyF8L6TIsvzGYZ8q4uDGY4sgkBmfBC19H\\/s3fs7eGv2Zfg3ofg7wzYR2mn6RAqMxGZbubA8yeVuryyNlmY8sSSamL5Pf6jWjP5h\\/+C+\\/7O978F\\/8AgrL460iXSZdI8OeJYdPvPDJdzFbXFqLKGEpEVGMI8Lpyfl28jkV6P\\/wb7\\/sDa7+2r+214f8AFOt6Mf8AhXvwevINUurny\\/Lga9iVXtrQNzvl85IpH2kqEj55kr+iv9o\\/9lH4fftZ+BW8OfELwrpXijSXkWTybuLJUr02sCGX3wRnNX\\/gL+zr4K\\/Zk+Gdj4Q8CeHdO8NeHdPDeVZ2iYXc33mYnJZj3Ykk1Xtny2FbW5\\/LV+wV8LNU+KX\\/AAXR8G6ULiTVbqH4t32q3s6xZQpaX9xczXAIztytuP8AHms\\/9izwFqv7RP8AwXO8MzaQnGp\\/FW41t3EK7Ikg1Sa6mIjbG35I\\/unkA5r+ln4T\\/wDBLz4FfBH9oe\\/+KfhX4eaPonjjUJZ55dRt3l+WSfzPOdYy5jVpPNk3EKM7jWf8Nf8Agkr+z58Hf2lf+FueGPhno2iePfNuJ\\/7RtZJkAluAwmkEW\\/ywzB3yQv8AGfWlzoZ\\/Mn4W1jUvEn\\/BWzVviTeWmqSCy8YeIPGd1NZh5prVbD7XfE712nMX2cbiOcZIHFc9\\/wAE7PhNr3iL4yfES5to7K417wh8N\\/E+o3S3++SOAjTZYDKJEBAkDSZXJA3EDPPP9Knwx\\/4IL\\/s0fCb4xaz420rwNcvqWuWF7p1xa3mrXNxYpFexSQ3eyFnIUyxyyKx\\/2jjFdl8HP+CRvwB\\/Z88M+L9N8I\\/D7S9E\\/wCE50+90rWb6Fm+3XlrdOzywmYksqgsNoUjAVfSjnRLR+Dv\\/BrT8ID47\\/4KcB5g2o6N4c8H6hqM6pgRFp447VFlQ5J+WSUDr196\\/O3xd8P0sZ9VVGEFvbXDrLvIh+yyCUqYfm+YkGQA8dFPZef69\\/2Hf+CTPwO\\/4Jz+Idc1X4UeFZdAvvElpDZ3801\\/PevMkTMw+aVmK5Lc4wDgccV87fHv\\/g2L+AP7QX7Vt38UL688X6UmrXv9p6p4fsbtBp+pXLXDTzM5dGkVJSxDIrAckgiqjVSbYWZ+KvwF\\/Yn1pf8Aghl8cvi8LRRps2v6JpllMICktzZWV45uJ8kn5PMuIQTgf6s+lfGmnwX0GkagbdYnzPDdyyykDLJmKPcxIXAM3Tvn2r+0TVv2QvAt5+y\\/c\\/B600HTtN8BTaM+hxaXb26eRbW7IVG1WBBYE7skH5hk5Nfl38f\\/APg36\\/Y6\\/YY\\/Zbk8QfGLxR4o1C20pGWXUGuY7e81YpGzRWlrbxrjzMKWCpkttYscFqFVXUdj6Z\\/Yl+Kvgf8A4JXf8EYPhPqvxAit\\/Bkdr4at7260uOJhd3mpXX79oI4iTJJcPJIcjnnOcKOPxF\\/4LpftEfGD9p74teEfE\\/xS0600Kx8RaLc6j4M0FiXi0HT3lRFkUfK8k8mzLSspUjhRtXI\\/VP8A4J6fsV+Ov+CjvxZ8M\\/tF\\/HL7bpPgjQtIh034f+ALu3I+z2i7GS4uRKCxdgqbnAVpSoPEW1W7\\/wD4K5\\/8EGfBv\\/BQn4v\\/APC0fEHxMuvh8dF8NjSJW\\/s6CW1t7eN3lM7O7rtI3HnIAUUJxUtS9LWP57v2r77Wrz4DfAWxu7iGdrHwZe6ms4yJbv7R4g1QgMf4s+WMcZzIeTxXu37anwd8W6X\\/AMEb\\/wBk3WtUh\\/svS0vtVstG02SNYppobrzLx7wFlDHeNi85GEUjhsn7l0v\\/AIIAeG\\/+CoHjbS\\/EnhzxJrvw8+E3w98Mad4E0G4vNAH2\\/wAVfZYi76pFG7KsUbvO2DglmDNgHp+k\\/wC2X\\/wSN8B\\/tkfsJ6B8DdTu7\\/SbDwbZ2UPh7VrdVe602a0gEMUvP3gVGGXIDA0nU5dGRqfzOf8ABMn9mbR\\/2zP25vA\\/w5uND1HUPDviTxEL3UI7SaP7eNLi8ySSIyeZEgj27PMIVmwp24xtPrv\\/AAcReFf7Q\\/4LAfEDwzo9rNGBFoOmWMTs5VN1jBGNjMeAOOBx1PUGv2h\\/4I6\\/8ECdH\\/4Jh+N9d8Ya74msvHfjPUDNb6ffRaUlpHpdrIRuVAxaTe2ME79oXgDqTzn7Uv8AwboWP7V\\/\\/BUO2+POv\\/ES4Phf+0dP1W88MyWJmluZLPy9kAmL7VgYxjI29GYDrmjnV79Atofit\\/wXM+DFx8Fv+Cnnj3w9LYadpel6ZYaHbaVbacxZIrWPS7eGBTnOJNsOT2zz3qP\\/AIIO\\/sZv+0j\\/AMFNfhf4fmMj6X4avx4q1SYws0Zjsj5yQkggAtKIx16EnnGK\\/bf\\/AILR\\/wDBAS6\\/4KY\\/FvQPiL4P8cWvhDxbpllDpN5a6haedp99bo8zLKTHiTzl84qMkgqAOMCvQ\\/8Agjt\\/wRR0j\\/glfp2vanc+J5fGnjXxXFEl\\/eG1Fva2Kj5nhto8nCM20kt8x2j6U\\/aLlEkfy8\\/tEaDNa\\/F34h6SbS3PneM7qGS7VPLMKwXVyrIFA+VW8xT8oyPLHY19i\\/sY\\/s36h8N\\/+CYn7Rv7Sc8+mTTatpieA9Nkt3E95YS3N6kV8zwhSg3QPGAX5KuSMHBP6Z\\/8FCv+DaKP9on4yXuqfDSTw1oFvrs2p65qGpa3c3U1xBqV1NbsI40TIa3Ci8faSMNPjtX1V8Qf+COnhdv+CT2rfsw+Bbu18I2+p6XDDNqyWgkN3fI0UklzKrZJaV4huOdwB4PApOorBY\\/mL8CWVpH+yJ8aNWcCS++1+HdOt7kIgId5ppdqt9\\/54rdiwHHyoTk9P2C\\/4MvtCurT4V\\/Hi7l01Utn1bR7WPUAxLXEkdtO7xnP9wTIc\\/8ATXHanR\\/8Gn3jDSP2RNY8GQfE7wzf+L9W8ZWmuPqEthLBatY2trPBDDj52WQNcSOcAg8D3r71\\/wCCJ\\/8AwS1f\\/glp+yhc+ENXvdL1rxfr+sXOq67qlgrCG6O7y7dF3ANtSBU4I++0h70SlFrQSjZ3Pzw\\/4PNfiiiaP8CvAgjXzbq91DXpWK5ZFjRIV5z3Mjcewr8mPjvr+p6d+yD8BNElu7t9PntfEPiBYJFRIlefVmtiRt5fcLJclunIHAr9j\\/8Ag5m\\/4Jo\\/Hb9tf9rP4aa18MPAupeMNC0fw3cWk0kN9FHHaXH2jeVKyEbSybcHvj2r4n\\/4Kcf8ErPi78Jh8BPCWk\\/CPxx4k\\/4R34Y2VhezeHdKk1C1\\/taS8ubm7RpIwSD5kpJzx83HFVFqw53Phz46+A9U8IfBb4MjUlHneI\\/D974igUXkkpENxqNxCjNEwCxFhalvkzuUqTg13H7WP9laf+y\\/+zRolss8Ulp4NutQvnMqyR+fd6pcuJAq5APloM87vlAYKRivp\\/8Abf8A+CNv7QmkeH\\/g6mhfDbx74jbTPhlpVtdQ2OnNKmi3jPdzy2O4EkupmYtkYUnGc4B96\\/4Lr\\/8ABJr4gaD+yL+zd4r0PS7nULP4ZfD+x8Ka5YRxySXkd1hCCsKKQPnZwTu5PHJxlxavYhXPxq+F\\/gjUPEOp2eh2sZlv9c1CCys1jkxJJLO4jQdDzll496+ov+Cq\\/wAKofGn\\/BWzxj4E8JX9\\/rl2db0zwrFNKjSyrdR21raNEq9XCyKyjAAIHFehfsKf8E5fjNN+3v8ABa11b4ReOdL0o+KNJutTubjw9cWsWnW8U0dxIXmK7EKxhXJz0YDrkVF4q\\/4J0fFn42f8FKvGS2Hw7+LWhw6v4t1nUbW\\/ns3iuI2hknmjdLpgqbmMa7XBON6nJxVx3aQ+lz5z+Anw8+0\\/tteE\\/C8mqT215L45gtG1y5Z7WRDFeANJjJIkYpwC2Qxx7jkfiPZ2Nx4m1qa3tZVtjduPLunzK5y3zMcnknjGTX2f\\/wAEiP8Agm58UfE3\\/BT74WL4i+HPjTSLXRr1\\/EN5NrWnz2cCJbxu6M0rggkzGMbc7jXhX7RX7Efj34ZfF\\/xNoV9oUs+saYb3Ub6xs2aa5ihilPnM64LBULDnGCu1gSDxUOqI16nkXhBrfw9pHip\\/7Gm1GI6Z9ngeSFGXTTJcQjzWyrDdsEkYKlWDSjDDHPI620XnRiKHAIIXI+6a\\/Un\\/AIIlfsVr+1d+yl+2VYReFbbWfGdh4Y0yw8P297AFljunN3cDY0vCndFFz349q\\/PTxV+z54g8JfEpPDl7pd5P4huJBFHp8NrI7SysOEQAEtlsLkDqRVxkpK\\/YvZ3Ol8G\\/E630H9inxh4dg0ETS6\\/4usp7zUQJEt1S0sZxAow3lllNxctt25O9WLDaoPaeFPh7daZ\\/wTAbXZBokVj4n+JE8cJXi\\/JsdOVCjk8GPN4pVQM53HIzX0F\\/wUv\\/AOCdWn\\/8E5P2FfgR4X1mfPxU+IN1qGv6\\/pyp5i2rTJbRRwwqFz+7VEQ4OS271rD8Yfsr3ekf8ELPhL40WHXrz+3vHGu3Sp5Oy2slkEUSOxcDlxZ8OPUjNTCza8zOWiufn7FpS6Vq096\\/77Yhbbnlfav7Af8AgjZ8ENGg\\/wCCSnwF0fWNI0vUkPgyxneO6to51\\/fp55+8D\\/z0r+SbT\\/Cj+JvFNpoNm0J1LWLuOxtwx3YllYIike7FR7ZzX9tP7PngaT4Y\\/BHwp4blWzWTQdJtdPYWkflwZihRDsXJwuVOBXPWdmrGyWh8+fFr\\/giP+zl8Utautai8CR+E\\/E1w8kw1vwxdzaRqETuMErLAykD\\/AGfu+1edv+xZ+1h+yijXPwr+Plx8UdGsY0aHw58RYIZ5ZgrvmFLyNFlGVK4kdycryDX3zSFd1Sq015+ocp8L\\/DD\\/AILZeHfBXimw8F\\/tDeFdZ+A\\/jiXEZfWE3aFfvype3vASNhYEL5gXNfbXh\\/xNYeK9MhvtMvLXULK4UPDcW0qyxyqeQyspIIPtWB8YPgX4O+PHhG40Txl4Y0XxPpdwu17bUbRJ17jI3DIPJ5GDzX55WcHiH\\/ghr+0ho+lwT6pr37MnxM1iLTNOt5S9xceBdRnbCxqxPNqxx8p6Z46HNNQmvd0Y\\/U\\/TuiobC8W+tI5VOVkAYfjU1YDCiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigBCcCvNP2r\\/2qfCP7HvwZ1Txr4zv\\/ALFpVgqxxJGhkuL64c7YreGMcvK7EKqgd\\/QE1o\\/tG\\/tDeF\\/2XvhBrfjXxhqKadoOh25muJApeRz0WONBy8jthVQAlmYAda+D\\/gF+zz4k\\/wCCs\\/7SOk\\/HL4tWKWXwj8MCO6+HvhOQNuuHkQMby7GShl27BheEIKggh6uEL+9LYPMg\\/Zo\\/ZL8d\\/wDBU34pWHxu\\/aK0yHS\\/Cmk3v2jwL4IX7unQhgyy3BxiWRxgM\\/cKVXCk5\\/SvT7GPTbOOCGNIoolCIiKFVVAwAAOBTrKzj0+1SGFFjijAVEUYCgcAAVLTqT5n5AFFFITgVmAFto5r5k\\/4KAftvX\\/wMj034f8Aw30+18W\\/GjxsRbaJoouFX+zYpModUulwSLWFipbj5unqa7n9ub9sHQv2J\\/2e9X8Zaun22+QfZNE0mMnz9d1F1PkWcQALF3YdgcAMe1eWf8E3f2Qtd8G3Os\\/GL4pudT+LvxKWK7vvP2yr4etvLASxtjsVo4x1K888EkjNXBJLmkB3P7Fn7CuhfstaEdWvZpPEvxJ8Q\\/6b4q8UXTu1xrV+6IssuCSETKYjjUBY1yFABOffAMCgDApah6u7AKKKKACiiigApGUOOaWigBNuaXpRXJfG\\/wCNHhr9nz4Y6x4x8X6xaaD4a0C2a7v765fbHBGuPzJJAAHJJAHJoAx\\/2of2qPA\\/7Hfwg1Pxx8QddtPD\\/h3TE+eeZvmmkP3Yo1HzPI3QKoJNfnp+x3+zZ49\\/4LCfHc\\/tD\\/H20udK+FOkySwfDb4fyFDbzW+9Qb+54y\\/m+WP7u9SRzEcNR+DHwZ8Yf8FxP2qtM+MHxJsdc8KfAf4cX11D4T8HXymGTWrgMYxeTptDKSuSSSwAYIuMOx\\/VKysrfQbBLeCOOC3hjCRxxqFSNFGAoA6ADFU\\/d9SnZLzHLDBpcB2KkUcacAfKqKP5CviHxzr+sf8ABV74py+FNAla0\\/Z68NXph1\\/XLLUTHN4yuFRg1lF5ZyLZHYbySNxToVxuf8dvjX4l\\/b++Ouo\\/BP4W6rrnhnwl4Uu0Tx74wsykX2hMsr6fZSMj7n3qVdxgZWRQflbP2F8LPhbovwc8D2Ph3QLGHT9M06MRxRxqFz6s2OrHqTVr93q9\\/wAiTU8NaBbeFtEttPs4Ut7SziWGGJBhY0VQqgfQAVfoorL1AKKKKAAUUUUAFFFFABRRRQAm0UjR7h6U6igBvlL6UjwK+MgHHY0+igBixAUGFSeg\\/Kn0UAN8pc5wKzLjwZpUusS6l\\/ZmnnUp4RbyXX2dPOkiBzsZ8ZK8ngnFatFFwMbQPAOjeF9R1C707StOsLrVXR7ya3t1je6ZFCIXIGWIUADPQDFcjbfsi\\/C\\/TPi7J8QLX4eeDYfHUoIfXk0mFdQbIwczBd+ffNej0U7sDmvG3wf8LfE6GBfEnhvQteFtnyRqNhFc+VnGdu8HHQdPSsvxV+zb4G8b\\/CGbwDqfhbRZ\\/Bc1t9jOiraJHZpF2RI0ACAf7OK7mii7A8H8I\\/8ABML9nvwNpvh+1034O\\/DyFPCrxyaU7aJBJNaOjb1cSMpcuG+bcSTnnNe7ogjGAMClopAFFFI77EJ9KABjtXmvzV\\/4ORPjbpx+AHgT4N6Rc2c\\/xG+KXjDS7fRLN3XfCEnUm4YHO1N5Rc\\/7Rx0r1z\\/gpr\\/wWP8AB\\/7CX2bwd4esJPiV8aPEW2HQvBWkyCS7eRyAklxjJjj3EdtzdhjmvPP+CZf\\/AASq8U\\/8Lqv\\/ANpn9pue18SfHjxJMZ7DTUfzdO8FWxXZHBAuSvmqnBYEhckDklq0haL5mB96\\/DrSrjSPBemW90QbmGBFlx03Ac4rdpFG0UtZgFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFY\\/jnxrp\\/w\\/8L3+r6rdQWWnafbvcXE8rhUiRQSzEnjAAqx4o8T2Hg7QLvU9Tu4LGwsoWnuLidwkcKKCWZmPAAAJJPpX5nap4p8S\\/wDBc\\/47Xmj+GfEV1pH7LfhGdrXUb7T1aOTxtdYXdHucA+QoPy4BDcseNudIQ5tXstwF+GPgvxF\\/wW++PyeP\\/Ec2o6N+zn4J1EDwnpKAxHxRPG6lr2YHDDJHyHHyKTj5mJH6ZeH\\/AA5Y+FdGttP061gsrKyjWGCCFAkcSKMBVUcAACqPw7+HWjfCrwbp+gaBptnpOkaXCsFta2sQjjiRRgAAVuUVJ82i2DpYKKKKzAK5\\/wCJfxL0T4S+CtR1\\/wARarYaJo+lxeddXt7MIoYF45LH6gAdSSAOTW7cTC3hLnoOea+CPE6WP\\/BYb9pPSrS0tZZ\\/gZ8HNdn\\/ALdi1jTJktvGWrxFo41ts7Vlgt3STc7FlLOMLxuqoxu9dgJv2Y\\/hJrP\\/AAUc\\/ajsP2kPH+n6ppvw88OxiL4XeE9UUBkBUiXWLmHb8s0jqDDuJZY8HjNfeMMfkx7araHotr4e0m3srG3itLSzjWCCGJAqRIowqqBwAAMYq5RKV\\/QAoooqQCiiigAooooAKKM5pksohXLHAoAo+KfFVh4K0C71XVLu3sNN0+F7m6uZ3CR28SAs7sx4CgAkmvyq1C213\\/g4O\\/aXtpIYdW0z9j34dTLJDeG5e3f4garHPC5kVEYEwKkckeJAPL8wvjzGUR9H+1F8RvHH\\/BZf9pLW\\/gR8NrlNG+BngHV4oPiD4qSUSHWpY9rnT4ADym4YI5DFSThQA\\/6J\\/BH4J+Gf2dvhZovg3wnplro3h7QLZLSytIRhY0UdSepYnJZjySSTyat2jvuPQ1\\/A\\/gfSfht4XstG0OwtNL0rTLdLa1tbeMRxwRIMKqgdgK+SP2qf2kdU\\/a0+L5+APwi1q6tp0uPJ+IHifTJCj+HbIGLzrS3mwVF5JHNw6ljFgggMcrP+2R+2f4l+IvxPuvgJ8B\\/MufiTcRqmveIfJL6f4KtpBkvI\\/wB1rnYcqgOV3KTkkKfZ\\/wBin9jHwv8AsT\\/CGLwxoCyXl7O\\/2vWNYuQDd63eNzJcTN3Zmzx2\\/M0L3VeW4jof2a\\/2Z\\/Cf7KfwtsvCXhDTYdP0y0Jkcqo8y5mb780hH3nY8+3QYAAHoNFFQAUUUUANL4cDBp1FFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABSE4FNlmWFcscADJJPFfCP7WX\\/AAXg8B\\/DT4ty\\/Cb4P6BrPx3+Mc2IIdE8NqJLGznJxturzPlxhRktgnGMEg07NgfZnxW+L\\/hj4IeBNQ8TeL9e0vw3oGlRGa71DULhYIIFHcsxA\\/qa\\/M34i\\/8ABSD9oX\\/grN4mu\\/BX7G+iSeC\\/h1b3T2esfF7xHD5MEqdD\\/Z0LAu5Izh9pOcfcHzV3nw\\/\\/AOCTHxA\\/bx8Xad8QP20fEdt4i+xyrd6N8L9AmeHwzoR6gXJzuu5exJO3jqRX6E+F\\/CWm+CtBtdL0mxtNN06xjEVta2sKxQwIBgKqqAAB6AUKwHy3\\/wAE7P8Agjn8Lf8AgnmbnXNOivvGfxK1gtJrHjXxA4utWvZH5fY5H7pCcnavJzyTX1qq7RgcUtFIAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigBGGaUdKKKACiiigAooooAKiup\\/s8ZY9O9PkkEaEnsM18Bf8ABRz9sjxF8avicP2ZfgtczyeOfEFuV8Ta1aOoHhWxdcfePAuHBJXg7VBYjpTjFt2QLV2PP\\/2yvip4k\\/4K+fH69\\/Z++Fepapp\\/wt8MXYj8eeLLBoWttRdeTYRMcs0asAJCvDMCmDhiP0Q+B\\/wY0b4C\\/DDSPCuh2sFrp+kwLEoiiWPzW\\/ikYKANzHJOOOfSuS\\/Y2\\/ZF8L\\/sY\\/Baw8HeGIXW3tgHnnfHmXMpHzMcAADPQAYH1Jz65V1Jp+5HZDfkFFFFZiCmyNsQn0pScCvmL9v\\/APbR1L4Qalofwt+HFquu\\/Gf4jxvDolpjNvokBPlvqd42GCQRE5AYfvGUqM4NNK7sgPNP23fj54k\\/bJ+NEP7N\\/wAFfEE+myNJInxI8W6dHKW8JWojDraRTLhFu5umA2UUHO0kV9b\\/AAG+Bfh39nL4VaP4P8LWCafo2ixeXDGuSXYks8jE8s7uWZiTklia89\\/YQ\\/YxsP2Nvhdc2QvbnWvFPii9bWvFGr3GzzNS1GUDzZPkRAF3ZwNvevdKHL7K2AKKKKQBRRRQAUUUUAFFFGcUAMdhEtfm\\/wD8FKv20vGv7Tf7Q+mfsn\\/s7avEniy+ld\\/iB4jhmATwtpyIjS2+7g+a6yx7vKJkQOqjaz5X1T\\/grf8A8FF9W\\/ZP8KeHfAHw20yTxP8AGz4pT\\/2d4a0y3QSmwj3okt9Ku4YWMMdmeGcDPyq1dF\\/wS7\\/4Jr6P+wN8Hmjurga38RvE9w+seK\\/EUiAXGpXswDSKWHLRqxONxOSWY8nilpqx6rU9W\\/Y6\\/ZI8LfsW\\/AjR\\/AvhW2ijtNPiDXNz5SpNqVwQBJcS7QMu5H4AAdBXif7d37avi4+P7H4I\\/Amztdb+LmuR+ZqN1KxW18JWJUlrmSTY8YnIA2I\\/TcrFWyiSVf29P28\\/FCeP0+BnwDt4tc+MetxbLrUmj83T\\/BkTbSZ7hsFPO2MWWNj6E5yFb1T9hv8AYS8O\\/sYeDNTis57nXfFHiO6e+17xDfsZL3VpWd3G9iSQq7zgA8ksx+ZmJrlUVzSFe+ppfsR\\/sZeHv2MfhRHomm79S1u8Juta1q5Je61a6d2kkdnYltu93Krk7Qe5JJ9npsUQhTC9KdWbbbuwCiiigAooooAKKKKACiiigAprtsXOCfYU6igDzb4lftd\\/Dz4MfEHSvDHjDxLZeFtV1xA+ntqwe0tL1i23yo7lwIGlzj90H38g7cGvQ7S+ivog8LrIjZwVORxwapeKvB+l+N9CudN1fTbHVNPvEMc9tdwLNFMpGCGVgQRj1FfKnxC\\/4Jl6v8KRc61+zX8Q9Q+DGtyyvcT6JLEdW8Lam21gFexlY\\/ZzuZmL25TJYlg3GDQD6+or4Nuv+CpHxF\\/Yjg02w\\/ao+GN5o+nsNlz8Q\\/BUcmq+GAc4Dzx4+0WnXncrD0JFfZnwo+MXhf45+CbHxJ4P17SvEmg6lGJLa+0+5WeGUEA9VJwcEZB5Hem1YDpqKKKQBRRRQAUUUUAFFFcn8Y\\/jd4T+APgO\\/wDEvjLxFo\\/hjQdOiM1xfaldLbwxKP8AaY9fYcn0oA6tnCjn0zXz1+3T\\/wAFOPhR\\/wAE+9AspfHOtyS67rJ8vR\\/DelQm+1rWZCQoWC2U5PJA3MVX3zxXy74p\\/bt+OX\\/BUybUvDX7J9ifBPw4aQ2d98XvElk8SsPlDf2Tat88zY3YlddvsDg17x+w1\\/wSD+G37GGr\\/wDCW3D6l8RvizfKTqnjvxRO1\\/q107cv5RcsLdCT92PHGMk0PQD58PwQ\\/a3\\/AOCuFrcn4m61dfsw\\/BG\\/uC0PhbQfm8Y65ZnICXt1uK2oYY3IoJ5IK8A19rfsffsMfC79hH4aJ4V+GPhLTvDWnFhJcyxqZLvUZccy3E7Zklc+rE47YFeuBQvQUtF2wEA20tFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABSHpS14d+3x+2toX7EPwQn8R6kst\\/q1\\/INP0PSoF3z6rfSA+VEi9cZ5Y9lVj2pxXM7IDzj\\/AIKYf8FCIv2ZtAtvBPg+TStc+MfjGIw+G9BknYPIXdYvPkCqSEVm4HG4jAI5I6D\\/AIJv\\/sFWP7H\\/AMMp73Vv+Jr8SPFkh1HxTrUlxJcNf3bks7KZOUHIGFAHy9MAV51\\/wTU\\/YQ1bRtbl+OnxcNvq\\/wAYPGdus1w6u8ltpcTZZEgR1XywEKKF2gqFOSWdiftwDFXNpR5F8xtWYbaWiisxBSE4FLXBftK\\/tH+E\\/wBlP4O6z428Z6pDpWiaND5kkjn5pnPCRRr1aR2wqqOSTRvogOE\\/b3\\/bt8N\\/sOfCpNT1INqvibXphp3hrQLY5u9ZvXwFVV6iNSQZJMYRck9geK\\/4J3\\/sZa\\/8Mta8TfFn4r3Mes\\/Gf4iSKdUmS5NxbaHZRsTb6bacACCLcTnGSWJJJNecfsDfszeJP2nPj1d\\/tQfF+xs\\/7V1y1SLwVoZmmlHhXTiD8mGPl+Y4IZyo+ZiecKtfeYXbWs0oLkj8wDFLRSbxnHesgFooooAKKKKACiiigArxj9vL9s3w7+wr+zbrvxA1\\/NydPTydO02JwLjV7xwRDbRA9WZhyf4VDMeAa9W8VeK9O8EeHb3V9WvLbT9M06B7m6uriQRxW8SAszsx4CgAkk+lfmB+y7puq\\/8ABbT9snUfjT4tg8n9nz4XX8ul\\/D\\/Rbm1UjxFcLJ++1CRjyFLRREDoUYR9DIGqKvqxxtfU9E\\/4JN\\/sQ+MfE3xB1L9qD49Zufi94\\/tfM0zTLhPk8IafJgrbxIw3RsUCDbn5RnPzO9dp+3p\\/wUO1eH4lQ\\/AP4FxDxD8Zdcty19dW7Ryw+DLVmRWuZwTjztr5RGwo4ZjjAbM\\/bV\\/bx8T\\/ABF+LVt+zz+zncw3HxN1NYpNa8TLCl1p\\/g6xOWeVjnaZ9qgDIIUuBhnKpXrv\\/BP7\\/gnN4R\\/YY8IXZtJLrxD4118CbxB4l1EiW91Odm3v8+AQhclsdXYl3LOSx1dl70\\/kgk7u5pfsE\\/sJ6F+xT8OZraK5udf8W67IL3xD4hvjvu9WuiBuZm64yPx6nmvfMYopqv5g4rGTcndiHUU1TgYJ5oOVPc5\\/SkA6imum7nnilDhhxQAtFZHi7x9ongDSpL7XNX0vRrKL79xfXSW8SfVnIFfNPxo\\/4LX\\/ALNXwOuLO2vfihoniK\\/vrhYY7Pwvu12dAzbd7raiTYgPVmx7ZoSb2A+raKisroXtssq\\/dcZGR1FS0AFFFFABRRRQAUhG6looAzdX0K28SWlzY6hZW15Y3CGOSGdBLHOp6qyEYI9j1r4F\\/a9\\/4Jt+Nf2T9bvvjP8Asha5aeBPEVm0mo+I\\/h\\/OxXwx42UfO48kkR2tywBAkQKDwPl61+heKbNEs0ZVgCO4I60AeN\\/sGftn+Hf27f2ctH8d6CTa3Eoaz1nSZji60HUYvkubOdTgq8cgI5AyMHvXs9fmN8VLSx\\/4Jl\\/8FxvAPiLSLa18N\\/DH9qWxuNA1+G3by7RvEcBMlvctHkIssgZFLgZbc+eTmv03ibdEp9hQ9wHUUUZoAKjnnW3TLHA9TXzZ+33\\/AMFV\\/hT\\/AME+NFtovFGpz6z4x1VhFo\\/hLREF3rOrSsQERIR9wEkfO5Vfc18w6Z+zR+0\\/\\/wAFfVTUfjtqeqfs5\\/Bh2Ij+HXhe+ZfEHiGEk4OpXo\\/1aMP+WUY5HDKOtOz3A9G\\/aj\\/4LW6bo\\/x7k+C\\/wA8Fat8efi7GsqXttpE6Q6N4ekTI\\/wBNvHxGuCDlQeowWB4rkPgF\\/wAEYfEf7RfxEsfir+2R4vf4seMrV1udK8Hw\\/ufDHhj5tyxiFCFuWXgFmGDj+Lg19q\\/swfsifDn9jT4aW\\/hH4a+E9J8KaHbgExWkX725fvLNK2ZJZD3d2Zj616TjFO9lZAU9E0O18O6bDZ2Vrb2dnbII4YIIxHHEo4Cqo4AHoKudaKKkAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKr6nqcWj2MlxcOscUSl3djgKByST6UAct8dfjh4e\\/Z4+GOreLvFGowaZomiW7XF1NKwGAB91QfvMegUckkAV8QfsX\\/BXXP8AgoT+0g37R\\/xIj1S38MaXK0PgHwtfRqsVjGFCm6dcfNIxGdx6E7RwOcZrG+\\/4LN\\/tRSfbX1Kw\\/Z8+GV8k9lELNFi8ZajE5AuBNkSCFTkR7eH2lv7pr9HtG0W30HTYLS1iSC2to1iijQYCKowAPwraypqy3AsrGFFOoorEAoJxRXHfHv47+Fv2afhNrnjfxpq0Gh+GfDtq13fXkoLCJFHZVBZmPQKoJJ4AoAh\\/aF\\/aC8KfswfCHXPG\\/jTVrfRvD2g2r3VzPKwBIUcIgz88jHCqg5YkAV+fHwD8J+O\\/+Cx\\/7UNh8T\\/iFp914b+A\\/gHUZh4V8LLePBd3V8gTbc6hGBhpdsjDywf3JBXO8PjmPh18H\\/iF\\/wAFz\\/2htL+K3je68SeAvgf4E1mK58FeGoy1pc6iE2t9uuSMEzSqx24OIUbGCxNfql4Y8N2nhPRoNPsYUgtbcYRFHA7k+pJOSSTkkknmrTsjT3VHzL9papY26xRKqRoAqqowFA6AVJSZpagzCoI7JIbqSZV+eYgsfXAwKnooAM4orwv9r\\/wn8dfF+q+Gh8FvHHgzwgNOuGudci8Q6A+ppqcWB5cKMkqNECQ24hc4IwwxhvhX4s\\/8Fo\\/2l\\/2HfippXhf42fB74X+K9Q10ldP0j4ceI57nW7lQcGcWsiyMEwVPzhB83DHBFO1wP1dZwvWkWVWOAa\\/Cf4nft2\\/Ef9vn9rTw54K+OfjrxX+yZ8LdcYnTdGhs59Pm1qYtLDCv9qkKZCZBE5YqkADBRuOHb9d\\/2Hvg\\/rfwL+BNl4f1z4kav8VpYbu5ltfEGqTLPdzWzyExxySrgSlBkbsDrgAACm42Wo2mnZnsdNlfyx+OKdmvir\\/gtH\\/wUyg\\/YI+BFvpWhXVr\\/wALM8fM+neHYpZF\\/wBBHCy3zKfveVuXYn\\/LSQovTcQRi5OyEeNft9fGyP8A4KTftcP+zf4e8R3eifCP4cKda+L\\/AIltZhBbFo2Uw6Qbg\\/KCSGZ+fvKo5CtXin7XP\\/BY34V+L\\/COnfA74M\\/FHR\\/hx8O7R10zU\\/GHlXN5cXsGyXzYbWOFTMdzBQ0xKsxc4OMk9H\\/wT6\\/4JKeNfjz8GvC2meP31bwV8G1ntvEGp+HZxJBr\\/wAQ9U+WSa\\/1WQOHVHmUbYmAKxovyhjvP6dfCv8AZK+G3wa8M2uk+GvA\\/hnRrC0QLHFb6fGM4\\/iYkZZzk5Ykse5NaNxg9NWHTU\\/Pr9kD\\/gpb+wh+wX8PptE+GOo63em7WA6jfad4V1O7u9TZEWNJXkMOWGSRgdGLcck16xc\\/8HGH7Oklg9xYj4n6lHEnmMbfwPqB+XcEyN0a5G4heO5r7itvB+lafEqQabYwonRY7dFAOc5AA9eaSTwjYSwSRfZoPKlRo2UIACrdR7ZyahyTd2NW6nwwP+Dh74Rak0kWi+A\\/j3r94knki3s\\/AF2CzZ2kbn2qOeOSKw7f\\/guR8QfiOZV8AfsefH7XCCgifVbKPSY2LOF+Yvu2dc8nGASTxX6B+FfB+neDNLSy0yzhs7RB8sUa4GeOT3J4HJ5q48YhQ7B9B2NK6Efm\\/pX\\/AAUF\\/b38c3qf2T+x54d0WC5neKEa34tEbxLnAeUqAFGPQHPatux+MP8AwUf8ZaYjD4U\\/AHwhNMGJF3rdxfNAFwOQjgFm5wOnqa\\/Qpo1c\\/pTiM0X8gPzlj+CP\\/BSD4rXSRaz8Y\\/gh8PbDzIkn\\/wCEf0CW9uNmP3hUzhhk44z\\/AHj6VHF\\/wRi+O3jMTXPjf9tv403F7Mipt0HGl26DcS3yI4HIOOgxX6PAbRXiP7eP7dvgn9gH4IXHjPxjPNMZZFsdJ0q0Aa+1u8kyI7eBSQCxPJJ4VQSSAKOZ9A3PzB\\/4KSf8E0PgL+xd8PYPEvxX1\\/4vftFfE7xZM9n4W8Lan4hnc67f8u2Il3MkKLtLsWO0ISPmavVv+CXn\\/BF+y+FPwRuPH\\/xw8J2yeJLm2mlPhDTD5traWsWDbxZGZWKpFGUh3kKxJbc7E1tf8E1P2L\\/H37Zf7Qd5+1X+0lp0K63dSGDwL4VM63FloGnqVaKVV5G7O9lfcfM3iQ4+UV+nK2yrFt7Vp7SSVrlbaHzT+xd\\/wUg8MftOeKtU8HXGiXvgPxbooj8rRtWvbZ5dRhw6tLamORvOjjeKSNzgFWRgQMV9MRuJFyDn3r4l\\/wCChf8AwQ2+HX7cnjCXxtpeua\\/8MPiUbdIP+Eh8PlUa52HKGZOGLDLDdG8bkMQWI4rwPwn+xj\\/wUU\\/Yj0lYvh98cvB3xr0GwIhg0XxXZMLl4VAEe15HVgcDDZusdxmlyxl8LJR+rFFfmWf2wf8Agpfo0Nwjfst\\/CzXXEreRNF4ngsC8YY4LRNfSAErjgSHGeprJvv8AgpX\\/AMFEfAc0\\/wDwkP7Eui6kJx\\/oa6J4qjm2sCMiRkkmXGOhOyp5GB+pLZ28UKfl5r8rLX\\/gq7+31dOZT+wsyRjBMDeIyJW+jbNvJ\\/LHPUZ0bX9vv\\/go98R9PSfw9+x54K8NLOANviHxWhmi5ALlPNh45zt+9gc0uRgfqFmlzX5lr8a\\/+CpdyfK\\/4VF+zfAAozL\\/AGjOxzjPA+24PPBzjrx61Vsvi3\\/wVU8S38dvJ8L\\/ANnLw3bhxvuvtst05UKScJ9sxyQB1GM+1LlA\\/T3NZXjPx3ovw78N3esa\\/q2naJpNihkuby+uEt4IFHUs7kKB9TX5rWv7Nf8AwUv\\/AGhYbd\\/F3x2+Fnwat3ZmktvCmjLqM8anop82M\\/MPUT4\\/nWnpH\\/Buwvxg8ZabrH7Rn7QfxX+PkGll3h0fUbg6dprFgow0UcjcAhiNhU8jninZdQOG+IXxctv+Cy3\\/AAVy+Fek\\/DK4s\\/EHwZ\\/ZwvH8ReI\\/EkcYmstS1KQDybeBiMNt8tRvHXMhGdua\\/WOJdsSj2rzj4F\\/s7fDr9jH4Uf2F4M0PSvCHhqw33NxtfALdXmmlclnbqS7sT718xeKv+CtGrftP+I9X8Gfsm+Crj4q6tYStY3fji9P2TwXokwID7rkkPduinPlwA5OPm60PV+7sB9YfHT9ovwV+zR8O9Q8V+O\\/Emk+GNB0yJ5p7q+uBEMKMkKDy7eiqCT2FfDPiH9qz9o7\\/AIKia\\/PoX7P+jX\\/wU+ErRMl18SvFmkumpasjqy\\/8Syyk2sAeCJXxg16p8E\\/+CSGnaj4ssPG37QHjHWf2gPHtjL9qsX1+NYtD0CVhhxY6cn7mMdMM4d\\/lHzCvsWGFYI1RFCqoCgAYAApaLYD5a\\/Yd\\/wCCRPwq\\/Yluz4gtbW98Z\\/Ee9iC6l4z8STtf6vettUMRJISY1O0HapxX1OBiloou3uAUUUUgCiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKAE2DdnvS0UUAFNAIY806igAooooAKKKKACiignAoARm2Lk18F\\/tz\\/ABk8Rfto\\/Gl\\/2cPhzb3TaVlD4+1yN1ijsbN1JNrHJu3CVhgttXIUjkbq9D\\/4KRfts3Xwd07RPhp4DUav8X\\/iTI1j4e0+OTH2Vekl3McHbFHnJJxnoDmu8\\/YD\\/Y3t\\/wBjr4LRaVd6lceIvFmrt\\/aHiHWrnBm1G8cAuxI\\/hB4A9AK1jaEed\\/IE0d\\/+z58APDP7M\\/wn0bwb4S0+PTtD0S3WC3iBLE45LMxJJYnJJPc129FFZb6sApGOBS1y\\/wAYPi74d+BPw31nxZ4r1a00Pw9oVq93fXt1Jsit4l6sT+QA6kkAUAcn+0X+2l8Lf2UPDt7qHxB8d+G\\/C6Wdk9+0F7fRpdSxLwTHDnzHJOAAoOSRX4f\\/ALVH\\/BTGD\\/gop+0FpPjrx\\/8AD34pXfwF8AXYk0TwhpzQWx1SchZINSvvMlXeZCAscJQgA8MxJB+Yviv8RvB37Y37a3izxh4m8SW3h\\/RPGuqXMvh3V9fivP7R0q1Z5WtNRlRY5WchQ6wWqvGjGNS3HNf0Nf8ABOL4RfDXSv2avCOu\\/DuRNd8O6zpcElvq93YmO81fHW5laUCXLMCQpwFG0AYArSNkrs6HBU1eW58teBP+Dh3w3b+G7Wz8OfsxftA\\/YrEpZJapo1rA0Enl7\\/LWMzBj8ozkDn6mlt\\/+Dmrwd4hun07Q\\/gb8a77xFHMbZ9LuLKztZYptwTY4M5Yck87eMV+mwtIxnCLz14qGLQrSC6edLeFZpDl3VAGbvyam6MW0z86j\\/wAFaP2n\\/i3dL\\/wrj9jXxQse4Ix8W6x\\/ZbrlWIfHklNmVI\\/1mfYdzUPip\\/wUp8fanFZWnw8+CPgXYpka8a7bU7eX5QVQt9pDrgkg4iPQ4r9HljCngUpXNK4rn5v3nhH\\/AIKYaFavqa+LfgRrd7FNu\\/siHTzHbTxkHAV3COmCBnMh+8cdAK9B+Cv7T\\/7bVhqq2PxH\\/Zp8D6gkk2F1Pwz47gggjj9WhnDOW9MMPwr7f2ilouI+B\\/2lf2Yv2xv2iPiRqf8Awh3xL8I\\/BrwL41trF9RW2ie88S6E0dtCs0ENyF8o\\/vPOIZMf7w3ceh\\/sAf8ABHf4ZfsITX2vrLqvxB+JGtyCfVfGXil1vdVuZOPuOwJiXgcAk8dTX1rRRzO1gOF+O\\/7NHgH9p7wHN4Z+IPhLQPGGhz5JtNVskuURiCN6bhlH54ZSGHY18F6D\\/wAE4v2hv+CYPi3xRcfsn654Y8WfC7W7hb+H4ceM7yb\\/AIlE21vNFldHkKxC4V3UDJzk81+l1VtV1GDStPlubmWOG3t1MksjttWNQMliewAppvYD8xv2j\\/8Ago3+2N8JfgdrHijxl8LPhh8DvD+h27m\\/8Raxr66xI8piJihsbOJgZZnk2qAzEZboQDW5\\/wAEf\\/2HfEnxq0+x\\/aP\\/AGkVfxn8V\\/Flut3oo1qBc+HrBwTDHHbqTDF8rsV2orDzGLcmue8L2utf8Fr\\/ANvSLxFqGk2lz+y18H76T+wjcSqyeK9WQAG6EQ+\\/FhzsZuAgJA3SZH6gafaR2dpFHGqosaBFVRgKB2Aq5S5VbqVpYlRBGoA7DFOxzRRWRIUUUUAJuobkUnlLuzjtikT94vI\\/CgBVTbSs+38aWuE\\/aL\\/aF8K\\/svfCPWvHPjTVItI8OeH7V7q7uH5JCjhEXq8jnCqi8szAAZIoAo\\/tT\\/tT+DP2O\\/g1rHjvx3rEWj6Bo8W92PzS3Mh+5DEnWSVzwqLyT+dfnr+xZ+zr47\\/4K1\\/tGH9o346WVzp\\/w40m5Zfhz4NknBt\\/sbbHWeVUPLlkjZmJO912YCJ8yfBH4BeNf+C2Xx50\\/wCM3xh02bw78F\\/Cl2tz8PvDMV6vm3qH5jPdqu5Gd0Me5w4KYaJQMO1fqTo2jW2gabDaWkEVta2yLFDDEoRIkUYCqBwAAAAKvSO25S01PGP2w\\/2v5f2RtN8Mw6V8PfFXxH1jxPdTW9ppGgG3SdUhi8ySTMzopwNoCAlmzwODXzZ4u\\/4L0zfDpriXXv2WP2mrLT7e8eyN4nhqKWN3ViPlxLllIGcjjBFff0+nxXM0buis0R3ISMlD0yPTrUxGRUq3Uk\\/PBP8Ag5f+BNhbvJrHg7456CsKAzNeeBrnbE5\\/gJUnJ68jjjrW94D\\/AODlD9kPxrhbj4jXXhmUsU2a7oV7ZYcHBUsYimR\\/vV92XGnw3MLI8Ubq3UMuQfrXH+NP2b\\/h\\/wDEmykg8Q+B\\/COuRygh1vtHt5w2ev3kNHu9QPEdA\\/4LVfspeJr6K3tvjr8PRJNjyzPqIt0fJxw0gUHnjrXrnhX9r74U+ObaCbRviT4C1SK62+SbbXrWTzd33cAPzmuQ8S\\/8Ewf2d\\/GNqkOpfBT4Y3KRuJFH\\/CO2qbWAwCCqA9BXmmrf8EDf2R9Xjuwfgt4atzewmB2tpbiFkUuHyhWQbGyB8y4OOOnFP3APra01u01FN1vPBP2zGwYfmKtIwdc8V+et3\\/wba\\/Bnwpci9+Gvjj41\\/CfVIX8y2uPDvjCdVgOSR8kgfcOf4ifrWm37Af7X\\/wAIdOkh8B\\/tfS+JYlhSKG38c+D7W7eMowbPnwkMxYZUllPBz1otHuB98AUtfCPhj4oft7fAnRfJ8V\\/DX4O\\/GtYZkH23w14kfQL14jjcWhuovKLDno6j2rO1n\\/g4L+Hnwa8Sy+HPjL4D+Jvwg8UBfNt7HVdJF6l+mHDPFLatIGRXQoWwBnBzjOHyN7AffrusY5wK+TP21f8Agrj4I\\/Zf8TReCPDWla38VPixqTCCw8JeGIftNwkjrmJ7qT\\/V28TMVG9jnBJCnaa+f\\/hT8afiR\\/wWd1XR9Y0v4p6L8G\\/g1vdp\\/DvhjxBDd+MNeQMQBczICLNG2\\/djJfGckZwPt79lb9jb4cfsb+Dzovw+8N2+iW9wwkupjI9xdXsgAG+WaQs7t9T9KLJb7gfLz\\/8ABP74y\\/8ABROzsNR\\/af8AFqeFPB0yW9y3wu8E3JWymZXMhTUr1wZJz91SsOxMAjLda+1fhf8ACTwz8FPB1n4e8I6FpXhvQ9PjEVtYadapb28KgAcIoA7DnrXRAYFDAnpxUuTe4C0Ug4FLSAKQ9aWigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigBD0oXpzS0m7mgBaKKKACiiigAooooAKKKKACvJ\\/2xv2rfDn7IHwO1rxh4iuYY4dPgZoLeSdYmvJSD5cSk\\/xO2FGPXpXpOv+ILbw3pct5dypDBApd3dgoUAZJJPHavz\\/APgn4W1D\\/gqt+1snxR1l3b4J\\/DS\\/ki8KaeRIkXiG+G5HvGGQHiQ8JkEckg1pTgn70tkHoegf8E1f2XvE+seMvEnx9+LAspvH\\/wARIoG0y0tz5lv4d0sRhoraIkZydx3nAJbJ7gD7OAwKZBCsEahQFAAAAHAFSVM5ucuZgFFFFSAGvjv\\/AILG\\/sGfET\\/goB+z\\/p\\/hHwJ4p8P6D9l1WHU76y1m3kls9YWEM0cMhj+ZQJdj9CG2YIxX2JSYoGnZ3R+Ot5\\/wbTeMvGHxi8PeIPGnxd8NavpUMlvLrDp4ZWG\\/2QpCiwW0jOyoqrEFDEdAPlr9XPgP8HNE\\/Z++D\\/hzwR4bjuItA8K6fDpmnxz3DTypDEgRAzsSzHAHJrpdXitn06b7WsbW4QmQSDK7Ryciq\\/hK6gvdBt5bXd9lkQNDuJyYz90888jFNtsupWnUd5u5pUUUUjMKKKKACiiigAoopHbYOaAAnAr89f8Agqf+0rrH7Rvxj0T9kj4UaskfirxfNFL461G3Esn\\/AAjuin55InMZUq86AqfmGI2I6yLXuP8AwVE\\/b\\/tv2DfgPbX2n2MGv+PvGGoR6D4R0Iy7ZNUvpSFB2j5mSMMGcLyeAMFhWF\\/wSs\\/YEuv2T\\/BOueLfGGo\\/8JB8UfiddvrfiXU2hMTNJK7yLHtb5kIVlVlyQDGFHCitafu++xrue+fs5fs\\/+Hv2aPg\\/oXg3w1aLbaZotssCnaA874+aV8cbmbJP14wBiu6C4oA2ilrLVu7EFFFFABRTXzjinUAFIeKWuc+K\\/wAV\\/D3wQ+H2q+KvFer2Gg+HdEt2ur\\/UL2URQWsa9WZj0\\/qcCgCj8c\\/jz4W\\/Zv8AhdqvjLxnq9voXhzRoxJdXcwZtuSFVVVQWdmYgBVBJJAAr83Phj8PviV\\/wW4+P9v4\\/wDHtvfeEv2b\\/DlxKvhzwxNEFuNbdJQpubhWGRKdjDdj90rsqHczOtPwTofi3\\/gvd+0gPF2rS6toX7LHgLUoLjwtY7JLO58VXkXzG8dgQ+MkhVPyouON+QP1O8LeFrHwboNppmm2lvY6fYQpb21vAgSOCNRhVVRwABxWnw+o1pqSeHvDlj4U0a207TbW3sbCyiSC3toIxHFBGoCqiqOAoAAAHAAFXqKKz9RBRRRQAUUUUAFFIWxXhH7ZP\\/BSb4P\\/ALCGiif4h+L7Cw1G4C\\/YtFtf9L1bUGbhVitY8yNk5G7AX1Io1eiA93LYrwf9sf8A4KTfCP8AYYsI18deJ4I9evUJ03w9YIbzWNVf+FIbaPLkscAFsLkjmvmrwf8AHP8Aaz\\/4Ka2k+oeBNFsP2bfg7qwtXsNf8QW5ufGl\\/CJVeWW3tQzQQB0UoBMMjJPORj279jn\\/AIJG\\/Bv9jnxEPFemaPe+KfiRcK\\/27xp4mum1LW753++xlfhM9MIqgAYquVL4gPINH+Jv7U3\\/AAUttUi0Pw3q37KXw2kmb7TrWreVdeMNVh42ra2xUxWmQTmSTceflFfQ37Jv\\/BOT4X\\/se2lxP4d0ebVfE2pIy6n4m12c6jrOqFpHlcy3EmWw0kjsVXauWPFe8KmxcUtLmfTQDzfx\\/wDsg\\/DL4oi2Ou+B\\/DV7NZSie2nFikU9s4OQ0ciAOhz3BHU+td1ougQ6HCUiadxuLAyytIRk5wCT0HYdqvUUgCiiigAopFJJpaACiiigAooooACcCkVt1LRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFJjmlooAKKKKACiiigAooooAKbJII1yaVm2ivmP\\/gpT+2nN+zF8LbXSPDOn3PiL4l+O7n+xfCmi2rKJrq7kB+c7iFEcYyzEnjHqRVRi5PlQHjn7bvxz8Q\\/tp\\/tMD9mX4bvNbWkUKXPj7Xk+ZNLsJOtuuCCJZVyAc8A9K+1fgp8GvD\\/AMAfhho3hHwvp8GmaHodqlra28ShVVVHU+pJ5J7k143\\/AME0v2HIv2LPgXHa6pctrfj3xM\\/9qeKtbmO+bUb1\\/mb5uflXOAMkDHFfR2OKutJP3I7IBaKKKyAKKKKACiiigBGQOORmkSMRjgYp1FABRRRQAUUUUAFFFFABXM\\/GL4s6D8C\\/hjrfi7xPqUGkaB4etHvr67l+7DEgyTjqT2AHJJAHJrpJH8tc1+Zn7W3jC4\\/4LDftlTfs6+GmuP8AhT3w11GDUPiFrNtNtTVLyFg6acpxyiPsLYzuYnkCM5qMeZ6gdH\\/wTm8Aa\\/8A8FCf2kr\\/APaq+Jds8eh25n0v4W+Hp4I2i0nTxId18c7j9plKrlhtIKleVVDX6IIgjXArP8L+GLHwjoFlp2m2lvY2NhCsFvbwIEjhRRgKoHAAFaVEnd6Db1CiiipEFFFFABRRTJphCuTwPX0oApeI\\/Etl4T0W51LUbqGysLGF7i5uJ3CRQRqMs7MeAAAST7V+Vv8Abev\\/APBwn8c9QsrWTU9B\\/Zb+Hmqxm1mSDH\\/Cb3Sj5pJN\\/WMK37pACE3ea53iNK1\\/2m\\/iRrH\\/AAXE+P8Ac\\/BL4X67e6T8Fvh7qKv478TWjER65cxyf8eMRBG5AUdccqzfMQUQB\\/0f+C\\/wZ8PfAP4dad4W8LaZa6Tomlx7ILe3jCDJJZ3IAGWZmZmPcsTWtuT4twNPwF4C0j4Z+ENP0HQtPtdL0fSoEtrS0toxHFbxqMBVArZoorIAoJxRRQA1H3j\\/ABp1FGaADNYvj\\/4haL8LfCOoa94g1Sx0jSNLge5urq7mEUUEaqWZiT6AE\\/hXA\\/ti\\/tkeC\\/2Ifg3feM\\/G15PFYwMsFraWkRnvtUuW+5b28Q5kkb06AAkkAE18V\\/D39if4m\\/8ABXjWbTx1+1PaXXhT4XQXSX3hX4V2N3JAWUbts+rOMM8uCMIrAY9M4Nxinq9gNTxT+3f8ZP8Agpj8R7nwl+yg9r4a+G2nEQa\\/8VNa05ykjM5Ux6TC4AncIrN5hG3JXoCGPuH7JH\\/BJD4ZfsyeK5fGeqJqHxM+KN\\/5bXvjTxe66jqrugGPKZhiFQRkBACOBnivpHwR4C0b4a+FrDRNA02z0fSNKgW2s7O0iEUNvGoAVVUcAAAVr0ufTTYBscQjHFOooqQCiiigAooooAKKKKACiimu+wd\\/woAdTBHhidzfT0p9JmgCnq2tx6PbGWRZnQEA+VE0hH4KCaxtO+L\\/AIX1PxfNoEPiLRn16FQ8mmfbI\\/taL0DGLO\\/Bx1xXRvEpQ8CvLP2hv2Mvhp+0\\/wDY38a+D9K1m+01hJY6iQ1tf2LDoYbmIrNGf91xQB6okoenV+af\\/BRzWP2nP+CWPw80nx78BLyf4rfCrw0Q3iXwd4kR9U1WwttygSWt2P8ASZIgGO4SNIyY3ZK5x9wfsiftN6B+2D+z34U+I3hmSV9F8X6dFqFsJPvxblG6Nh2ZG3KfdadrAelltppc5pCoamF\\/LOO5pASUU1XzS5oAQpl85P0p1FFABnFIrBhkc0tNdSV+XjmgBScChCSvNLRQAUUUm7JoAWiiigAooooAKKKKACiiigAooooAKKKKACkJO6looAKKKKACiiigAooooAKKKZNKIYyzEADnJPSgDmPjH8WNH+C\\/w61fxLrt9Bp2laNbvdXNxO21I0UEkk\\/QV8cf8E6fh3r\\/AO2L8cdT\\/aa+IVhcWNtcwyaZ8P8ARrqNlGn6fuBN7tbGXnwGDFc7dvoKwP2l9Sv\\/APgqJ+2FB8GfD2sB\\/hT4AnS9+IE1sT5WpTA5i07eD8395x\\/uj1r9AvDvh+08MaJaWFjAltZ2UKQQQoMLEigKqgegAArT4Y26gXUG1QPaloorMAooooAKKKKACiiigAooooAKKKKACiiigApGPy0teb\\/tcftNeG\\/2Pf2dPFfxF8VXUdtpHhexe6ZC4V7qQcRwR56ySOVRR6sKAPnH\\/grZ+2\\/4j+GFn4Y+CfwhDaj8a\\/i3dx6fYpbr5jeHtOclZ9RlOGEYChwjOMbgzYYRkV7N+wH+xRof7CX7O2h+CtIuLnU7u3iEmqapdNuuNTucYaRvQdgB0A5ySSfAf+COX7NfijWNI1v9or4ssbz4p\\/GKdtQWMu7RaDpeMWtnCG4CqncDkHPVmJ+7Qu0Vc9PcQ3oLRRRUCCiiigAooooAK8B\\/4KfeC\\/ip8Q\\/2HvH2i\\/BiZYviBqVh9nsV3rE88buqzxxyMyrFI0JkCuT8rYr36imnZ3A+Kv8Agk7+yv8AFv4CfDPRrDxpZaN4B8O6ZZPDD4Ts9RfWb6afMYWe7v3YqcLGdsMCoi+YQd20E\\/ag4FLRRKTk7sAooopAFFFFABXlP7Z\\/7X3hD9hz9n3XviJ43u5bfRdGjVVigTzLi+uJDsht4U\\/ikkchQPfJ4Br1VzhD9K\\/Mf9oI2v8AwUN\\/4LkWHwa8SSapB4H+Bmg2nig6eJgtnrmqtLBPmSM\\/6wJE8SjjgNLyKqKu9QO3\\/YU\\/Y08Y\\/tW\\/G2z\\/AGof2ic3OuzRx3Pw98DyCVbP4f2kkYO54Xxuvnz87sDtI47bf0AVAg4qO3g8teOOe3epqltvUAooooAKKKKACimmTB5496GlC0AOoziszX\\/F+neFrBrrUry10+2T7011OkMa\\/VmIH614P8WP+Csn7NvwatbyTxF8bfhxZHT\\/APXwx63DczockY8uIs5OR0Ap2bA+i80x5MA+1fnt8Rf+Dn79kTwXYynSPHWreNr9Qvl2OgaFdTyzknopdEQkd\\/mrldb\\/AODgrxH8RmhT4MfsofHz4jmcKxurzSW0e0GVUnDur5xux2HHBIOaLAfplHMGQZ4+tRy3qqy+5xX5gXv7Zf8AwUf+PZ+zeDP2Z\\/AnwuikibF\\/4s8QLctG27IPlowP3RjG08morL9hf\\/go38dkuR46\\/an8FfDyzuI2QWXhHw8s0iK64I80pE4I9Q+QeQaLCufqDd6tFYxF5XjjRRkszBQB9TXBfEf9rH4ZfCG2+0+J\\/iD4M0CEbQzX+s29uAWOB95x3NfAPh\\/\\/AINrLXxyPM+Mn7R3x4+J00zmaa1GuvYWhcnPCZkIA543d69V8Df8G4X7IPgieKdvhVFr91Gwfztc1W8vmc8\\/eDybT9CKegrnV\\/Gr\\/gvX+yr8B9TuLDWPi94ev9QtxlrfRlk1NsGMyDDQqyHIGOG+8QOprxPUP+DizTfi9Pa2vwM+APxv+K1\\/dTrEkn9itpliqlgvmGdg\\/GDnkD3xX2P8Lv8Agn78EfgnMJfCfwl+HPh+ZQFEtnoFskmB0+fZu6gd69b0u1gjtxDFEsccfyhFTaFA6YGKfu22Ju2fmBfaX\\/wUN\\/4KGaJdafrFp4K\\/Zd8B6oogu0tpP7U8STQFgsqhyXSMshOPlU4BGQDz94fsZ\\/sq+H\\/2Kf2e\\/DPw58MiR9J8NWYtYZZnYyzEsWeRsk\\/MzszHGBk8ADivVzhZCdvX0FKMOfdeuBSlK\\/QtEiygnk0rxCQg+lRZy\\/zDB68VJHyGqRihQDQR89N8vA\\/2h70yOdiWXa3y9yODQBMxwKFO4U1X+U+uelBO6M0AKz7SPemxziXp0zikOdijv0JoEYR85y3TmgCWmbcS96UP\\/kUxZcj39PSgCWkxg0zzG3imlj5mfmHb2oAmooooAKKKKACiiigAooooAKKKKACiiigAoopC4BxnmgBaKKKACiiigAooooAM4r5S\\/wCCoX7Xer\\/A34e6X4K8BwJqvxW+Jd3\\/AGN4ZsR8xidv9ZdSDB2xQqSxJ4+6O9fQvxf+KWj\\/AAc+Her+JNfv7XStI0e2kurm7uHCxwoilixz7A18cf8ABNT4M3H7UHxk1n9qrxvbaouo+JY5dM8D6dfx+V\\/Y2iq5CTBOokuMeYSecOOBgVcF9pge+f8ABP8A\\/Y6sP2M\\/gFp\\/h9fKu\\/EV8TqHiLVMZk1XUJPmllZjyfmJx7V7nSAYFLUNtu7AKKKKACiiigAooooAKKKKACiiigAooooAKKKCcUANmk8qIseg5r8xvjIl9\\/wWn\\/bu0Pwro0sn\\/DOnwU1v7brl8pUweLNat+kSKQRJBE3yBum7zGH3VNe2\\/wDBYD9q\\/Xvht4K8L\\/CH4cX8MPxZ+NmoLoWk\\/Md+m2RwLu9OASmxDtVj\\/G49K9j\\/AGBv2ONB\\/Yd\\/Zq8PeBtEtrZJbKFZNSuYk2m+u2UeZKe5yeBnsB3rSL5VzdQ6XPZNPsY9MsoreFEiihUJGiDCooGAB+FT0UVmAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAIw3DFfnz\\/wVB\\/4Jy\\/FXxB+1R4P\\/ab\\/AGcb7Q4fjH4Ksf7IutF1dvIsPEtgWcmKSTcAGAcjDDnCkMhQE\\/oPSMu4Ypp2A\\/Mnwb\\/wck+H\\/hVaf2L+0Z8E\\/jH8EPF1rIYbr7ToT3ukSsCwDQXPyNIrbSVwhz2L4yfcPD3\\/AAX4\\/ZG1rwjHq5+NXh6xjeD7Sba\\/trq2vY0xnJt3iEn0wpz2zX1v4h8J6Z4u0ibT9V0+y1OxuBiW2u4FmikHoysCD+Irg4P2MPhBbrME+Ffw5VbjJlA8NWWJM9c\\/u+eg60aCsfLn\\/ES1+xfNaXEtv8YVuTbgs0UfhjWfNZQCSwQ2gO0Y69PeuM8T\\/wDB1V+yRokSSWGteP8AxDE4JLad4QvAEA7kzLGMfTNfZ2n\\/ALDXwW0i+iubT4RfDGzuIDmKWDwtYxvGcY4YRAjjiu\\/0HwNovhaEx6ZpOnaeh4K21skQIxjooFP3eoz8\\/vC\\/\\/Bx74D+L1iz\\/AAy+BX7TnxMmD+SP7F8ClrdJdu7ZJM0wVDj1H4VuN\\/wVD\\/aa8XWlxL4S\\/YR+Jlx5DIsg1\\/xlpWiElgD8quXZwMjJUHBBBwQa+9jbqW6UoiCfdHNF12A\\/O\\/UPH3\\/BSL48SMNF8Afs9\\/A2xkDDfr+vXHiLUIvQj7MphJ+o\\/Cq+tf8ABOP9t741Q2cHjb9s+08OWIdJrmPwT4KjsJ84AeNJ\\/NVio25BYHJdsr0FfowU+XoM0sZJQZ60czWwrH5reE\\/+DYz4Sa5qDXnxX+Ivxm+M1yzMdniPxPMtuCTnISLa2c\\/7eOele7\\/DX\\/ghj+yV8Jkh\\/sr4EfD6WSEgiXUtP\\/tKUkc5LXBc19aVGYyHLe2BSu27tjON8J\\/ALwP8OreNdB8H+FtESDJjFhpUFvsJ642KK6uONF2gKOOMDjFWIl+XnnJzTZogR0+ppAFx8keR\\/wDrqJTsw23P0qSJAzYyeBSSIY5FwRjOMGgT3uIy7z3P1oVvOPQjHrTmh2sW7kAfSnRY8sVVxdSHbliCp\\/HvT4\\/v49qbc3Xlrny2wG2nj9fpUkaeYnPPoakFGxHPbny8b8dM5H3vWpI28uTGOCM5pDHz83TFSDG3igojY+Yd3pxShPMHHFNK8gZ+lSRtxQA37hwe9L5QV8+9LIgcZ645oB3R8HmgAIUHPFCHcMe9EYBHrzSlfmzSuAKuxfU0jDK9OaDNtXJ\\/KnbsimAwr8vvTAgiIzk5OOKcyb5DwMdRz1NDKCoZhgj9KAHBdnJpsjh8fWnj5lpCNp59aAHI25aWo40EcuB6E1JQAUUUUAFFFFABRRRQAUUUUAFFFFABSYpaQ53UALRRRQAUUUUAFMmlEMZYkADqTT8180\\/8FRf2yJ\\/2RP2b7u60OE6h448STpofhbTI03yajqM52RIF6kAks2BwqmnGLk7IDwf9qXxHqH\\/BSj9u7S\\/gdoISb4Z\\/DWRNX+IV6SXhuZyuYNNAHDMQ4ds8Djg1+gPh3QrXw1odpYWVvFa2llCsEEMa7UiRRhVA9ABXz\\/8A8Ezv2L2\\/Y0+AEdlq14us+NvFFw2t+KNWa3SKW+v5vmk3EDJCkkDJP9K+jaqcrvlXQAoooqACiiigAooooAKKKKACiiigAooooAKKKKACsvxn4qsfBHhPUtY1O5is9P0q1kvLqeQ4SGKNS7uT6BQT+FabtsQn0r88P+Cyfj7W\\/wBrT4i+EP2PPh5fXFn4k+I6x6z4zvIXZI9J8NQu3mrJImSpuHURgcZAIJ+dQajG7sBkf8EkPCetft+fH3xV+2F46huobHxC7aH8O9GnRli0vSbeRwtyoYDc0pJbf0yXx2r9JUXaK5z4R\\/C\\/Sfgt8MvD\\/hLQbSOx0bw3Yw6dZQIoAjiiQKo\\/IV0tOc+ZgFFFFQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFIelAC9aKarbU+b9aFcMuQeD3oAdSDO6lBzSZ5oAQpvPPY5FEil1xnFOooAiUBZOPvY5p0hwV9aaM7uAakZNxHtQAdqaR5gGO1PpFXYKAGFicgYP8AWl+5x27UskYYHtx1qMDa3UYoAfKnmLilVdox2oJam7y\\/t9aAExgnJyD0pQ4ZsAH3odQw64pJIyQeePSgB2dsmP8AJpHjw+c\\/L3FNBx+HpTi3mJ\\/smgAhURJing5pijdTvLGenvQAOuR0Gfemq+QMjj1FSEZpCABQA0Kc5B4pRnNG4Y4oVsJzQAquGJx260Ou4U0k7uBkUeZh8GgAUFZOvGKfUa\\/638KkoAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiikJxQBW1jU4tJ02a4mYLFCpdyewFfn7+y3p8X\\/BS\\/8A4KE+IPjHqUEd38N\\/gte3HhzwVDKTJFeaoNou9QXIAJRg0SHnG046mu\\/\\/AOCt37R\\/iLQfB+gfCL4bsJfib8Wrv+ydOCy7Tp9t\\/wAvF2xAJVY0Oc+pFfQH7IP7Mmgfshfs9eGvAXhy3ihsdDtQjtGuPtM7fNLKcknLuWPJPWtV7sbrqB6Yi7FAobO3jrS0VkAyEME+Y5P8qfRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQBx3x\\/8AjTo37O3wX8U+OPEMwt9E8KaZPql65IH7uJC5AzwWOMAdyRXxh\\/wQ0+CfiTxP4N8WftKfElhd\\/Ef4+3i6l8yf8gfSIyVs7OI84i2YYAHB+U8nJr7h+JXwz0H4v+DL\\/wAO+J9Jsdd0HVI\\/KvLC9hE1vcpnO10PDDIHB9Kv+GvDth4Q0Kz0vS7O3sNO0+FLa1toECRW8SKFVFUcAAAAD2qk7Kwnc0KKKKkYUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUhGaGbaKWgAAxSbeaWigAoopso478elADqa7FegzTRlRnO7PQelSDpQADpRTVBBoBPegBT0qPJJHyDkcn0p2GXPf+lEK7Y\\/580AMYszDv9O1OZdrex\\/SldeOPxpd\\/wC8x7ZoAUqAKjE+4DjqfWllnWNlU5y\\/A4puSD93d9D0oAkxkcUKvy4I\\/CkVj6YHvTgc0mAKu0UpOKazc0ZwvNFtAF3jNI5AXmkX5kyBz2zSS5MXvSV7AKeFyq5PakfJT5l98U\\/NBOKEgBTlc0MNwpkrFiAOh6mnqu1cVQDEgCPu78\\/rUlJ3paACiiigAooooAKKKKACiiigAooooAKKKKACiiigArL8X+IrXwn4dvdRvJkgt7OF5pHdtoVVGSSa1K+Ev+C7Pxo1Cw\\/Z\\/wBD+E\\/hv7TN4o+M+t23he3itnCzC2lYfanXnPEW4Z7F1NVCDk7Cexyn\\/BMTwbqv7bH7Y3j\\/APah8VWt2dBjml8OfDiK7QoItPRsSXcan\\/nqc4buMV+i4G0Vw37NPwU079nX4E+F\\/BelRiKz8PWEdooA6sB8x\\/Fsmu6p1HeV0MKKKKgAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAarHcQR9KdRRQAVXkkIlPHQdasZpkrAD\\/CgBuPMVeuO2O1PjcMOOfelQ\\/IPpQqhFwBge1ABu+agjNLUezZgZPWgCQ1CIgWPOCvpUxOKjL4JA\\/GgAEpKZxTWk3OO2PWpcbRx+ApFyRyOaAEKkmlGFOMU0SGTdgcDihX2j15x9KACQFm4HGeeac4\\/d4FIV2fQnNN80A45Jz2FADlBWnM2KQtlO4qLqeT+QoAkSQvSyH5aRRth9PrTduyMc55oAbPCCvLMCe4PSl83ZENx\\/GjPnseqjsacFBAX0\\/WgBqNtTOMc8jPSkMm6YDnGM5xx+dK0IRfXtzQFLEc\\/pQBIm7cc9O1OpqFjnIxzxTqACiiigAooooAKKKKACiiigAooooAKKKKACiiigBsjbEJ9Oa\\/PD4f6n\\/wANZ\\/8ABdTxDdy3CTaP8CPC6WVlAYA4iv70rJNIGPCuI\\/JHr1r9DL1\\/LtJG9FJr4S\\/4JQ6RbXH7Y\\/7V+rTrCNabxhZ2TqrZaO3WwgZAR7k5ya1p\\/DKXYD7wjGEp1FFZAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFACMMigcChm2ihW3CgBabv8AnxTqZsCybs9RigBEwspGeTzSOD5nAB+tP3KrdeaUuB3oANuVxSMwQUKxJOeB2pSM0ABbFNAyfpTsU0Sg+v5UABJZuKVVwxPrSP8AP0\\/SnnpQA2UErxQBtBzSOWx0o+ZT2IoAah3E5bHNPYgDtmmyjIJAU49qB+vagB4bscZ9KjBDAsvHakSXeCcc5x0oTeY23YH0oAePmTH4UiNsHPWhZlXjPNNlYE9aAHGXc3qp70ySTZKOcDpTlA8ogDApPK3OvoKAFzlPm5XPFKBsIOeKR8joKc3zxDd8uaAGs2Sc9O1OiYkCkdNkYA7GlaQL+eKTdgFD5bGKdTVkDNjv1p1CdwCiiimAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAyRPNRlPQjFeKeA\\/2QR8Kv2p9d+Ivh3VlsrfxhbrF4h0yS38wX8kSKtvKj7h5bRgODwdwkOegx7dRTTa0QBRRRSAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKADOaKQDFLQAUUUUAFFFFABRRSZ5oARpMfnS43CgrmloAY8Ads8+lNkiwyYGccfhUhOBRu4z2oAYQJjz2p4GBSFtuPeiNiw5GKAHU10VwQR9eKdTWj3ev50AEff60pYAU0\\/LSeVlvagAZ8ng8+lPIyKb5e3p65p9AEX+rbGRzUnAPamCXd169BSsnGTQA1XQTcdT6U6RsED+8cVHCnl56FvUU9GyPm+96UmAOo2FRUcaYj9CPanOd+OcY9qXk\\/h+tC2Acz\\/us0xZN6jnGTileLzIzgkGmkrt9KkB0UpJ54FOd1ZfXmmFgvU5zzilMe8Dp+FWAu8A4J\\/OmvkS57e\\/ek2cj7x9fapCm9MdcUrXASHceW\\/wD1VJTVBDe1OpgFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUh6UtFACL0paKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACkxzS0jHAoAR\\/u\\/4UiOTjg9OppWfCj60pbAoAazfNgjjtSkfJ6cUMvmL6Uki4i+goACdqjrTwc0xJNxx7ZoSbccYIPvQA5WyaM8Uuai37ZO\\/wA1AA83yj39qdGTs5z+NIwEYApBkHAJ\\/KgBd+T1pwLFumBUZjI5xk9afkR9TQAxRl\\/p609juGQRtpigA559jTJWxC+1\\/egCYMFHbOaYZR8xwcg96F2vH0wT2PrTSNqv69BmgByzZUcdaMMqkYzzTY8yJ02nPXFPNxsQk5OPSgAkl2\\/LjmmuR5W\\/BznofypSfNft6j2oYmPjOaSbARgPs+MUsT+XGB1xRKT5OFxn3pArKgPf2oF1FbMoGDt5pI5DjuOcGkWbKrn5c0rJuGM9aYx6y\\/vNmDnBOfpUlRxybmx6DnHY1JQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFIM5oACM0BwWxnkUtN3DdjvQA6myHHU4pc5pgZhIM9MfrQA8dKjkIPY\\/hTzJxS9RQA3y8nNEi5A6\\/hT6KAK91KCVRsqW+7xTpm8sgetSSIHXmmTfvVG386ACBsRDdwTx680jMCTvPT0pwUnqMbenvSGX5iMc4zQA0sJSevTIFMgjOf9zoKlY556A+lNdTt79c5oAUnc2Txgjmm+Ysi5HPPUj86V4RJjJOcfQGnR4igyeMfpSYDVkymRn24piN3\\/i7470+SQAbx2HXFRxsUBxyck5qQHxKBGDjB\\/lmnyttgzgn27mjOYic7T7dqZLJ8gPvg81Tv0AGbzowVzn3FODiS3\\/wphItyWx82eaeWEYVQPvcg0K9tQIXbzWzkAc8mnICBkHJI6mmvujl54XHUAY+lSsQq9xnr9KYBBIpl6EMw3dOtT1FBLvbhfl28HNS0AFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABSE4FFFAApJHIxQelFFAAOlLRRQAgbLUtFFADQG3nnil2ANnvRRQABQpzTdm0GiigBkLb2PHA4HvTZbn7PjPOTjjtRRSTESQybmPOaWTJAwaKKYxu7NGzzDw3Q54FFFAAT823d9aIxyfYYoopN2APL3KaUL5mf1oop2sAk0Zb6d6bsLHnkZ6etFFRLewCsoRvTHPFIjZGc59CRRRVWARkYg4xuyB7Ux0LnBccfNjbRRQ2AoO+AfxFufrTjIEiyWOO3HSiimAqlHY8dfXvSbi6HB9TRRQAtsCJCMngdD2qeiigAooooAKKKKAP\\/9k=\",\r\n \"establishment_logo\": \"\\/9j\\/4RnxRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAAagEoAAMAAAABAAIAAAExAAIAAAAeAAAAcgEyAAIAAAAUAAAAkIdpAAQAAAABAAAApAAAANAACvyAAAAnEAAK\\/IAAACcQQWRvYmUgUGhvdG9zaG9wIENTNiAoV2luZG93cykAMjAxODowNzowOSAxMTo1MjozOQAAA6ABAAMAAAAB\\/\\/8AAKACAAQAAAABAAAFiaADAAQAAAABAAAFiQAAAAAAAAAGAQMAAwAAAAEABgAAARoABQAAAAEAAAEeARsABQAAAAEAAAEmASgAAwAAAAEAAgAAAgEABAAAAAEAAAEuAgIABAAAAAEAABi7AAAAAAAAAEgAAAABAAAASAAAAAH\\/2P\\/iDFhJQ0NfUFJPRklMRQABAQAADEhMaW5vAhAAAG1udHJSR0IgWFlaIAfOAAIACQAGADEAAGFjc3BNU0ZUAAAAAElFQyBzUkdCAAAAAAAAAAAAAAABAAD21gABAAAAANMtSFAgIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEWNwcnQAAAFQAAAAM2Rlc2MAAAGEAAAAbHd0cHQAAAHwAAAAFGJrcHQAAAIEAAAAFHJYWVoAAAIYAAAAFGdYWVoAAAIsAAAAFGJYWVoAAAJAAAAAFGRtbmQAAAJUAAAAcGRtZGQAAALEAAAAiHZ1ZWQAAANMAAAAhnZpZXcAAAPUAAAAJGx1bWkAAAP4AAAAFG1lYXMAAAQMAAAAJHRlY2gAAAQwAAAADHJUUkMAAAQ8AAAIDGdUUkMAAAQ8AAAIDGJUUkMAAAQ8AAAIDHRleHQAAAAAQ29weXJpZ2h0IChjKSAxOTk4IEhld2xldHQtUGFja2FyZCBDb21wYW55AABkZXNjAAAAAAAAABJzUkdCIElFQzYxOTY2LTIuMQAAAAAAAAAAAAAAEnNSR0IgSUVDNjE5NjYtMi4xAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABYWVogAAAAAAAA81EAAQAAAAEWzFhZWiAAAAAAAAAAAAAAAAAAAAAAWFlaIAAAAAAAAG+iAAA49QAAA5BYWVogAAAAAAAAYpkAALeFAAAY2lhZWiAAAAAAAAAkoAAAD4QAALbPZGVzYwAAAAAAAAAWSUVDIGh0dHA6Ly93d3cuaWVjLmNoAAAAAAAAAAAAAAAWSUVDIGh0dHA6Ly93d3cuaWVjLmNoAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAGRlc2MAAAAAAAAALklFQyA2MTk2Ni0yLjEgRGVmYXVsdCBSR0IgY29sb3VyIHNwYWNlIC0gc1JHQgAAAAAAAAAAAAAALklFQyA2MTk2Ni0yLjEgRGVmYXVsdCBSR0IgY29sb3VyIHNwYWNlIC0gc1JHQgAAAAAAAAAAAAAAAAAAAAAAAAAAAABkZXNjAAAAAAAAACxSZWZlcmVuY2UgVmlld2luZyBDb25kaXRpb24gaW4gSUVDNjE5NjYtMi4xAAAAAAAAAAAAAAAsUmVmZXJlbmNlIFZpZXdpbmcgQ29uZGl0aW9uIGluIElFQzYxOTY2LTIuMQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAdmlldwAAAAAAE6T+ABRfLgAQzxQAA+3MAAQTCwADXJ4AAAABWFlaIAAAAAAATAlWAFAAAABXH+dtZWFzAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAACjwAAAAJzaWcgAAAAAENSVCBjdXJ2AAAAAAAABAAAAAAFAAoADwAUABkAHgAjACgALQAyADcAOwBAAEUASgBPAFQAWQBeAGMAaABtAHIAdwB8AIEAhgCLAJAAlQCaAJ8ApACpAK4AsgC3ALwAwQDGAMsA0ADVANsA4ADlAOsA8AD2APsBAQEHAQ0BEwEZAR8BJQErATIBOAE+AUUBTAFSAVkBYAFnAW4BdQF8AYMBiwGSAZoBoQGpAbEBuQHBAckB0QHZAeEB6QHyAfoCAwIMAhQCHQImAi8COAJBAksCVAJdAmcCcQJ6AoQCjgKYAqICrAK2AsECywLVAuAC6wL1AwADCwMWAyEDLQM4A0MDTwNaA2YDcgN+A4oDlgOiA64DugPHA9MD4APsA\\/kEBgQTBCAELQQ7BEgEVQRjBHEEfgSMBJoEqAS2BMQE0wThBPAE\\/gUNBRwFKwU6BUkFWAVnBXcFhgWWBaYFtQXFBdUF5QX2BgYGFgYnBjcGSAZZBmoGewaMBp0GrwbABtEG4wb1BwcHGQcrBz0HTwdhB3QHhgeZB6wHvwfSB+UH+AgLCB8IMghGCFoIbgiCCJYIqgi+CNII5wj7CRAJJQk6CU8JZAl5CY8JpAm6Cc8J5Qn7ChEKJwo9ClQKagqBCpgKrgrFCtwK8wsLCyILOQtRC2kLgAuYC7ALyAvhC\\/kMEgwqDEMMXAx1DI4MpwzADNkM8w0NDSYNQA1aDXQNjg2pDcMN3g34DhMOLg5JDmQOfw6bDrYO0g7uDwkPJQ9BD14Peg+WD7MPzw\\/sEAkQJhBDEGEQfhCbELkQ1xD1ERMRMRFPEW0RjBGqEckR6BIHEiYSRRJkEoQSoxLDEuMTAxMjE0MTYxODE6QTxRPlFAYUJxRJFGoUixStFM4U8BUSFTQVVhV4FZsVvRXgFgMWJhZJFmwWjxayFtYW+hcdF0EXZReJF64X0hf3GBsYQBhlGIoYrxjVGPoZIBlFGWsZkRm3Gd0aBBoqGlEadxqeGsUa7BsUGzsbYxuKG7Ib2hwCHCocUhx7HKMczBz1HR4dRx1wHZkdwx3sHhYeQB5qHpQevh7pHxMfPh9pH5Qfvx\\/qIBUgQSBsIJggxCDwIRwhSCF1IaEhziH7IiciVSKCIq8i3SMKIzgjZiOUI8Ij8CQfJE0kfCSrJNolCSU4JWgllyXHJfcmJyZXJocmtyboJxgnSSd6J6sn3CgNKD8ocSiiKNQpBik4KWspnSnQKgIqNSpoKpsqzysCKzYraSudK9EsBSw5LG4soizXLQwtQS12Last4S4WLkwugi63Lu4vJC9aL5Evxy\\/+MDUwbDCkMNsxEjFKMYIxujHyMioyYzKbMtQzDTNGM38zuDPxNCs0ZTSeNNg1EzVNNYc1wjX9Njc2cjauNuk3JDdgN5w31zgUOFA4jDjIOQU5Qjl\\/Obw5+To2OnQ6sjrvOy07azuqO+g8JzxlPKQ84z0iPWE9oT3gPiA+YD6gPuA\\/IT9hP6I\\/4kAjQGRApkDnQSlBakGsQe5CMEJyQrVC90M6Q31DwEQDREdEikTORRJFVUWaRd5GIkZnRqtG8Ec1R3tHwEgFSEtIkUjXSR1JY0mpSfBKN0p9SsRLDEtTS5pL4kwqTHJMuk0CTUpNk03cTiVObk63TwBPSU+TT91QJ1BxULtRBlFQUZtR5lIxUnxSx1MTU19TqlP2VEJUj1TbVShVdVXCVg9WXFapVvdXRFeSV+BYL1h9WMtZGllpWbhaB1pWWqZa9VtFW5Vb5Vw1XIZc1l0nXXhdyV4aXmxevV8PX2Ffs2AFYFdgqmD8YU9homH1YklinGLwY0Njl2PrZEBklGTpZT1lkmXnZj1mkmboZz1nk2fpaD9olmjsaUNpmmnxakhqn2r3a09rp2v\\/bFdsr20IbWBtuW4SbmtuxG8eb3hv0XArcIZw4HE6cZVx8HJLcqZzAXNdc7h0FHRwdMx1KHWFdeF2Pnabdvh3VnezeBF4bnjMeSp5iXnnekZ6pXsEe2N7wnwhfIF84X1BfaF+AX5ifsJ\\/I3+Ef+WAR4CogQqBa4HNgjCCkoL0g1eDuoQdhICE44VHhauGDoZyhteHO4efiASIaYjOiTOJmYn+imSKyoswi5aL\\/IxjjMqNMY2Yjf+OZo7OjzaPnpAGkG6Q1pE\\/kaiSEZJ6kuOTTZO2lCCUipT0lV+VyZY0lp+XCpd1l+CYTJi4mSSZkJn8mmia1ZtCm6+cHJyJnPedZJ3SnkCerp8dn4uf+qBpoNihR6G2oiailqMGo3aj5qRWpMelOKWpphqmi6b9p26n4KhSqMSpN6mpqhyqj6sCq3Wr6axcrNCtRK24ri2uoa8Wr4uwALB1sOqxYLHWskuywrM4s660JbSctRO1irYBtnm28Ldot+C4WbjRuUq5wro7urW7LrunvCG8m70VvY++Cr6Evv+\\/er\\/1wHDA7MFnwePCX8Lbw1jD1MRRxM7FS8XIxkbGw8dBx7\\/IPci8yTrJuco4yrfLNsu2zDXMtc01zbXONs62zzfPuNA50LrRPNG+0j\\/SwdNE08bUSdTL1U7V0dZV1tjXXNfg2GTY6Nls2fHadtr724DcBdyK3RDdlt4c3qLfKd+v4DbgveFE4cziU+Lb42Pj6+Rz5PzlhOYN5pbnH+ep6DLovOlG6dDqW+rl63Dr++yG7RHtnO4o7rTvQO\\/M8Fjw5fFy8f\\/yjPMZ86f0NPTC9VD13vZt9vv3ivgZ+Kj5OPnH+lf65\\/t3\\/Af8mP0p\\/br+S\\/7c\\/23\\/\\/\\/\\/tAAxBZG9iZV9DTQAC\\/+4ADkFkb2JlAGSAAAAAAf\\/bAIQADAgICAkIDAkJDBELCgsRFQ8MDA8VGBMTFRMTGBEMDAwMDAwRDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAENCwsNDg0QDg4QFA4ODhQUDg4ODhQRDAwMDAwREQwMDAwMDBEMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwM\\/8AAEQgAoACgAwEiAAIRAQMRAf\\/dAAQACv\\/EAT8AAAEFAQEBAQEBAAAAAAAAAAMAAQIEBQYHCAkKCwEAAQUBAQEBAQEAAAAAAAAAAQACAwQFBgcICQoLEAABBAEDAgQCBQcGCAUDDDMBAAIRAwQhEjEFQVFhEyJxgTIGFJGhsUIjJBVSwWIzNHKC0UMHJZJT8OHxY3M1FqKygyZEk1RkRcKjdDYX0lXiZfKzhMPTdePzRieUpIW0lcTU5PSltcXV5fVWZnaGlqa2xtbm9jdHV2d3h5ent8fX5\\/cRAAICAQIEBAMEBQYHBwYFNQEAAhEDITESBEFRYXEiEwUygZEUobFCI8FS0fAzJGLhcoKSQ1MVY3M08SUGFqKygwcmNcLSRJNUoxdkRVU2dGXi8rOEw9N14\\/NGlKSFtJXE1OT0pbXF1eX1VmZ2hpamtsbW5vYnN0dXZ3eHl6e3x\\/\\/aAAwDAQACEQMRAD8A9VSSSSUpJJJJSkkkklKSSQMjMoo0cdz\\/ANxup\\/8AMUgCdlJ0CzNxq3+m943d41A\\/rR9FZt+dfdIn02fut5\\/tPVfjhSDH3WmT0AIcA5pBB4I4TrCpvtoM1O2ju3lp\\/srQo6nU+G3D03eP5p\\/tfm\\/2kJYyNtUgt1JMCCJGoKdMSpJJJJSkkkklKSSSSU\\/\\/0PVUkkklKSSQ7simhs2ODZ4Hc\\/BqSkiDflU0D9I73dmjVx+SoX9TtsltI9Nvjy7\\/AMi1U+SSdSeSdSVJHH3WmTav6jfboz9Ezy+kf7X5v9lVUklIABsi1JJJIoUkkkkpLRk3UH9G72\\/uHVv3fm\\/2VoUdSpshtn6J\\/n9E\\/B6ykk0xBSCXoUliUZd9GjHSz9x2o+X7q0cfqFF0Nd+jefzXcH+q5RSgR4rgW0kkkmpUkkkkp\\/\\/R9VULbqqm7rHBo8\\/4KGZa+nDvuZG+ut72zqJa0uC5ijq9WSQcgmu493mWn+q\\/8z+q5SQxmQJ6BBlTtX9Ue720DYP33c\\/JqpElzi5xLnHknUpklIABstJUkkkihSSSSSlJJJJKUkkkkpSSSSSlJJJJKT0Zt9EAHez9x3\\/fXfmrSx86i+Gg7Hn8x3P9n95YyXKbKAKQXoUlR6XZY+t4e4uDSA2dYEK8oSKNLw\\/\\/0vTOpf8AJ2V\\/xNn\\/AFLlwLfoj4Lvuo\\/8n5X\\/ABNn\\/UuXAt+iPgrfK\\/LLzY8m4T42bkY2lbpZ\\/o3at+X7n9hauN1LGvhrj6Nh\\/NedD\\/Us+j\\/nLESU8scZeB7rASHpSCOUlhY3UMnHhoPqVj\\/Bv1A\\/qO+kxamNn42RDQfTsP8Ag36E\\/wBR30XqGWOUfELgQWyklwkmJUkkkkpSSSSSlJJJJKUkkkkpSSSSSnR6T9C3+sPyLQWf0n6Fv9YfkWgoJ\\/MV42f\\/0\\/Teo\\/8AJ+V\\/xNn\\/AFLlwDfoj4Lv+o\\/8n5P\\/ABNn\\/UuXAN+iPgFb5T5ZebFk3C6SSSsrFJiAdCnSSU2sbqWTRDXH1qx+a86j+pZ9JamNm4+TpW6H\\/wCjdo75fv8A9hYKZMljifApEiHpkljY3VciqG2\\/p2eZh4+D\\/wA7+2tTHysfJgVPBeZit2j9PpQz8\\/b\\/AMGoZQlHfbuuBBSpJJJqVJJJJKUkkkkpSSSSSnR6T9G3+sPyLQWf0n6NvxH5FoKCfzFeNn\\/\\/1PTeof0DJ\\/4mz\\/qXLgG\\/RHwC7\\/qH9Ayf+Kf\\/ANSVwDfoj4BW+U+WXmxZNwukkkrKxSSSZzmsaXvIYxv0nOMAfFxSUuo2WV1MNlrhXWOXuMBZmX16pksw2+q7\\/SvBDB\\/VZo+z\\/oLIvvuyH+pe82PHBPA\\/qNHtZ\\/ZT44yd9FpmBtq6uX14aswmT\\/w1g0\\/sVf8ApT\\/ttZNlt1toussc+4GW2EncCP3HN\\/m\\/+tqCSlEQNmMyJ3eg6Z9cs7GirqDTnUjT1NG3tH9f+byP+u\\/pP+GXWdP6ngdSrNmDcLdol9Z9tjP+Mpd72\\/1\\/5teZp2PfXY22tzq7WGWWMJa5p\\/kvb7mqLJy8Jaj0nw2\\/xV0cpG+r6okuP6Z9dcmqKuqV\\/aa+PtFYDbh\\/xlftqv8A\\/AbP666nCzsPPpN+Fc2+sfS26Ob5W1Oiyr+21VJ4pw3GncfKzRmJbfYnSSSTFykkkklOj0n6NvxH5FoLP6T9G34j8i0FBP5ivGz\\/AP\\/V9Nz\\/AOg5P\\/FP\\/wCpK4Bv0R8AvQM7+hZH\\/FP\\/AOpK8\\/YCWj4BW+U+WXmGPJuF0uASdANSToAPMrPy+tYtEsp\\/WLB+6YYP61n53\\/W1jZWbk5Z\\/Tvlo1FbdGD+x\\/wCTVyMCfBhMwPF1svrmPVLcUeu\\/98yKx8\\/pW\\/2P+3Fj5OVkZTt2Q8vj6LeGt\\/qVj2tQklLGADGZEqSSSTkKSSSSUpJJJJSlOm67Hubfj2OpuZ9G2slrh\\/aH\\/UqCSCnqemfXZ7Yq6tVvHH2qgAO\\/69j\\/AEX\\/ANaj\\/tldRjZONmUjIxLWX0nTewyAf3Xj6Vb\\/AORYvLkXFysnDuGRiWvouGm9hiR+68fRsZ\\/IsUGTloy1j6T\\/AM1kjlI31\\/N9QSXL9M+uzHRV1av0zx9qoBLf+vY\\/02f1qN\\/\\/ABK6Wm6nIpbfj2Nupf8ARtrIc0\\/2m\\/8AUqpPHKB9Q+vRmjIS2LqdJ4t+LfyLQWf0ni34t\\/ItBVp\\/MWQbP\\/\\/W9RyKzbj21AgGxjmgngEjavJ\\/rF036xdP06nXGGNG248nHPh6jv5xjv8Aw1\\/1teuJnNDgWuALSIIOoIKmwZziOwkD\\/LRZOHEN6fCkl6V1r\\/F50vM3XdMd+zsg67GiaHH+VR7fR\\/8AQfZ\\/xVi4Tq\\/Q+q9Gs29RoNbCYZkN91LvDbdA2ud\\/o7vSt\\/kLSxcxjyfKal+6fma08co7jTu0EkklMsUkkkkpSSSSSlJJJJKUkkkkpSSSJRRflXtxsWp997\\/o1VtLnEfvbR9Fn8t\\/sQUjV3ox6z9u2dEFrsp0b2UgFpH\\/AHaa\\/wDV\\/T\\/l5C6non+Le6zbf1u30mc\\/Y6HS4+V+SPo\\/1Mf\\/ANiV3GD0\\/C6djtxsGhmPS3hjBEn95377\\/wCW\\/wB6q5ucxxBjEe4f+Z\\/6EzQwyOp9P\\/SavQsfqVOHu6oKWZb4L2Y5cWCP+M\\/P\\/f8AzFpJJLNkeIk9+zZAoU\\/\\/1\\/VUkkklKUbK67a3V2tFlbwWvY4AtIPLXNP0lJJJTxvWv8XODkbrujvGFcdfQdLqCf5I\\/nMb\\/rX6L\\/uuuG6n0rqXSbhT1HHdjlxhjzrW\\/wD4q9v6N\\/8AU\\/nf+DXtaHfj0ZNLqMitl1Ngh9djQ5rh4OY72uVrFzk4aS9cfH5v8ZinhidvSXw1Jd\\/1r\\/FvRZuu6Jb9nfz9luJdUf8AirffdR\\/4NX\\/xa4jP6fndNv8As\\/UKH41p+iH\\/AEXR\\/obW7qrv+tvV\\/Fmx5B6Tr+6fma8sco7j6tdJJJSrVJJJcua0Alzzta0CSSfzWNb7nOSUpOxj7LG01MdbbYYrqYC57j\\/IrZL3LqOif4v+q5+27qJPTsY67CAchw\\/4szXj\\/wDXt9n\\/AHXXedI6B0no1RZgUCtzhFlzvda\\/\\/jLn+939T+b\\/AHFWy83jhoPXLw+X\\/GZIYZS30DxPRf8AF1n5W27q9hwqTr9nrIdcR\\/Ls99NH9n1n\\/wDFLu+mdI6b0qj0On47KGHVxbq5x\\/ettdustd\\/xj1cSWflz5MnzHT90fK2I44x2H1Ukkkol6kkkklP\\/0PVUkkklKSSSSUpJJJJSkHLw8TOodjZlLMih\\/wBKuxoc37nIySQJGoU8H1r\\/ABbRuv6HdHf7HeSR\\/Voyfc9v9S\\/1f+OrXFZuLldPvONn0vxbx\\/g7RBInburd9C5n8upz17ioWU02uY6ytr3VO3VlwBLXRt3sn6LtpVvFzs46THGPsl9rDLBE7el8u6J9Rus9U225APTsQ677m\\/pXD\\/gsb2ub\\/XyPT\\/4q1d90X6sdH6KN2HTuyCIdlW++0j\\/jP8G3\\/g6W1VrWSUeXmcmTQnhj+7H9q+GKMfE9ypJJJQL1JJJJKUkkkkpSSSSSn\\/\\/Z\\/+0iSFBob3Rvc2hvcCAzLjAAOEJJTQQEAAAAAAAPHAFaAAMbJUccAgAAAgBsADhCSU0EJQAAAAAAEKFdbYoq2VNe2RBQsAMFvEY4QklNBDoAAAAAAO8AAAAQAAAAAQAAAAAAC3ByaW50T3V0cHV0AAAABQAAAABQc3RTYm9vbAEAAAAASW50ZWVudW0AAAAASW50ZQAAAABDbHJtAAAAD3ByaW50U2l4dGVlbkJpdGJvb2wAAAAAC3ByaW50ZXJOYW1lVEVYVAAAAAEAAAAAAA9wcmludFByb29mU2V0dXBPYmpjAAAAEQBBAGoAdQBzAHQAZQAgAGQAZQAgAHAAcgB1AGUAYgBhAAAAAAAKcHJvb2ZTZXR1cAAAAAEAAAAAQmx0bmVudW0AAAAMYnVpbHRpblByb29mAAAACXByb29mQ01ZSwA4QklNBDsAAAAAAi0AAAAQAAAAAQAAAAAAEnByaW50T3V0cHV0T3B0aW9ucwAAABcAAAAAQ3B0bmJvb2wAAAAAAENsYnJib29sAAAAAABSZ3NNYm9vbAAAAAAAQ3JuQ2Jvb2wAAAAAAENudENib29sAAAAAABMYmxzYm9vbAAAAAAATmd0dmJvb2wAAAAAAEVtbERib29sAAAAAABJbnRyYm9vbAAAAAAAQmNrZ09iamMAAAABAAAAAAAAUkdCQwAAAAMAAAAAUmQgIGRvdWJAb+AAAAAAAAAAAABHcm4gZG91YkBv4AAAAAAAAAAAAEJsICBkb3ViQG\\/gAAAAAAAAAAAAQnJkVFVudEYjUmx0AAAAAAAAAAAAAAAAQmxkIFVudEYjUmx0AAAAAAAAAAAAAAAAUnNsdFVudEYjUHhsQFIAAAAAAAAAAAAKdmVjdG9yRGF0YWJvb2wBAAAAAFBnUHNlbnVtAAAAAFBnUHMAAAAAUGdQQwAAAABMZWZ0VW50RiNSbHQAAAAAAAAAAAAAAABUb3AgVW50RiNSbHQAAAAAAAAAAAAAAABTY2wgVW50RiNQcmNAWQAAAAAAAAAAABBjcm9wV2hlblByaW50aW5nYm9vbAAAAAAOY3JvcFJlY3RCb3R0b21sb25nAAAAAAAAAAxjcm9wUmVjdExlZnRsb25nAAAAAAAAAA1jcm9wUmVjdFJpZ2h0bG9uZwAAAAAAAAALY3JvcFJlY3RUb3Bsb25nAAAAAAA4QklNA+0AAAAAABAASAAAAAEAAgBIAAAAAQACOEJJTQQmAAAAAAAOAAAAAAAAAAAAAD+AAAA4QklNA\\/IAAAAAAAoAAP\\/\\/\\/\\/\\/\\/\\/wAAOEJJTQQNAAAAAAAEAAAAeDhCSU0EGQAAAAAABAAAAB44QklNA\\/MAAAAAAAkAAAAAAAAAAAEAOEJJTScQAAAAAAAKAAEAAAAAAAAAAjhCSU0D9QAAAAAASAAvZmYAAQBsZmYABgAAAAAAAQAvZmYAAQChmZoABgAAAAAAAQAyAAAAAQBaAAAABgAAAAAAAQA1AAAAAQAtAAAABgAAAAAAAThCSU0D+AAAAAAAcAAA\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/wPoAAAAAP\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/8D6AAAAAD\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/A+gAAAAA\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/\\/wPoAAA4QklNBAAAAAAAAAIAADhCSU0EAgAAAAAABAAAAAA4QklNBDAAAAAAAAIBAThCSU0ELQAAAAAABgABAAAABjhCSU0ECAAAAAAAEAAAAAEAAAJAAAACQAAAAAA4QklNBB4AAAAAAAQAAAAAOEJJTQQaAAAAAANbAAAABgAAAAAAAAAAAAAFiQAABYkAAAATAEwAbwBnAG8AIABUAG8AcgByAGUAIABTAG8AZgB0AHcAYQByAGUAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAABYkAAAWJAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAEAAAAAAABudWxsAAAAAgAAAAZib3VuZHNPYmpjAAAAAQAAAAAAAFJjdDEAAAAEAAAAAFRvcCBsb25nAAAAAAAAAABMZWZ0bG9uZwAAAAAAAAAAQnRvbWxvbmcAAAWJAAAAAFJnaHRsb25nAAAFiQAAAAZzbGljZXNWbExzAAAAAU9iamMAAAABAAAAAAAFc2xpY2UAAAASAAAAB3NsaWNlSURsb25nAAAAAAAAAAdncm91cElEbG9uZwAAAAAAAAAGb3JpZ2luZW51bQAAAAxFU2xpY2VPcmlnaW4AAAANYXV0b0dlbmVyYXRlZAAAAABUeXBlZW51bQAAAApFU2xpY2VUeXBlAAAAAEltZyAAAAAGYm91bmRzT2JqYwAAAAEAAAAAAABSY3QxAAAABAAAAABUb3AgbG9uZwAAAAAAAAAATGVmdGxvbmcAAAAAAAAAAEJ0b21sb25nAAAFiQAAAABSZ2h0bG9uZwAABYkAAAADdXJsVEVYVAAAAAEAAAAAAABudWxsVEVYVAAAAAEAAAAAAABNc2dlVEVYVAAAAAEAAAAAAAZhbHRUYWdURVhUAAAAAQAAAAAADmNlbGxUZXh0SXNIVE1MYm9vbAEAAAAIY2VsbFRleHRURVhUAAAAAQAAAAAACWhvcnpBbGlnbmVudW0AAAAPRVNsaWNlSG9yekFsaWduAAAAB2RlZmF1bHQAAAAJdmVydEFsaWduZW51bQAAAA9FU2xpY2VWZXJ0QWxpZ24AAAAHZGVmYXVsdAAAAAtiZ0NvbG9yVHlwZWVudW0AAAARRVNsaWNlQkdDb2xvclR5cGUAAAAATm9uZQAAAAl0b3BPdXRzZXRsb25nAAAAAAAAAApsZWZ0T3V0c2V0bG9uZwAAAAAAAAAMYm90dG9tT3V0c2V0bG9uZwAAAAAAAAALcmlnaHRPdXRzZXRsb25nAAAAAAA4QklNBCgAAAAAAAwAAAACP+0XWOIZZSw4QklNBBEAAAAAAAEBADhCSU0EFAAAAAAABAAAAAY4QklNBAwAAAAAGNcAAAABAAAAoAAAAKAAAAHgAAEsAAAAGLsAGAAB\\/9j\\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\\/M7gz8TQrNGU0njTYNRM1TTWHNcI1\\/TY3NnI2rjbpNyQ3YDecN9c4FDhQOIw4yDkFOUI5fzm8Ofk6Njp0OrI67zstO2s7qjvoPCc8ZTykPOM9Ij1hPaE94D4gPmA+oD7gPyE\\/YT+iP+JAI0BkQKZA50EpQWpBrEHuQjBCckK1QvdDOkN9Q8BEA0RHRIpEzkUSRVVFmkXeRiJGZ0arRvBHNUd7R8BIBUhLSJFI10kdSWNJqUnwSjdKfUrESwxLU0uaS+JMKkxyTLpNAk1KTZNN3E4lTm5Ot08AT0lPk0\\/dUCdQcVC7UQZRUFGbUeZSMVJ8UsdTE1NfU6pT9lRCVI9U21UoVXVVwlYPVlxWqVb3V0RXklfgWC9YfVjLWRpZaVm4WgdaVlqmWvVbRVuVW+VcNVyGXNZdJ114XcleGl5sXr1fD19hX7NgBWBXYKpg\\/GFPYaJh9WJJYpxi8GNDY5dj62RAZJRk6WU9ZZJl52Y9ZpJm6Gc9Z5Nn6Wg\\/aJZo7GlDaZpp8WpIap9q92tPa6dr\\/2xXbK9tCG1gbbluEm5rbsRvHm94b9FwK3CGcOBxOnGVcfByS3KmcwFzXXO4dBR0cHTMdSh1hXXhdj52m3b4d1Z3s3gReG54zHkqeYl553pGeqV7BHtje8J8IXyBfOF9QX2hfgF+Yn7CfyN\\/hH\\/lgEeAqIEKgWuBzYIwgpKC9INXg7qEHYSAhOOFR4Wrhg6GcobXhzuHn4gEiGmIzokziZmJ\\/opkisqLMIuWi\\/yMY4zKjTGNmI3\\/jmaOzo82j56QBpBukNaRP5GokhGSepLjk02TtpQglIqU9JVflcmWNJaflwqXdZfgmEyYuJkkmZCZ\\/JpomtWbQpuvnByciZz3nWSd0p5Anq6fHZ+Ln\\/qgaaDYoUehtqImopajBqN2o+akVqTHpTilqaYapoum\\/adup+CoUqjEqTepqaocqo+rAqt1q+msXKzQrUStuK4trqGvFq+LsACwdbDqsWCx1rJLssKzOLOutCW0nLUTtYq2AbZ5tvC3aLfguFm40blKucK6O7q1uy67p7whvJu9Fb2Pvgq+hL7\\/v3q\\/9cBwwOzBZ8Hjwl\\/C28NYw9TEUcTOxUvFyMZGxsPHQce\\/yD3IvMk6ybnKOMq3yzbLtsw1zLXNNc21zjbOts83z7jQOdC60TzRvtI\\/0sHTRNPG1EnUy9VO1dHWVdbY11zX4Nhk2OjZbNnx2nba+9uA3AXcit0Q3ZbeHN6i3ynfr+A24L3hROHM4lPi2+Nj4+vkc+T85YTmDeaW5x\\/nqegy6LzpRunQ6lvq5etw6\\/vshu0R7ZzuKO6070DvzPBY8OXxcvH\\/8ozzGfOn9DT0wvVQ9d72bfb794r4Gfio+Tj5x\\/pX+uf7d\\/wH\\/Jj9Kf26\\/kv+3P9t\\/\\/\\/\\/7QAMQWRvYmVfQ00AAv\\/uAA5BZG9iZQBkgAAAAAH\\/2wCEAAwICAgJCAwJCQwRCwoLERUPDAwPFRgTExUTExgRDAwMDAwMEQwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwBDQsLDQ4NEA4OEBQODg4UFA4ODg4UEQwMDAwMEREMDAwMDAwRDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDP\\/AABEIAKAAoAMBIgACEQEDEQH\\/3QAEAAr\\/xAE\\/AAABBQEBAQEBAQAAAAAAAAADAAECBAUGBwgJCgsBAAEFAQEBAQEBAAAAAAAAAAEAAgMEBQYHCAkKCxAAAQQBAwIEAgUHBggFAwwzAQACEQMEIRIxBUFRYRMicYEyBhSRobFCIyQVUsFiMzRygtFDByWSU\\/Dh8WNzNRaisoMmRJNUZEXCo3Q2F9JV4mXys4TD03Xj80YnlKSFtJXE1OT0pbXF1eX1VmZ2hpamtsbW5vY3R1dnd4eXp7fH1+f3EQACAgECBAQDBAUGBwcGBTUBAAIRAyExEgRBUWFxIhMFMoGRFKGxQiPBUtHwMyRi4XKCkkNTFWNzNPElBhaisoMHJjXC0kSTVKMXZEVVNnRl4vKzhMPTdePzRpSkhbSVxNTk9KW1xdXl9VZmdoaWprbG1ub2JzdHV2d3h5ent8f\\/2gAMAwEAAhEDEQA\\/APVUkkklKSSSSUpJJJJSkkkDIzKKNHHc\\/wDcbqf\\/ADFIAnZSdAszcat\\/pveN3eNQP60fRWbfnX3SJ9Nn7ref7T1X44Ugx91pk9ACHAOaQQeCOE6wqb7aDNTto7t5af7K0KOp1Phtw9N3j+af7X5v9pCWMjbVILdSTAgiRqCnTEqSSSSUpJJJJSkkkklP\\/9D1VJJJJSkkkO7IpobNjg2eB3PwakpIg35VNA\\/SO93Zo1cfkqF\\/U7bJbSPTb48u\\/wDItVPkknUnknUlSRx91pk2r+o326M\\/RM8vpH+1+b\\/ZVVJJSAAbItSSSSKFJJJJKS0ZN1B\\/Ru9v7h1b935v9laFHUqbIbZ+if5\\/RPwespJNMQUgl6FJYlGXfRox0s\\/cdqPl+6tHH6hRdDXfo3n813B\\/quUUoEeK4FtJJJJqVJJJJKf\\/0fVVC26qpu6xwaPP+ChmWvpw77mRvrre9s6iWtLguYo6vVkkHIJruPd5lp\\/qv\\/M\\/quUkMZkCegQZU7V\\/VHu9tA2D993PyaqRJc4ucS5x5J1KZJSAAbLSVJJJIoUkkkkpSSSSSlJJJJKUkkkkpSSSSSk9GbfRAB3s\\/cd\\/3135q0sfOovhoOx5\\/Mdz\\/Z\\/eWMlymygCkF6FJUel2WPreHuLg0gNnWBCvKEijS8P\\/9L0zqX\\/ACdlf8TZ\\/wBS5cC36I+C77qP\\/J+V\\/wATZ\\/1LlwLfoj4K3yvyy82PJuE+Nm5GNpW6Wf6N2rfl+5\\/YWrjdSxr4a4+jYfzXnQ\\/1LPo\\/5yxElPLHGXge6wEh6UgjlJYWN1DJx4aD6lY\\/wb9QP6jvpMWpjZ+NkQ0H07D\\/AIN+hP8AUd9F6hljlHxC4EFspJcJJiVJJJJKUkkkkpSSSSSlJJJJKUkkkkp0ek\\/Qt\\/rD8i0Fn9J+hb\\/WH5FoKCfzFeNn\\/9P03qP\\/ACflf8TZ\\/wBS5cA36I+C7\\/qP\\/J+T\\/wATZ\\/1LlwDfoj4BW+U+WXmxZNwukkkrKxSYgHQp0klNrG6lk0Q1x9asfmvOo\\/qWfSWpjZuPk6Vuh\\/8Ao3aO+X7\\/APYWCmTJY4nwKRIh6ZJY2N1XIqhtv6dnmYePg\\/8AO\\/trUx8rHyYFTwXmYrdo\\/T6UM\\/P2\\/wDBqGUJR327rgQUqSSSalSSSSSlJJJJKUkkkkp0ek\\/Rt\\/rD8i0Fn9J+jb8R+RaCgn8xXjZ\\/\\/9T03qH9Ayf+Js\\/6ly4Bv0R8Au\\/6h\\/QMn\\/in\\/wDUlcA36I+AVvlPll5sWTcLpJJKysUkkmc5rGl7yGMb9JzjAHxcUlLqNlldTDZa4V1jl7jAWZl9eqZLMNvqu\\/0rwQwf1WaPs\\/6CyL77sh\\/qXvNjxwTwP6jR7Wf2U+OMnfRaZgbaurl9eGrMJk\\/8NYNP7FX\\/AKU\\/7bWTZbdbaLrLHPuBlthJ3Aj9xzf5v\\/ragkpREDZjMid3oOmfXLOxoq6g051I09TRt7R\\/X\\/m8j\\/rv6T\\/hl1nT+p4HUqzZg3C3aJfWfbYz\\/jKXe9v9f+bXmadj312Ntrc6u1hlljCWuaf5L2+5qiycvCWo9J8Nv8VdHKRvq+qJLj+mfXXJqirqlf2mvj7RWA24f8ZX7ar\\/APwGz+uupws7Dz6TfhXNvrH0tujm+VtTosq\\/ttVSeKcNxp3Hys0ZiW32J0kkkxcpJJJJTo9J+jb8R+RaCz+k\\/Rt+I\\/ItBQT+Yrxs\\/wD\\/1fTc\\/wDoOT\\/xT\\/8AqSuAb9EfAL0DO\\/oWR\\/xT\\/wDqSvP2Alo+AVvlPll5hjybhdLgEnQDUk6ADzKz8vrWLRLKf1iwfumGD+tZ+d\\/1tY2Vm5OWf075aNRW3Rg\\/sf8Ak1cjAnwYTMDxdbL65j1S3FHrv\\/fMisfP6Vv9j\\/txY+TlZGU7dkPL4+i3hrf6lY9rUJJSxgAxmRKkkkk5CkkkklKSSSSUpTpuux7m349jqbmfRtrJa4f2h\\/1Kgkgp6npn12e2KurVbxx9qoADv+vY\\/wBF\\/wDWo\\/7ZXUY2TjZlIyMS1l9J03sMgH914+lW\\/wDkWLy5FxcrJw7hkYlr6LhpvYYkfuvH0bGfyLFBk5aMtY+k\\/wDNZI5SN9fzfUEly\\/TPrsx0VdWr9M8faqAS3\\/r2P9Nn9ajf\\/wASulpupyKW349jbqX\\/AEbayHNP9pv\\/AFKqTxygfUPr0ZoyEti6nSeLfi38i0Fn9J4t+LfyLQVafzFkGz\\/\\/1vUcis249tQIBsY5oJ4BI2ryf6xdN+sXT9Op1xhjRtuPJxz4eo7+cY7\\/AMNf9bXriZzQ4FrgC0iCDqCCpsGc4jsJA\\/y0WThxDenwpJelda\\/xedLzN13THfs7IOuxomhx\\/lUe30f\\/AEH2f8VYuE6v0PqvRrNvUaDWwmGZDfdS7w23QNrnf6O70rf5C0sXMY8nympfun5mtPHKO407tBJJJTLFJJJJKUkkkkpSSSSSlJJJJKUkkiUUX5V7cbFqffe\\/6NVbS5xH720fRZ\\/Lf7EFI1d6Mes\\/btnRBa7KdG9lIBaR\\/wB2mv8A1f0\\/5eQup6J\\/i3us239bt9JnP2Oh0uPlfkj6P9TH\\/wDYldxg9PwunY7cbBoZj0t4YwRJ\\/ed++\\/8Alv8AequbnMcQYxHuH\\/mf+hM0MMjqfT\\/0mr0LH6lTh7uqClmW+C9mOXFgj\\/jPz\\/3\\/AMxaSSSzZHiJPfs2QKFP\\/9f1VJJJJSlGyuu2t1drRZW8Fr2OALSDy1zT9JSSSU8b1r\\/Fzg5G67o7xhXHX0HS6gn+SP5zG\\/61+i\\/7rrhup9K6l0m4U9Rx3Y5cYY861v8A+Kvb+jf\\/AFP53\\/g17Wh349GTS6jIrZdTYIfXY0Oa4eDmO9rlaxc5OGkvXHx+b\\/GYp4Ynb0l8NSXf9a\\/xb0WbruiW\\/Z38\\/ZbiXVH\\/AIq333Uf+DV\\/8WuIz+n53Tb\\/ALP1Ch+Nafoh\\/wBF0f6G1u6q7\\/rb1fxZseQek6\\/un5mvLHKO4+rXSSSUq1SSSXLmtAJc87WtAkkn81jW+5zklKTsY+yxtNTHW22GK6mAue4\\/yK2S9y6jon+L\\/quftu6iT07GOuwgHIcP+LM14\\/8A17fZ\\/wB113nSOgdJ6NUWYFArc4RZc73Wv\\/4y5\\/vd\\/U\\/m\\/wBxVsvN44aD1y8Pl\\/xmSGGUt9A8T0X\\/ABdZ+Vtu6vYcKk6\\/Z6yHXEfy7PfTR\\/Z9Z\\/8AxS7vpnSOm9Ko9Dp+Oyhh1cW6ucf3rbXbrLXf8Y9XEln5c+TJ8x0\\/dHytiOOMdh9VJJJKJepJJJJT\\/9D1VJJJJSkkkklKSSSSUpBy8PEzqHY2ZSzIof8ASrsaHN+5yMkkCRqFPB9a\\/wAW0br+h3R3+x3kkf1aMn3Pb\\/Uv9X\\/jq1xWbi5XT7zjZ9L8W8f4O0QSJ27q3fQuZ\\/Lqc9e4qFlNNrmOsra91Tt1ZcAS10bd7J+i7aVbxc7OOkxxj7JfawywRO3pfLuifUbrPVNtuQD07EOu+5v6Vw\\/4LG9rm\\/18j0\\/+KtXfdF+rHR+ijdh07sgiHZVvvtI\\/4z\\/Bt\\/4OltVa1klHl5nJk0J4Y\\/ux\\/avhijHxPcqSSSUC9SSSSSlJJJJKUkkkkp\\/\\/2QA4QklNBCEAAAAAAFUAAAABAQAAAA8AQQBkAG8AYgBlACAAUABoAG8AdABvAHMAaABvAHAAAAATAEEAZABvAGIAZQAgAFAAaABvAHQAbwBzAGgAbwBwACAAQwBTADYAAAABADhCSU0EBgAAAAAABwAGAQEAAQEA\\/+EQXWh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC8APD94cGFja2V0IGJlZ2luPSLvu78iIGlkPSJXNU0wTXBDZWhpSHpyZVN6TlRjemtjOWQiPz4gPHg6eG1wbWV0YSB4bWxuczp4PSJhZG9iZTpuczptZXRhLyIgeDp4bXB0az0iQWRvYmUgWE1QIENvcmUgNS4zLWMwMTEgNjYuMTQ1NjYxLCAyMDEyLzAyLzA2LTE0OjU2OjI3ICAgICAgICAiPiA8cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPiA8cmRmOkRlc2NyaXB0aW9uIHJkZjphYm91dD0iIiB4bWxuczp4bXA9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC8iIHhtbG5zOmRjPSJodHRwOi8vcHVybC5vcmcvZGMvZWxlbWVudHMvMS4xLyIgeG1sbnM6eG1wTU09Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9tbS8iIHhtbG5zOnN0RXZ0PSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvc1R5cGUvUmVzb3VyY2VFdmVudCMiIHhtbG5zOnN0UmVmPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvc1R5cGUvUmVzb3VyY2VSZWYjIiB4bWxuczpwaG90b3Nob3A9Imh0dHA6Ly9ucy5hZG9iZS5jb20vcGhvdG9zaG9wLzEuMC8iIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIENTNiAoV2luZG93cykiIHhtcDpDcmVhdGVEYXRlPSIyMDE4LTA3LTA5VDExOjQ3OjA0LTA1OjAwIiB4bXA6TWV0YWRhdGFEYXRlPSIyMDE4LTA3LTA5VDExOjUyOjM5LTA1OjAwIiB4bXA6TW9kaWZ5RGF0ZT0iMjAxOC0wNy0wOVQxMTo1MjozOS0wNTowMCIgZGM6Zm9ybWF0PSJpbWFnZS9qcGVnIiB4bXBNTTpJbnN0YW5jZUlEPSJ4bXAuaWlkOkYyNEJDOUI1OTc4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiB4bXBNTTpEb2N1bWVudElEPSJ4bXAuZGlkOkY1NTZDQTA1OTU4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiB4bXBNTTpPcmlnaW5hbERvY3VtZW50SUQ9InhtcC5kaWQ6RUU0QkM5QjU5NzgzRTgxMTg3OURGNDdGRDNGOEYzNzciIHBob3Rvc2hvcDpDb2xvck1vZGU9IjMiPiA8eG1wTU06SGlzdG9yeT4gPHJkZjpTZXE+IDxyZGY6bGkgc3RFdnQ6YWN0aW9uPSJjcmVhdGVkIiBzdEV2dDppbnN0YW5jZUlEPSJ4bXAuaWlkOkVFNEJDOUI1OTc4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiBzdEV2dDp3aGVuPSIyMDE4LTA3LTA5VDExOjQ3OjA0LTA1OjAwIiBzdEV2dDpzb2Z0d2FyZUFnZW50PSJBZG9iZSBQaG90b3Nob3AgQ1M2IChXaW5kb3dzKSIvPiA8cmRmOmxpIHN0RXZ0OmFjdGlvbj0ic2F2ZWQiIHN0RXZ0Omluc3RhbmNlSUQ9InhtcC5paWQ6RjE0QkM5QjU5NzgzRTgxMTg3OURGNDdGRDNGOEYzNzciIHN0RXZ0OndoZW49IjIwMTgtMDctMDlUMTE6NTI6MzktMDU6MDAiIHN0RXZ0OnNvZnR3YXJlQWdlbnQ9IkFkb2JlIFBob3Rvc2hvcCBDUzYgKFdpbmRvd3MpIiBzdEV2dDpjaGFuZ2VkPSIvIi8+IDxyZGY6bGkgc3RFdnQ6YWN0aW9uPSJjb252ZXJ0ZWQiIHN0RXZ0OnBhcmFtZXRlcnM9ImZyb20gYXBwbGljYXRpb24vdm5kLmFkb2JlLnBob3Rvc2hvcCB0byBpbWFnZS9qcGVnIi8+IDxyZGY6bGkgc3RFdnQ6YWN0aW9uPSJkZXJpdmVkIiBzdEV2dDpwYXJhbWV0ZXJzPSJjb252ZXJ0ZWQgZnJvbSBhcHBsaWNhdGlvbi92bmQuYWRvYmUucGhvdG9zaG9wIHRvIGltYWdlL2pwZWciLz4gPHJkZjpsaSBzdEV2dDphY3Rpb249InNhdmVkIiBzdEV2dDppbnN0YW5jZUlEPSJ4bXAuaWlkOkYyNEJDOUI1OTc4M0U4MTE4NzlERjQ3RkQzRjhGMzc3IiBzdEV2dDp3aGVuPSIyMDE4LTA3LTA5VDExOjUyOjM5LTA1OjAwIiBzdEV2dDpzb2Z0d2FyZUFnZW50PSJBZG9iZSBQaG90b3Nob3AgQ1M2IChXaW5kb3dzKSIgc3RFdnQ6Y2hhbmdlZD0iLyIvPiA8L3JkZjpTZXE+IDwveG1wTU06SGlzdG9yeT4gPHhtcE1NOkRlcml2ZWRGcm9tIHN0UmVmOmluc3RhbmNlSUQ9InhtcC5paWQ6RjE0QkM5QjU5NzgzRTgxMTg3OURGNDdGRDNGOEYzNzciIHN0UmVmOmRvY3VtZW50SUQ9InhtcC5kaWQ6RjU1NkNBMDU5NTgzRTgxMTg3OURGNDdGRDNGOEYzNzciIHN0UmVmOm9yaWdpbmFsRG9jdW1lbnRJRD0ieG1wLmRpZDpFRTRCQzlCNTk3ODNFODExODc5REY0N0ZEM0Y4RjM3NyIvPiA8L3JkZjpEZXNjcmlwdGlvbj4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICA8P3hwYWNrZXQgZW5kPSJ3Ij8+\\/+4AIUFkb2JlAGRAAAAAAQMAEAMCAwYAAAAAAAAAAAAAAAD\\/2wCEAAICAgMCAwQCAgQFBAMEBQYFBQUFBggHBwcHBwgLCQkJCQkJCwsLCwsLCwsMDAwMDAwMDAwMDAwMDAwMDAwMDAwBAwMDBwQHDQcHDQ8NDQ0PDw4ODg4PDwwMDAwMDw8MDAwMDAwPDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDP\\/CABEIBYkFiQMBEQACEQEDEQH\\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\\/h7QAAAAAAAAAKNuwwh6ysvaFv6\\/QAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAF\\/Q9uQ9LKAAAAAAAAAAtGVp1E\\/TaO+ons8Uku8Ye\\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\\/q\\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\\/VObpueQAAAAAAAAAAAAAAAAAAAovnmNEyLCVvX\\/d+oAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD2ee5rc1bZ6cncXNH2AAAAAAAAAAAAAAAAAAAAV3VllRz00AAAAAAAAAAab\\/qnN0vPIAAAAAAAAAAAAAAAAAAUzzzHGVGgy4rvNI1AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAVjDLOLmLfOnlLes6swAAAAAAAAAAAAAAAAAAK7qyyo56aAAAAAAAAAANN\\/1Tm6XnkAAAAAAAAAAAAAAAAAPM8x8kR8ebav8kvQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABcerZndy1xm9y1t7cPQAAAAAAAAAAAAAAAAAK7qyyo56aAAAAAAAAAANOn1PnKNs9AAAAAAAAAAAAAAAAHU8grdoxntIHknxgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAALy0bc\\/eTuswubs\\/Xh6AAAAAAAAAAAAAAAABXdWWVHPTQAAAAAAAAABp1+p85RdnoAAAAAAAAAAAAAAA+PIQz1Y0WsCkWMT6AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACQou\\/YFyV1lxzlkAAAAAAAAAAAAAAAAK7qyyo56aAAAAAAAAAANOv1PnKLs9AAAAAAAAAAAAAAAhz3VjXbV9rWUXm8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEpQ5Ow\\/jrvJuingAAAAAAAAAAAAAACu6ssqOemgAAAAAAAAADTr9T5yi7PQAAAAAAAAAAAAAIr9143WkCxrOH998AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAE3V0vYPyF3kVSTeHoAAAAAAAAAAAAACu6ssqOemgAAAAAAAAADTr9T5yi7PQAAAAAAAAAAAALD914v2MKOLSF3Z4gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADIOqm7CuQu5yqJfD0AAAAAAAAAAAABXNWWVPPTQAAAAAAAAABp1+p85RdnoAAAAAAAAAAAFnMMYbCHE9rB9WzAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD6ZN01hsL4+7laukfAAAAAAAAAAAACt6ssquemgAAAAAAAAADTr9T5yi7PQAAAAAAAAAALY8xxhnRIluK\\/lswAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA7DK2jstg\\/HXUiwt\\/wAAAAAAAAAAArerLKrnpoAAAAAAAAAA06\\/U+couz0AAAAAAAAACgeeY2zYcJ28Bu1gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAejz3MjnrTPzkbm8Iu0AAAAAAAAAAVvVllVz00AAAAAAAAAAafPqPPW9u8AAAAAAAAApXnmO8yLAVrX8JOoAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACoY5Ztc1bZ1crb3RG2AAAAAAAAACtassq+emgAAAAAAAAADUR9OoLSk4AAAAAAAAeZ5jvIj462tfxmaAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAK1hnnRy1vnNytvVNeQAAAAAAAArWrLKvnpoAAAAAAAAAA1EfTqC0pOAAAAAAAHT55AO7RjjbwPJNjAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAXLq2Z6crc5qcva+\\/D0AAAAAAAVnVllZz00AAAAAAAAAAaiPp1BaUnAAAAAADg8gjPVjvcV1EnRgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAL5jbs9+VucxOas\\/Rj6AAAAAAKzqyys56aAAAAAAAAAANRH06gtKTgAAAAAIZz1Y3Wtfa9jE5AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAkeJv2Ccld5X89Y8vAAAAAArOrLKznpoAAAAAAAAAA1EfTqC0pOAAAAAi7LVjDZwbOs4fP3wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAASxCk7DOPu8mqKfxAAAABVteWV\\/OzQAAAAAAAAABqI+nUFpScAAABH3uvFmxhWHawu7LEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAATfXS9hXIXeQ1JN4egAABVteWV\\/OzQAAAAAAAAABqI+nUFpScAABY\\/mOMllBi+1g92eIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAyHqZ2wjkbub6iVx9AACra8sr+dmgAAAAAAAAADUR9OoLSk4AC0PMcbLCFEdtA+7MQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAPpk\\/S2Gwnj7uVK+R8ABVteWV\\/OzQAAAAAAAAABqP+m0NlytYoDHG6dDg20g9u\\/WAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAB2mWFFZ7BuPupChbvgKtryyv52aAAAAAAAAAANSH0yhjWVqxxmRICtoHORqAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA9HnuZHPWmffI3N4xdtW15ZX87NAAAAAAAAAAH5\\/vpnOYidVTdUrSAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABUccs3OZtto3B3+R1HLAAAAAAAAAAEX2GjVV3\\/AD+u7sKXye+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADJyln7bfnvR5cc3YAAAAAAAAAAAAQvaxtT30HnsDupqOj3wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAT5VzNsvz\\/os3uTtOQAAAAAAAAAAAAAMfrqJqV+hc7hZ0lVwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABLcGTtg+f8ARZ\\/8fbd+PoAAAAAAAAAAAAAAAxnvoOo\\/6HzuI9\\/W\\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\\/6Dz2A\\/V0\\/n98AAAAAHMzV5u125fOujneolAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACCbeLqT+h87hJ01T1gAAAGWdFZbdvnXRZMUM4AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAY23sLUt9B53Droqz4AAZJ087bd886PMDmrEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAYldJX6mPoPO4tXdeJ0rJe2X5\\/0WcXJ2vd4AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAHEw46etsOXpz55C39mHoAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA\\/\\/aAAgBAgABBQD\\/AIP4AI0ixE1FRKUFWAGpRIyfSzt3pFiY1JolT\\/gIANLMAGjpiQelCLIx6SblT\\/AYgGBZhRyCQekiLQylJNSp\\/kOmBwWYdqMUSj0gSbGUpFoVPQKJFUpZiJaEBDo6kgZSkWRSaRREqlLMRLQh26MpomUpFiBaAO2nVblUpVkYnRYiYnFFgAUAAGrVbFUpVmYnRIpBMKLCikAoa5VqVSlmpk+hwFE1IsBGiJgQNiVZlPSzYyfQoA70kxE1JolT2dZkU9KtzJ9B0WRj0kgVPahDvSzEpqVRMn0DSZmPSTYqe3CADSzADUokZMefItTKUi0KnuRigalmHejpiQedJNzKUizKTdjEAwLMKMQSjzZJEylIsilrt23k6YHBVgIUYol5mmkKgosALQAAb6okVQFWAloQ7cvIQTikwopQKHAFUSqUsxMWu3blZSiYUmHeiEAgcEVblUpZkYnKADvSLERpNIEw4Qs2KpSzMxOSdu9IsjGpJEqfDVmpVKWamT5CizMekm5U+IrMynpVsZPjqLQylJNSp8VVZFNSqBk+MotjKUkzKTjAh3pZiBqURMnxVJAylIsik44IANKsAGlEjE4imkZSkWIFoA7cfMUDAqwo6YkHhhExOKLAAoAAORnIBwWYUYolHhBSiYUWFFIBQ5MdMDgswEKMUS8FABGkWAjREwIHKlESqUsxEtCHbgIB3pFiJqTRKny9VAqlLMjFrt235JkY9JIFT5mq3KpSzIxN7SZmPSLYqfN1WpVKVZmJu6TUylItCp87WaFUpVqZPc0m5lKRZlJz9VmU9KtzJ7emiZQUWJS0AdugIh3pVkU1KoGT2tNIx6SYAFAAB0FEO9LMQNSiJk9nIQTikwopAKHQgQAaWYANHTEg7EUomFFh3oiYEDoYYgGBVhRyCQdcAd6SYiak0ip9ETkA4LMKMUSjq0WRjUkiVPoqdMDgswEKEO2oRZmPSTcqfRlREqlOGn\\/UGlbpf9p1o5RKgHv0afejSsPepwyItThidGgHv0YfejSsPe\\/q4jyLUuzOhXfv0WfejSsfe\\/i4jSKUu2Oj0VfejSsfd\\/kId6cRhT0sgdHom+9GlY+7+AQ70vFlGlUjJD0QfejSsvd\\/EYoGBeKpRMyY9Dn3o0rL3fyKJlUBeK7UYolHoY+9GlZe7+ZRIqgLxZi0ICUehT70aVn7ugWblWBxGGJX\\/wC9CH3o0rP3dEu1ItS0adPoQ+9GlZ+7pHDMi1OGB0ugz329K19zTOWJFqXYqI0A9+gb329K19zULx5FaXanQoB79AXvt6Vr7mqcRpFKXbHR6APfb0rb3NWId6XiympVE6I89e+3pW3ua0QAacRQDSqRkh5299vStvc15yAcF4qjlEg85e+3pW3ubCokVQF4oQoxRIPN3vt6Vt7mxqoFVBxFmJQh2Hmrz29K29zZVm5VgcRpyc1ee3pW3ubOu0ItTiOOlQD35k89vStvc2lwyItS7A6XMXnt6VM3+JtrcMCLUuyOjQD35c89vSl87a4jyK0u1Ohy157elL529eMIel0Dojyp57elL53AQ70vFlNSqJkuUvPb0pfO5GKBgXigGlEzJjyZ57elL53Q5AODiLo5RIPJHft6UvndlEiqAvFiWjAJR5E79vSl87wsgVUF4wxKEOw8gd+3pSj2Hel2pFqXjTp8gd+3xJdqRal486VAPfjrv2+KOGRFqcMTo0A9+Nu\\/b4s4jyLUsyURoB78Zd+3xheNIpS7Y6PGHft8ZEO9OI0p6WQOjxZ37fGxDvS8UUaVSMiPE3ft8dMUDA4iqUTMmPEXft8fUSKoC8V2oxRIPD3ft8hUSKoDiLMWh\\/8AkeGu\\/b5CI9qRbqLUMEgen1tmJRiiQeFu\\/b4+I9qRSMtSDApP4O2KboHluKJUICA8Jd+3x5FMVhQjiloA7fzexiTun0Aq34S79vjhCGUpKMAKAoF\\/G9ikndPYNZtQD34M6DuTjRCicUYzvRCAQPzPYVF1T6HVaUA9+COfRxjv3FCOMNJpgmGifQKTinsUq04G59HFu9Ix4npNIqYaUQ709t1Jankeq0HgDn0aYN+70hHmUpBsRENSIANPrcIrTpmo1HfnPo0wb4I9qSYKKUg0IjrlEyqA9tspqctjtzb459GmDehHtSLRRam7MqOxLIlWK9tqlkDojvTn0aYPG7iIBSLc61N2RUtmcNSOAfW2YlKJmTNvDn0aYvjdRHtSKBlqRjyJ7U5aJuSvrcOnRgEo7s59GmL43RJEy1IRpS0Adttdx6ToH1vKI7s59GmL43IhDK0hGgWgAA3F7FpOwewKrevG5ufRpi+NwIAqChG96AoBur6ISd09hFm1APfcXPo0xPG3B\\/8AQoR3eiJgQN4fwqTqnsSs03Bz6NMTxtgf3pKNE1JIlSDfHsAkvT6NVZjtrn0aYnjavIoxx1KRblRDfxDvT23U1qdx6rXbHAdyaZP07QJgCkWKilINiohwMxQMD22yHpy0UbDtK\\/o0yXp2YxgLSLM6tINSI8IUTKoD+2wNS7c6BtnX9GmS9OyCPakGp1qQZES4YsgRYHls0omZIdlX9GmR9OxCPakmx1aQjiJ8QcNSOCvbbMSlEzJjsa\\/o0yPo2FJE61IRxScUdsk3RXtuKJUICA7Cv6NMj6NekUyot44C0AduLu49J0D231UK8bAv6NMj6NaQoqClGhQB242+ikndP4JVtXfXL+jTI+jVkKJxRjO9JpgmHHn0Mk7p5CrNqAe+sX9GmR9GpDuIoxpjUkiVIORPoNJzT6KVaatf0aZH0afv\\/dGPMpSSJUw5L5p9ApOKeRyrQdQv6NMj6NKJgCkGJlKRblRDlIh3p5biatO2SjUdMv6NM2N\\/knoxN2pFidWkGhEeXHIBwfW2U9OWijYdIv6NMy9rRItDrUgyIlzJRIqgPbaAaWQOiOiX9GmZe1+cR7Uk2UVpuwKlzZZAiwPrbEKUSMkOgX9GmZe1+UR7UikZakGBSc6dNE3JXttmJRyCQ35l\\/RpmXtfkRTFYUI4paAO3PXbFN0D23VEqEBKP5F\\/RpmXtfiImZSkowAoCgXoC8jknYPoBVD8i3p0zL2vwEKJxRjO9EIBA6CPYpJ3T+DVbUA9\\/wrenTMva\\/l3ERQjhGk0wTDoQ+hkndPIVZtXfv\\/Nb06Zl7X8O9Ix4npNIqYdDH0Ek4p7FqtP5LenTMPZ\\/p3pCPMpSDYiIdDxDvT+ATcU8jlWn8FvTpmHsiPakmCilINCI9FBDvTy3E1KdslGo0t6dNBFF6ig0Kl0YOQDg+tsp6drlT07CUWYjGXgktQCA9F5KfQY1JXQ4eaqOml2Ixl2ouqAe\\/RORmUGASd2rOddFzyzAYy6EHnRB9Josgk7wUXAxhMOwRlxLsai7jQfdDHb1NoWVvEx6VVMqOyRt0OGlRs+g+6ELuCIFlLzpw5O4NtEXdazWo6aQfh0DVVKkWTvMpKdvVXZtrKYSjGXes3qPlEXxefnOBAk7wSRp\\/JrPR29NQyYxt5KJUykUXpediPapO7UW1SEyu+Hc0FzIGjLzEtNHqbsvOJO50GdSk8u\\/Hd27k7c0XedIOCLl5pJXC3Y1KXIu+3xo9VaGjLzKekVyLF5hIzSDAJS6V3Y7+xkVWRoy8U1aTUKoHLJCURYlk7uWcUYwmHgTCVWYjF3ck4oBAeUvX6TMsneSitKKGUHg0dNLsKjbsQc0A9+SunibUsneYmpw4O4NwqNuFdjUZc6DzkSy5ECyV5lLTp2o6Nw6NuNwyqNuFu+48ooVMJO8U0qfSCr03Eoy6V2lRs8g+40I9qk7uRbg\\/lVnw8VKYSjGXas2qOmUH4cV8VKXQizqSm13\\/GimEoxd3qoUxk0XocSlLjQY1J3Cu+48moZMYy8lEqZSCTwvDpKeQYVJ3Qu75E3cHbmjLzEtNXibovCpCYQYhJ3as5oxhMPJG7pRuaMvMBBBwRcvBn0kiyLJXkorRjCYeUNHyrQ0ZeZT0kqVUvAnb1NoWVvIx6VVMqbljGTWZDGXimtRDgcN+XcEQLKXlTh0dwbmDCVWYjG3ci4oB772qqVIspeRUxdvlXZuaRs2uwGKulF5QD33cRAKk7wSRp\\/KLPR5xGXCuxqMuZB5ugj2qTuxBrUjNLvh55F3KuxqNuFu+3GTuZBnUncK77oDG3Su0qMm0H4bZJXA3Y1KXKu+6CFMJRjLtWbVHzCD4NokZpBgErdSzvoQUwlGMvBRAGMmi9DZH0miyCTu9ZxRjCYehSSpkjRd4nILN8k7LsDx8k0LJXkdSlFDKD0ObuTtzRl5iFNXibouscuiNiyd5iNOHB3BuiTV2o1NG3oU1IOCLl1Cy5ESyd5lJTp6q6N0WZvlWhoq8SK0kqVUukOoBAk7xTSp\\/JKvTdGmEmsyGMvBJaiHA4aAR7VJXcg2qRlln49Ho6YWYDG3cg5oB7\\/mk7oQZ1Izi7\\/pHHTi7Gou6EXn45O4kGISdxLvuk8ZcLhjUZcyDz+cnOoMKk7pXd9K426HDOo24G77+shMIMQk7tWc0YwmHpbGXUu0p\\/eSywHUMoP\\/AB6v\\/9oACAEDAAEFAP8Ag\\/8AejLdqEwjRVu1FMA9LTKgFGMJv4APairUBgHpSZUAoxxN+AB7UVagHv0lMoBaMoJvyAYQoq1APfpCZQC0ZUR0AGEKKt3rv0dMcC0ZUR0hTCWiqgPRoxgLRlhHUFOJaKqA9FhMAUZahHvqyqCWiqgPRIR7UZahHvryqCWiqAbocI9qMtQmEdjKqIUVQDdCzLAFGMJtnKqIUU4G6DmVAKMcTbWVUQopgN0DMqAUZQTbcA9qKt2opgNz8ygFoygm3IB7UVagHvzsxwLRlRHdgHtRVqAe\\/NzHAtGVEd6AwhRVqAe\\/MzGAKMt3oR776UwhRVgHmAj2oy1CPfgJTCWiqgPLBHtRlqEe\\/BSnEtFVAeUmW7UJhHhJVBLRVQHkplQCjGE3DSqCWiqAbkJlQCjHE3ESqiFFOBuOmUAtGUE3FSqiFFOBuMmOBaMqI8ZKsIUUwG4qY4Foyojxzv2oq3agMA8RMYC0ZbvyAB7UVagHvw0TAFGWoR78jAe1FWoB78JEe1GWoR78nAwhRVqAe\\/Be9GWoTCPKymEtFWAeBmWAKMYTcvKcS0VUB38yoBRjibmZTiWiqgO9mVAKMoJublUEtFVAd3MoBaMoJudlUEKKoBtzMcC0ZUR5+VUQopwNt5jAWjKiPQMqohRTgbaxMAUZbvXfv0GKt2opgNs4j2oy1CPfoSA9qKt2oDAOxiPajLUI9+hoD2oq1APfYDLAFCYR6IgPairUA99YZUAoxxN0VAwhRVq76gyoBRjiboyUwloin+WmVP8A4FK4AejaPnSufbohxJSa4D0ZR86Vz7f9SKCSiLgbouj50rn0fxIqYtEWA3RVHzpXPo\\/mmsJKIqB+iaPnSufR+AQ70VcxaIoB+iKPnSuPR+MjgQoigH6Ho+dK49H5PFEcCFFMBuhqPnSuPR+cjmimA3QtHzpXHo0ACICm4oB79CUfOlcejRFMJaK5CgHv0HR86Vx6NIQ4kojgB6DJedK49GmIcSURcDdBEvOlcejUEUElJrAboEl50q\\/o1RFRLRFgN0AS86Vf0awi5i0RUD8+S86Vf0a0Q70RcS0RQD88S86Vf0bARwIUUwG50l50q\\/o2EP7URyIUU4G5wl50q\\/o2MBEKI4opgNzZLzpV\\/RsoD2EjigHvzRLzpV\\/Rs5TCWk3ADzNLzpV\\/RtJDiSiOAHmKXnSmDuG1kUElEXA3L0vOlHbiKCSiLAblqXnSjuBFTFpNUD8rS86UdyIuYtEVA\\/KUvOlHdCOBCiKAfk6XnSjuya4lopwNyVLzpR3fxRHAhRRA3I0vOlHeQHsJHNFMBg5Al50o72UwlojmgHvx9LzxIoiWiOAHjyXnihDiSk1wHjiXnTBwAigkojgpuNJedMHAiLGLRFgNxhLzpg4ImqJKIqB+LJedMHjggh3oq5i0RQD8US86YPHByOBCiKAfiSXnTB44QH9qI4EKKcDcQS86YvjhZHHagEDBw1Lzpi+OFqOCkr\\/+ioWm8mU9APfhiXnTF8cJUWAlKORN\\/BFydGkJIinC0vOmJ44OoqBAVdCahHv\\/ADQeHRpvIEV4Sl50xPHBTqgWlHgjQiI\\/jbvjo0g+ItwdPzpieOBmUAtKvKMYTfnbyB0qQeEW4Kn50xPHARMAUq7CjnE2jbyRk6QdEW4Gn50xPG\\/ibtSrvtRzibTAPakJQxKRXKsHAE\\/OmJ430TdqVdgFKKifVFMJabyglpJYqob8n50xPG9iPalHYFpRcx9cQ4kFvK0moCgb4n50xPG8iPalXIEpRcT7EmqZMW8qA0Q4HDek\\/OmJ43hVwBKUcCbZklzJC3lANRRAwbwn50xPG7KLgSlHRjbUi4MiLeTKeg\\/vu6fnTE8boosBKVdiahHvtqDo6NN5Iim7J+dMXxuRlQLSrvvQiI7i3eHRpvIEV3RPzpi+NwOoBQVd96MYTbq3fnRpu9ItuSfnTF8bcYwFpV3RjibeW8gdKkHZFtwT86YvjbDGAKUedqOoJ98Ae1N5IxKQckW25Pzpi+NqMYApV2AUoqJ+AAPam8oYlJLlV2wnnTF8bQI9qVdAWlFhPwQphKKEqIUkqVUNpJ50xfGzquQJSiwn4QRQSC3lKIoCgbOTzpi+NkEe1KuAJSjgx+GJqmTFCVAaKYDBspPOmDZFHAEpR0Y3EElzJC3lCmoogYNjJ50wbEdcpKVdiahHvxNFydEW8mU+xk86YNgOqBAVdf5UI9+LoOzo0hIkU2EnnTBrjqAUFHYjQj3423enRpu\\/ItryedMGsMoBaUeUY4mHjzd+dKkHpFtaTzpg1RjgFKPAo6gn5G3kTp0g6ItqyedMGoEwBSrsAo6gm5MA9qbyRiUi5ItqSedMGmEaVdAWlFRPyoBEKQlDFpJYqoaYnnTCX\\/EdGI9qVdAWlFzH5cU4lFvKCFJqlUDSE86ZX1aER7Uq5AlKODH5kRQSC3laIcDhoiedMr6tAo4KSlHIm5smqZMW8oA0UwGDQE86ZX1fmUWAlKORNzpFwZEW8mU9APcPzE86ZX1fkUVAgKuhNQj356g5OjTeSIf8xPOmV9X4jqgWlHgjQiI9AUHZ0abyJFfyF86ZX1fgOoBaVeUYwm6Ct3p0abviK\\/iL50yvq\\/kJgClXYUc4m6Et350qQekW\\/AXzplfV\\/AR7Uq77UY4m6Gt5I6dIOiLfyL50y3q\\/oI9qVdgFKKifogA9qbyZiUi4It\\/AvnTLeoR7Uo7AtKLmP0UARCkJQxaSWKqFF86Z+p\\/0GUXE\\/RgpxKLeUEKTIJtOu2IsDqGMWjFEo9Fm0aovTaNTQ1ThoRcHUOdOhDt0TbMFF6axREdc5ZEcA6iTpUIduh7dmdemsQROgDtsLmPTXp1FnR6GINjrC1hikopQKGyOYxNenMaoh0ISRMqLWFAKImBA2h1FkWpywUQ6CJpioLWF70kiVINrEO9OogitOWR0B5+UgmFrDGNSLciIbeIANOoch6cNDoDzsA701hzqU3aEQDczEAwOoYpqXbnRHnDWJOtTZiRuG7nTA4OoUBpVEyQ80axii9NY5NDfFUiqg6haUSMmPMG0eovTWLTR4AsgVYHUKJaOQSDyxsyOuLWJIlQB24Gu2IsDqGMSjFEvKUGp1xaw5SUAAHB3DMi9Ooc6dCHbkqKBlhawoFohAIHCnLFNenUSdHkSaRlBawtJpFTDhzmPTXpzGKI8eIQTi1hRNSKBUg4k6jE1qcxyiHGgKI01hzHpBsREOKiHenUURanLBRDiwB3prEnVpuzIhxoQ706iCK04ZnQ4m1izrU2YJoceEoDTqGKel2p0B4c2jlF6axiaHIjkA4OoUDUs3MiPCmzFRemsURGgDtyU6YKA6he9KomSHgzdodcWsOROgDtylVEqoOoXtSiYpjwJBudYWsMUlFKBQ5Ys3IsDqGEtHIJB35JEyotYUAoiYEDmC7Ui4OYYxKEBDeyJicWsL3pJEqQc0cMyL06iDpUIdt3KUTC1hjGpBuREOcOWCa9Ooo6O6AHemsOdSm7QiAc8dRya9OoxRHcWsUdamzBNDoC6i01qdR6iG2tYxRemscmh0EEO9OokitOWKiG0tmCi9NYsiPQgQ706iCKU4ZnQ2VuzOvTWIIlQB26FmKBgdQxT0u2OiOwINjrC1hikoCgHQ85AODqFA1LNzIjrEUDKi1hQLRCAQOiSiRVAdQtKpGSHUJpGUFrC0mkVMOiyqJVQdQohR0xIOkIQTi1hRNSKBUQ6NLtyLA6hjFoxBKOgABGmsOc9INSIB0ecNSLg6hzkoQEPygHemsSdWm7IiHSNwyIvTqJOlQh2\\/E1jDrU2j00Ok7lgmvTqKUR\\/m1jlF6axiaPStzGpr05jFEP6tmKi9NYkiVAHbpc6i01qbQ5E6AAD\\/j1\\/\\/9oACAEBAAEFAP8Ag\\/rLptiT2S27WnVwSTxaCyW5a1FTjGaJ0rOcqYT2RmcdUvPvps\\/9UHCrU8Fk1ZIY6UaSqfScR7VPZBYRQTV0yM8b+bN84j1IHJxgFjINpJLpJPXxHQdTl5yU5+SOlXcSpBZOTUpo8QfJ9IJy8Y2CCevuRmQ8\\/ni5l7DKQWS2zqkV03JOjk1c0fBFnshv5OhER0cTPv4Q8Dkhm\\/pNQixejEtOsYQk9kl29o5zKG00LdEjBDB5EYSdFMBw6KSMo0ik53JqzgF3Cro+qhLukoKoO\\/Y2X6JPXzeOSn8mj3ePnEgproO9JKDqBvWOnehzhwk0TnsmpI1IyruWU2EB7VBX7IxFQV3x090KUUIiWdyU0Z1LTz6bPsoCIVA5DfxlQtzx86HQUxgIE7kRhGVNXK\\/nj7SQ5kzQGR3keMPcDGdT6BTl+R0PU7d0jPDtqK6jY8Fkxy1qKmmU0nz6dvKOggnr3kZzcmzpZmpBZNUSqPk2sqlzqbumPgSz1\\/yEvQj33Vm+cR6kDk6mT5vIpc2mLhYQZJ7Iz2QE5zKG3iOlXcSpB5OSVpu5Sdp8ylJlnDJTuTHLqll1HJ98ipt7CqweS2ruklk3BOXP5FtFpTuTjnp27WfK8Ah7gfQSkDkZlI0Q5VA5U7eIMU53JyadP5JzKK8EhbokII0DkJhKUA9+TrLJtyTuS2zWpOYeTCvCIK8JCBGCvyNmOSHOVMJ\\/IrKOCYuB9OqcMgL2kIIYG846dDj4j2qdv+PiBmrpkZ4eHgPaoK\\/pGIqDuyOni8cnr3joQJy85Kc4oAiFQeRn8dULc0fOl4xO3bHwATt+yMvQj34uQ5kzQWSXjGomeYzROKTNzR8EWdyI+k6ERHjaC6jY8Hkxy1qMmGcwnxCWnGMInPZJdPQVVOufjzR2sxVg8nHJUfJtZVPhkjKNYlKeyaqrS7hV0fkTGQcRqsDk0DU0eoP0+EO3qDBOeybTx84kFOTRss7iFIHJqKwN3CTtPgiy6bYk9kxFEJKWdy6nKomefQh4LJbV3SSybgnAFFCIln8kNGAy08+mz8uhrkfwR4HIrGRAhyqBvgj2qcyIwjKmrmkJ43MoW6ZGBGCyDHyoAPfep2\\/I2HqdvCQnh5tCXnJQdQd+Rsxu85eMdBVPXzIzXO4K+ZKFqDvKNndzmbojoIs9kCQlwEe\\/PQHtUHf8jEVCXVHT4bdLzzGDTn8jvJATnMoboAQ5kxg8jPo6oW5GE8XapKYZw6c7kxy6pddRyfoIkqdA8Bkl0yCJnWM2TZn0g2jUp3Jxz07erv1OhCDhVqeByYu2CNlmkulsTp0iySncnJp1ISbqVV6GNHq7BSDycclMJFtKJa5VZNuScyW1aVKTT2ZU6IMJJzFqwOTSHBo8QfJ6oxgIE9kVjHBM3E+nlOikbLO4hSCyaguCK6bkmnnb9joepy65CfN0YiZ59CHtO+SXCppbjlTQUTB5Ig7kOokdEejONvmtLkD\\/AFerayFL22Ft3zEXMCiR0TdF8bfNaXIH+r\\/1tnJkrb5beu+Jus5yGTN0Vxt81pb\\/AA\\/ytj+ACIDbmV5SJCBuOKuggh26KY2+a0t+f6z\\/ACTUMka2stvI4sLNR1yp9EsbfNaW\\/P8AWfwILqtlIHMDtMYuQZTyPRDG3zWlvsO9tfiZPnEctbuYf8gj3rWXQ6HY2+a0t8\\/63+SLl3sIvb2X0HNIqIu0uhmNvmtLfP8Arf5oidfwK0BlxhJCT\\/FZLoVjb5rS3qAGt7QQF0Sdsq23lONlqFMQJ0Ixt81pbz\\/1\\/RW9eErbBoLJ8POCdMxOg+NzAE1pbz\\/1\\/SW1fsva9W5kGGuUTkMToLj353S3b8HprXyLK21UBfELcoKpHQP0Cx787pbt+D1Fu5Ql4Qlv3VE3SU5DJj0Ax787pbrATQmpKYSjbOWJGKqBuOMuYgh25\\/j353S3L8Pq0lToHt\\/Lz5oWJl464U+e49+d0ty\\/D61u5VaKW7mFVMI1+znEed49+d0ty\\/D6+OknUQ4t7L\\/\\/AGU0WbySPOce\\/O6W5fh9hiph9Br2\\/l5s6Kgqk8S5vj353S3L8PscJcUlbi1uZYj5Uxf8VE+a4+HtO6W5fh9lgLpk7ZVtzKMTMAZMSl5nj\\/57S3L8Ps9uXtL2sNuZIh7gpVE6I8xx\\/wDPaW5fh9pti\\/5a2Bt7IEPcYmIYg8vx\\/wDPaWRRI5abXbOS5e3S29ekPdAHIZM3Lcf\\/AD2ldezttt5QlIWoC54m6qEBDlmP\\/ntK69nbimEg27lqRjwgpyOuZIQ7cqsD57SuvZ3BFZRue3cvu2oRMuwuBPlFgfPaV17O5NHi7BW3sxKVHvWkwhyawR7T2ldezukdJu4he28upKA0XQkUOSWJ87pXXs7tETb+BXt7LjWQOn\\/g4R5FYnzuldezvEHcklba1u5XjJUCdlE+QWJ87pXBROlvVu3jLWsa3soxM1SiRk+P2J87xK3b1lrZG38jwtw0okdEeOWJ87xS2chy9sltq+Ye5iqJHRNxqxPneLW1kyWt8sHecLc1HIZM3GLE+d4uA9qt3LErFBAXLFXSQQ7cXsT53jKahkjW1ll7HVCzcdcqfjitifO6YfPBEV1Gx4LMLxOomSZT6PE7E+d0w+eDMnziOWtvMH+Qx75rLocRsT53TG88Iiph9BuLfzAi4BFVB4lw+xPndMf1cKiJx\\/ArW7lti\\/r\\/ADTFHhtifO6Y\\/q4U5cos0ruz23ZnJLP3dx4y+4UNP01cIvm\\/C7E+d0xw7G4Qssm3TvHPMbEjcNzzN4Kf1sDLV04zWxz9urWu8EzkWJwmxPndMr6+D3TnG34JS5rzm70FNMqRf5Y2zrd+Lhxj9o7QyDQlEA4PYnzumV9fBbxy5CWmN4X1N3sZNIiIfixl9grtxibG32RszJAqpHQPwWylBSm9MsHZTgd5ZOhbNC7clXHeoN2yTUn5safZ28ceExpnu0co0chkx4HZ3zWmX9zgN4ZIgrILc2YLnuY6KBEA0JTCQcW\\/a66LGHHeaLSyemIduBWd81pl\\/c3+7L8hLKQunNkzcRf8e59K3cKtFcbfcK5LbGwMm2zk5twCzvmtM4\\/srvtw3TEWohdGc5CYD\\/qE6upZvXEctjD7jysMNl31b+RGm\\/Wd81pnPu73NTsfbrW8c6PnYrJGdutbBz0jbT3Gf3MdthtW64e94\\/fLO+a0zn3d5kJFrFI3Zn1RyV86ezLnYbbuqYs97jT7noKkg5+LuhpvVnfNaZ5\\/6N3ePG8ejdH2BbInmJiTuVbZbMv+4cfPMZfcmMmjRz9rMM94s75rTPP\\/AEbquum2TuvPMUwG5LgkrwW2mxMmXJjd3jL7fW7chEFU3SG7Wd81pnv9nG6XbmqGgzXNc8zex00ypF2zHeY7sxerjP7Z2xehu3cu6Wd81ppD\\/wBW5XnmGHtSrove4r0OkimgTcMZ53uzFqmNPtBaGQKD+5dys75rTSH\\/AKtwvHLUFaBrnybcl5gQhU91xf8AYy7cY1jP7FWfksqqR0T7hZ3zWmki\\/wCLvbrwybAWQFz5euC6QSRIiG8Yu+z9149NjnOtn5PKICG32d81ppX\\/ANu2XXfULZiN4ZjmripFskgO9pqGSNjP7a3TZwY4y7bGU0BDtttnfNaaV\\/8AbtVw3TFWshdubZedFNsUqu\\/tnKzJXGX3En7aJY+TLXySjtdqqCnMaaZL\\/hIbRO3FG2y2uvPEnJUqKztbgbCQdRa+NfubKR1WfekDf7LabZ+X0058js0vNMYBtdWf1XQyL53MueDwU\\/JWy8xd9yzIEtu5Im8mGz2z8vppz5HZHj1vHI3Nn5n2l5J9ca\\/C7Xu+asp7jn7ooPaipRjPNNltn5fTXEAFldiXXTap3fnNjGjPychdy3D7MyBcOPXmNfuRDT1R0i0mGux2z8vprj+W2AxgKF5ZujISrjuWavNUpQKHErAync2M3eNPt7bl1UQSqp7DbPy+muP5bX3fmyDtw9w33cd40mmVIvFseZkuvGKmN\\/tbaF8iAgYNfbPy+muP5bW3jmG37RPduR528qKUC8bxj9gLvxabFv2WtTJAmIYg622fl9Ncfy2ru3JMFZw3dlKdvEqDdNsXj2MPsrd+NQx19h7LyVRyGTNq7Z+X01x\\/Lam7L8hrMSu7L1w3IdqyRZhyEBEBxh9p7rsAuNc1WnlUggIaq2\\/ltNcfy2nue8oi0ELtzZOXEAlE6vJUlTtz4x+2lzWfVgZYtXJqHjUW38tprj+W0tw3TE2o3uLPkhLAqZVyrylq7XYq45+5M\\/CBY+QLeyQz01t\\/Laa7m5mk7o5qdj7ca3ZnlRzT1VWTd8ti5Z7BusYfct8xNaN6wV+s9Jbny2mv\\/wD2fQvHrePSuzPKRySbh3PueYwFxylqvcafdDvUFPRV1M9Fbny2mv8A\\/wBn\\/O4cpM0rwzw3YmmZWTudxzW1rxm7KeYy+5TKRGKlmE810FufLaa\\/\\/wDZ\\/wAqqpECXfneMixuS6Zi8VOc2Lkm5MbPcZ\\/cSGnxYvG8m1\\/Nbvyumv8A\\/wBn\\/JdOcbfglLmvWcvQU0ypF55j\\/LN04xcYz+3Nr3WRNQi6f5Ld+V01\\/wD+z\\/ivHLcHaY3jfc3exk0iIh0Axxmq6sXrYy+1Fp38cSiAfigR7Semv\\/8A2f8ABd2S4Sz6uzJlw3oVu2Sal6CYz+wN3YxHF32UtLI4GIYg\\/ggfk9Nf\\/wDs\\/wDK8MiQlkp3NmG5LkMigRAOhGMPsvd2Ni46+wtm5Ko5DJm\\/lA\\/J6a\\/\\/APZ\\/4XZfcJZSF05tmbhKIf5qdCwESjjL7WXbYwY5zTaOUUxDt\\/GB+T02RwAt2\\/0uC6Yi1ULnzo\\/lg\\/6hOr0PRWUbKYu+2txWfWPsqWvlBHx\\/WB+T02Sf9umZyPt1reGdHbqnBTvXPRNo7XYLY5+5M\\/C1Y+QbdyQ1qB+T02f80S8feT94+m3HReKl3sG6xf8Act6zGy7YfzJdNk3DVoZfY5m\\/Xnclr0+YOYxfothv6l3\\/AJkHDf0xx\\/iUNTlb6\\/WNmVDNH0FvGwQctVmSvRLD31svrNa+FfotZONKKUCBrMzfWiyM2oZp+jl84wpRM6J+h2LsG3rmN1hX6AWtYx2rVBijsGZvqfYWaAzZ9Nb5w+YQ7dC8d4qurKshg\\/8AXrCQBYiGYQDTZMx\\/S\\/H+WQzH9S7\\/AMNj0HtCx5+\\/n+E\\/11tmwWvacNZUfs5igcM3fR2ysojmH6zX3hZXoHb1tyl2PsM\\/roevqsnH1t44YbW4bpO0sz\\/QezL\\/AKyzgK9MMPOfxUQ+nXeFf16XDcpsbYftHEjHb5GNaS7fM369rXusuTcLXliB3zts2WeK4X+gt438GKsAWPhtDc56AjboYZp\\/XdFzNZCxbdOK5Dm5CGUNhT6Q3zlOsMfWeyMIobvdFpw17R+a\\/wBdTdwF32PP2C+5phr6f3\\/mGsLfUaw8NE3u9cf25kZhmf8AXQ6Z1c9pzNlP+YYd+sd9ZpVwn9JrGxYnv+SMU2tlmOzT+vCbgKm4KRtp7yzE2Ar0zO8wt9C7Nx2Zu3SaJcCydhSzcvtM2\\/r8uazjPWTiOW5RjPD125dkML\\/r1tu1ajo1pEN+DZX+vVi5nRzN9CL0sCnDdVorySw8b3Nk2Qwp+uyOi6ty2Im0GHCsw\\/VqwszJZr+kF84so5DJm5Ba1oTV7P8ADH651XBbPsiBx\\/HcOzH9SLAzGXMn08v\\/ABDx6EgpG5XuFf14Tc9WPMX2xiuM4lmf6WWFlgMyfU2\\/8MjxlozXfrYV\\/X\\/dd5nxjhOzMPtOKuG6TtLNX0VsnJVZh+td9YUX4qkkdwfCH0ZvPJw4i+udjYVS4y6aoPkc1\\/Qa0L8DKWCb1w454iAd6wl9NL5zAbDP1TsLC5OOyUYzmW2Z\\/wBelt3TWS8PXbiKQ4dhv6m3\\/mYcM\\/S+wcTF5DcdsxN3sc0\\/rsjZar9xpc+MX\\/CsRfXG+s0LYV+idk41pu3SaJckuqz4S92Gav11Coe7bKnrDf8ABsX4RvPMTvDX6+bWs6mrRBijyi+cd23kqOzN+uh6xq4balbTfcCx5i26cqSGEP15RMCMPCsLfacsyTiC0ctMc1\\/rynbcqXhn9vu9+tGyZ6\\/H+Ev11poGta0IWyWHMMn4SszMLTMn6\\/rvsunbNdgtvUBbspdT7Cf67XssnY2O7bxrHc0y79drHzUhm\\/6KXjjIq6CjVTdmMe5lF8Mfr0uO56xph20MRsucZj+q9hZnTzT9Jb7xWYxRIO5N26rtXC\\/0HvK\\/6xT9fbGwyhzzNX1BsTMw5k+n+QMP7gUonHCn0kvrKo4d+rVh4ZS6AZm+k1hZVDM31bvrCi22Ya+oWQMxVhT6gWLhkegbhuk7SzT9EbJyRWXPrjfWF1tow79Zb7zUthD6R2TiwpSgQOgzpog+RzV+v+1r4Uyjgy9cOudkxZgi9cxucMfQezMf03bpNEuhUrEsp1pmz9etv3CnkbE114of7BjnEt15Xf4Z\\/XlbtsBGxjOGbdDrkteIvBhmr9dcfJ1fmNrmxlIayyMfXFkeSwp+utjGjbdrxFnsOiV4WTBX\\/HZk\\/XMoSrssydsR\\/qLXtKavV\\/hf9dDh2FmWDbuPGPRa\\/Mb21k2Pzf8ArwfwxZ+3ZS1X2kh4Z\\/cDvCv68JyfHG+KLWxNHdGslYetDLjLNP687hto0tEPoF3oGrRd8rhr9f8AeF7VivB1m4aZdHsr4HsvNDbMn6\\/7xsinTRdir+RNM6x8K\\/Ry+MnViP632JhdHpFlz632JmhHN30ZvTGIrIqNz\\/hwr9Or7y+fDH1PsLC5ek2Y\\/qpYOZyZn+k9+4qoQEo\\/xwv9Vb7zYfC\\/0ssLE4dKsx\\/TPH+WgzJ9QsgYd\\/riP653zmlbCn0RsvHFN26TRLpYYoHDM30ksLKlYo\\/XpZtmLsI5rFN\\/+PV\\/\\/9oACAECAgY\\/AP8Ag\\/oGWJzIAywuZ40WrE7mzh+hCyw7mQ6KXuDO+AhZYNzIdEqzBrfiIWWHcyHRC6ZlnOQIQywvZDodcz3nJHhlhfz0NOZYn8soeyh+hZAyxPZBlb97VjQkgZY9zIMvtasaDkDLFuZBmNziz5q9BaxOZwzOocWfoHUuZ2a1hdyZ+gOoM6evNyFlhcyGX9lbLOc5IWWHcyGXbme852QssG5kMt3MsTzwz0hZYdzIZZoGWJ7IM+oWWF7PlegZYtzIJAvZYX85WIGWLcyCQr2UPEqEDLE5kEiXztWJSrE4M6RtRasShUuDOkiocWfNXJ2oNbJVQ5nyZdNWz3mTKwu5M8SVcyl8nELLC5kIki5lifKBCyw7mQyNQMse5kEo0LLBuZDIlAyx7mQSnQssO5kMhUDLFuZBKt4ZYXs+QSxO5s4SveywvHHP6lzOlm9nPGe6gzp65b2tWM72NWZd1FrM5uZS8y\\/c4s\\/N7mWJ\\/LQGocz81oAyxPZBoGWFzPzOgZYtzINBKFlhcyHMaBli3Mg0GoWWHcyHL3MsTmQDQihZYdzIcsWJw4s7QqhZYdzIcoe4M7foZeGUTZNDBWQN5RndQsn3eWjGD7oeY\\/opcaxP6ss4rHiNF8H3Q8x+hZjWPEUssTxWNXaLYPuh5j9Sw9JsmvDdQdWJvS\\/RXB90PMfAWDpPDd5N1hLaNFMH3Q8x8FCywOso9GSMJy36J4PuHMfDQvZe2UsM1xoZIgmiWD7hzHxUiChl7ZuPgfNkiCG3RHB9w5j46RBWXtlbDPv897IXGrRDD9w55CkQVlgeKqfVk0Pw\\/cOeR9Qvpbp6hx9dD0P3Dnkrw+sTso6hZPu8tAxu55ND9w55OsxrGr2rFY8RoEN3PJofuHPKVDjWPEN1BRWJvTQEbueTQ7RzytYek8Lx5N1B1dGgA3c8mh2jnlqwdJ4bqLmSMJbRv80l8bueTQ7Rzy5Cy9spZR5hkjCeOyXhu55NDtHPMCRBQy9vcfNkiCG3V8ujdzyaHaOeYkiChl7ZuPgfPeyRBDLg3c8mh2jnmRIgrL232Ge6u9kLjLY3c8mh2jnmZIgywPFVPqyS0N3PJodo55o6hfTvZYeocd1N0szdzyaHaOeanuNYn12ss4s8pYm7nkwIrzYsxrHjWz3iseIlebuchFDjWPEN1B1Ym9JWm7nIZYek8N3k3UHV0el8qzdzkO9lgdZR6auZIgnLfKk3c5EoXsvbKWGb0ZIgmtcpzdzkWkQUMvb3HwLJEEMpTrTI1IgrL232Hz82QuNRlGdaZHpEFZYHiqmneyGUJ1pkj1C+neyw9Q4+soDrTJPqF9LKOoWT7vLdJ460yVUuNYn9b2WcVjxEnDrTJdZjWPFnvFY8qJNHWmTKw9JsmvDdQdWJvS+TB1pk2sDjw3N1i+iSx1pk4hZYHWUejJGE5b5KHWmTyF7L23WGb04skQSSR1plAkQUMvbNx8D5skQQ268pIHWmUSRBWXtvsM+\\/zZC41GRx1plEpbpCCsu3CehLLWXuDESEU0TzVT0Uti7JUVGemY00BsMQQiguMjDrTKHoF5m9aNomZYnn+\\/mn6E7gW2kbCy9o4hVNFRcaatjIXSKOtMn0hfbRr5MsbzwE1G0cU+B1h\\/uDot\\/gVDLB1w2fMNopu3SJOtMnUgC8qabk2ssZWyYU+mwzMg+GsQQ+4T0756WUdQrE98M+5WdIYybSEKf7Tm8MvcNwmvrpBZA746kYYqxdOJjMykYhWPEUSFMmUAJNQZe4UsHidVE7JCEGRrD0xViY7R5IbWWIKPcHimepwp3yDMl0DzUyxuFVNPobCyQhNfXJ17fQbPl3UXI38gdX9JmponpQyBMlUZYnCqmjdSOTJCPM33ZUhZez0mr6T\\/8AN25k7gSo0HYdTn8yUf0jeabvQt0h9Zny7DEAQZwWxdkoajNTNSOIDYe4EPA7DTn0ySWYVme4X07EZQ81nMWGMAioti7B\\/wATdMd867Q2GMEG3V92ezI9SzggrOu0WGhlnNZu3TLtzNh7gBFvhVc2Lslf2me4+e9sMQIIoOeTI7p3mb19VZS8230bCmasPcC8xsNDGLtdQq+oeB4HayFxE4M4zuZGdIvoo3uK21ssfUeA2DfcUZBm1O4FtmI2FsXb6hV9VG+mbcyZ1MikgC8qabjeyxlTY4azHayDOPWH+4fMNbVDEw9UNnzCecbKt2dDIjDCFPC8svcfZ57+ChkGdViCH3Ce+g3soGIVjxE+5RnI5OM3oHmzW9l7m4XT8doLJCEGeSR0xVi6cUzerLEFHuE14nHK3OBycZtQPNQ1sbrKWC+nceBZIQBn0xQ9MVkxnnG0vIQt1h3uE19V+bjk4zWgnZY+kVU0bqRWDSyQiQCFsXb6D\\/ruou3Fv5BeHw0U30pmw7MnGzNSxdI46+BVunfTIRCy9k4TVPD5jlY2HuAjkZ5jNRtrzUdhycbBmd7VCvyG48GcH100+e6RGGIKDQWxdgp+0zXGjY8bGw9wEG2nYZjdmg7Dk42DMyhwrN03HYQ8Ms5rN254WRmGMAiosvZP+MV00W8vXa2GMEGou12zZmOw5ONgzJ0hLTfRPOOKsp6jWfKb+yyQw9wAjWapsXZKj2memY00AKm0thiCGo5kOw5ONgzF0C8zUb51trZYnnhrONk8lMPcC8xsLL2jiFX1eR4HayFxqLjuzEdhycbBmBIAvLfv5Msbzwo8mSS\\/8gW2Y77mWDrG6LdTduzCdhycbBlyQhTrTtdYy9x9lFOu0OZ0m1iCH3Bxp3zzFQ2KHqhsDxPOOZGXnYcnGwZYkL9R57mXuG4TUTmmkVEMkIQSfUhIvcJ76DeypiFcN04nD9u3LTsOTjYMqQBTUNbGXuFLB57uRZIQko8Q6Yqx4ibkbWWIKPcJr6Re63KzsOTjYMoQPNQZY3Cqn08CKWSESnxQ9MVkxnnG00N1h1YfD6XplJ2HJxsGTrF0jjR6jiCyQjzo8pVIWXtdBq+miii7cydwJb9J2Hwnyc7Dk8JrA5ZI9n9I40+htDdIfXOaab5XJEFFRbF2ThNR+X\\/88RYydwJyOw3ZKdhyeD7RyGRrMKzdMNhppDwyzms6\\/wBpZYYgoNBbF2Cn7TNcZxerYe4DCbfCgz0ZGdhyeD7RyGQPbpCCs30T0Jxeyl5rPluvfLbDGARa2LsH\\/EnkfPe2GMEGo5CdhyeD7RyHx+gXmb1o2iZlLzbf5pbLrD3ADzGwzi5sXZKioz0zGmgBd7GGIIROPjnYeWTwfaOQ+KkL7aNfJljeeFFG0cUl8ncC20jYZ2XtdQqmiE1xpq2FkLjb8U7DyyeD7RyHw0hC8qabk2ssZWyYU+mwhzINAKRh9YnF9zYoOsWfNupu3fEOw5PB9o5D4KQhT\\/ac3hl7huE19dINDIHaBViCH3Bxp3z0ssPVDWJxtGykfCOw5PB9o5D9aAEmoMvc3Dz1cXhkhCDQSpCGseImPO1lTEKxdOJw82\\/AOw5PB9o5D9KB5qZY3CoT0+hsLJCE19dBqjpirE14m8bWWIKPcHimekOFLrf1HYcng+2HkP6oyxOFVNG6kMkI8zfdoRxQdMVkxnnF84b+QOrD4fS\\/9B2HJ4Pth5D+j+kbzTd5gt0i+nQohZe10Gr6aKKLtzJ3Alv0nYf6HYcnhwOEIEJJnUAKgvcTuZzzXrtOhhIgoqLYuycJ9p+WmakcRY0UBnCwurDp8nXtRJWPpO0eM7Ye8MBrnh8xe61lGhdIisXtDzfVeyQnBDVDPRPFPRQmVfxxO9pfDTRRPQjYe50RW\\/L\\/ANvNL2UaE\\/5C+iEPiN1G0oGMPb6If9jPTQ6rflyQlYfaZrqjsYQxHBFUZiXTGaeaY6EF7sQFlJ2CdjD2BgFf1Ubqa2UvOYUBxQ+2LwM45WMi4YvafA08NmgzF3YgBz2ClsP4zh7jPcJhe\\/Y2KMkk0l5zKkRxw1RT0zRT71ZISkXtLjdXdoIxdwiEVlzYfxh\\/kfCHz3Nj7hJNZzSIe51w2\\/MJpjTYDvb+OJ\\/tLot1O0O0CGKIgAUlsP44U+4zXCc3o2LuxGI2+AmF2bFE7Ye71w1\\/UL6b97L2itY+oTzi7QBiiKATkzMYex1mv6R4nlay92ImygbBftzhihJBrDi2HvjEKw6LyPC9sXaiBspG0Ty8Uth7fXFZ8u\\/yVv5Ine0OhoopmpXOgjgKETEMIfyAv7hPROKaSU3Nj7UQiFlG0Tg7ZcmEHHFUJhtM3M2MkRSH2ia+s7c8Y+2SDWGw\\/kj\\/ACHjD5bmxdsiIViWqRHFF7YXmiegT0si4YfaPEznlZnzF2ojCbPETG9sP5AQ+4TXicXK2KAgg0h8sf5C\\/wBofFTumRSxhg6IbPmItPkl8gMXaKVig7Qwh74wmsfKZrxTYK2EUJBBmIeJW4u6UqH1HYL2MPa6If8AY30XPtZTPINe1Elk8Ju1LYe90RV\\/Sb6L97KJU4+6UHE7BO2H8cYR7j83kOLYoiSay8yH\\/jid7S+HdRPQjYe50RW\\/L\\/280lNj7kQhFvhXcxh\\/HCfuM9w8TubH3CSTSZFoDih9peKJqQ4JVYwhJwRVGY7DNyNkosUZAApLmw\\/jhf3Ga4TmmdGx9wmI2yPQHFD7YvAzjlYyQnDF7YnGmaguFEnjFEQAJyZmMPYGI1\\/SJ7zRYa2x90k2UDYKJJ4YjjhqM90U+9WSApF7S43V3SaUsYez1xf6iamm7ey92JbJoRdqZLKJ2EPd64f9hNTS6ve38ZfTCXRC6naFElzDB1xVCYTzmxJp2\\/kLvaHQ+t6yaUOLYe91w1\\/Vvpvfay9qIGykbRPRJNFxRe0eJo1cyE4YfaPEznlZJ7FCSCKQ4th\\/IGIe4Oi3THg2PtFRxG0TyPSIrF7Q831XthhOCGoT3xT7klFj7ZIIpDCH8gL+4T0TimklNzYu3EIhZ41SL\\/kif7Q+Ld4lzGHtdEP+xnpodVvZTPKXF2yYTWGEP5I\\/yF88O6ZsXbIiFYfIfF3YgLKTsE7YewMArL4qLhxZS8ypxdqIg89omN7YfyAh9wmvE4uVsUJBBpEg8fdiAFtOwUnYxg\\/GCfuM9MwoV072xRkkmkvMrV7URFlB2i7awh74wmv6T4jiLWxQlQaRn\\/F3CIRWXNh\\/GH+RHIee5sXcJiNssV7USWTwm7xnbD3eg2\\/LTTRfSyjPZiiIAFJYwfjjEfcfluFPC9sXdiJPAbBMLpa\\/xl3tL4fS5Gwx9EVpcaHHwPHPClsPYGM1zQ+Z5WsvdiJqFA2DU2y5QHFD7YniiakOGyxhCTgiqPgZjwNmdcPb64rPl\\/7eSt\\/JE72h0NFFM1Ky9w\\/NDUaNhoZIThi9sTjTNQZqM44QccVQmG00cTYyE4YfaHCmekuKVWaAcMfXDUZ7ovNW6Ch9p+ajfPRm1IisXtheb6Be2H5YahTtNPLQIonYQ93rht+YTU0372\\/jif7S6IXeIdmn+Qv9ofFTRRNOWw9vohs+Y7TQ6gcdBChxYQ98YxX9VO+ipl7UQNlI2ifMq92ICyk7BPS2Hs9ENf1G+i59rKZ9BYihJBExDiwh\\/IGIe4fMNomPA7WxdqIEctoonzDi7sQA57BTM2H8cYR7j826YcWxREkmkvOg\\/H2yQawwh\\/JC\\/uE948RubF24hELPGq\\/LTH3CABW2H8YJ+4+A89zY+4STWdCePtkwmxsP5AT90M1M8M9QcrYu2REKwVynFGQAKS5sP44X9xmuE5vS9sXdiMRt8BMLtC+LtREHgdomN7YPyBhPuHynaKNs2xhFCQQaRkuKIoBSWMPYGI1\\/SJ7zyNbYu6VqFA2DQ2vaiIsoO0XbbWEPf6DX9J8RytbFCVBpE2QqWw9rrNny0U03MvcLqg6EXaH\\/AOMupBfCbvJsPd6Db8tNNF6Mo+MYYTjiqEwL5ztD6W6yg9odD63roj6Co9pfD6XIwhj6IqjMZpjas0\\/wyCcUXtF05onZCcMPth8TOeVmidAcUPtieLqRysbCThiqi8DMeBs\\/WkZWL2h58he2GHohqE98U+5NFaE44aop6Zop5zSrJCUi9sTjdQbv6\\/yRP9ofEbvEoGMPa6If9jfRdvZTPouwx9cNRnui81ZO0MFq4jc4AbmxREk1l5\\/49f8A\\/9oACAEDAgY\\/AP8AhAO\\/o9naLXM\\/9L2dozfozcz9GbmfofdkjmfoaeztF72dowdowcz9F7mfmd+gh2bHs7Rm9naM3s7Rm+XD2dnpzPlo9nZ+cz5YPZ0gnM+VrtGDmfovcz\\/\\/AC1fo0ezpLOk69nSRezpQvZ0jXs6Ur5FulQ5nyHcz5VuZ8g3M+V7mf8A+v8AeztAb2dmt7O0DvZ2aHaC3s7MjmfoOezswOZ+hJ+WuZ+hVzP0ZuZMmMVQJZ7uWuq6MYth5f0d6M93LXbovi2Hl+h25kmOtOi2LYeX6q9dbLGt11r0VxbDy+Ak4Z27RTFsPL4T389\\/mztE8Ww8viPfz9dXs7RLFsPL4qt1P5+XJnaI4th5fHVurePLy3Mo0QxbDyyFQyRb\\/RlGh+LYeWRubqdy136Hoth5ZK7014s93LXVdDh2Hlk7t1DPdrX5poaOw8spdu1mao6616GDsPLK6xrrVYyTHQsdh5ZbXrX5qzt1OuzQodh5Ze9\\/PXVWdoSOw8swvfz9WdoQOw8sxK3U\\/XWpnaDjsPLMihurf6eW5lGgw7DyzMoZIt+vqyjQUdh5Zoc3U7l6aCTsPLNTvTXiz3ctdV0Doc2O3Ua7Ge7WvRm6arWZkmOutdmjOtratZ7tGdetfmzt2jN7+euqs7RmkT+fqztGfVv9PJlGjJQ3Vv8ATXYyjRk5urXW\\/Rm5zPdy9NX6M3ejPdy126M3bqGe7Wv+2jOvbr6WNUdda7NGdY1pZ27Rm9\\/Pf5s710Zvfz9dXs7RkrdT9d3JnaM+rf6eW5lGjLpcNZ2SNx4Mo0Wv113M7Xy1f+jpN1DJE48JRCRLvgOLqmQuPDfKASHQMp+Gk4qLJMajJ4SEeyQ666hlPx0LxaznGoycEgnsg18eV7PyNInji3SbqZNCQLtdbN7PyZzJG8cWWE+cmBn9Az8qUMkb7aWWErJYZ+flygoydzeGWErJQZ7111mbXXwzEsJRk7gvHkygrJIZ5113tVmZYSjJG62hlEkBnd+uu5nOzUsJZInHgyyOGdnO11883dJuoZInHhoAeztdb2U5xdNUWQuNvnLxS3TrrbuZ+dUnFRao1GXKDXW5lOeULwzi+oy1cz8+pE8cW6TdTLFBrrqWfIBQyRvHFlhPnK1A\\/XWtnyEUMkb7aWWErKnXUc7JErCUZO5vHkywlZS6672qkYsJRkj3hlD5ROdJBYSjJG410ejKJOvZ2vlztkp0nyZInHhJp7O1u\\/uymS7jcyFx4SWUs7XW3cz5NoHioskxtkmkLKZPpOKiznGoyPdrrcz5RoXhukvqpysZwQP1182fKdInji3SbqcpGbkHDz\\/uz5VKGSN9tLLCVycZOlWS66jmz5XKGTuPtZYSuSjJztORP\\/pVrrZLJYSjJ3N48mWEqMjGTnacic6WywlGSN1oZQ\\/IRk52n472dr5avl0sJZI3GuhlHxxk52n4zpfdJuoZInHh8YZOdp+I5lOgFxdUyFx4b8xnafhJDrrqGU6BUDxUWSY1HMJ2n9b2Qa63Xs\\/QSk4tZzjUcvO0\\/qdrrZvZ+g1C8N0l9VOWnaef6EDP0IpE8cW6TdTlZ2nn\\/RzP0KKGSN9tLLCVykrOX82118LNDChk7j7ROwN+TpEFZe2+ylkOhdZhWWWc1nKuoX0ssDxxZDoTcHVllLzl3UH1ssLxx0IdIvoZY3nhmJ4Q1hlDxZoMSEKy9x5qoZBmVZjWGWcVjQQkIVl7m4MkIQZpUOLPDqxoESEKy9w3BkhCZtWFx4N1C+jQAgey9xwqpZIQmcELLA48G6h5S8QMsbhxbpHnnRCy9t1lDJEElysThxbpD66c8JEFDL29xZIgktVmFZZwU1nPiRBWXtm4+bJEEli4IKyyl5tkAkQVl7b7KWQhDK3pF9DLE88JCJEFZe28VUshlSkIZY3ngyCQ\\/UL6WWB44shlKkIVl7j7KGQOkW8PrZYXjjKJIQrL3DcGSEIJHvCGsMs4rEnkAUsvcdYyQhJJrMawyzisSaQMsbhxZIRJdQ4s8OrEl1icOLdIvpk2sLjwbqF9Ek1LhazgprMnkLLA48GSISPWYVllnNZlEhey9t1lDJEEkX0h1dDKXmUyRBWXt7iyRBJD9IvoZY3nhKpIgrL2zcWSIJINIQrL3H2UMglakQVl7b7KWQuz+kIVl7m4MkISWKRBlgeOLIc9pCFZe4bgyQhJa9QvpZYXjjnhAy9x1lLJCEly8PrDKHjOiBljcOLdIvpl6pcawyzisZxUuDOD69AKzGsM94rGbVmFZZQ81nQKsLjwbqDq6M0uDqyyl5t0ErA48G6hfRmXpF9DLE88NBiFlgcaqGSIZhSEMsbzwZBoPQhWXtusoZIgmWpCFZe4+xkATQmkQUMvbNxZIgmUpCFZe5uDJCE0LpEFZe3uLJEEyVA9l7jrKWSEJobSIKy9t4qpZC7IUDLG4cWSEeeh9IgywPHFkPxlicOLdIvp0R9QvpZYXjj8NS4VlnBTWdE7w+sMoeLP1qHCsss5rOitZjWGWcVj+vSHV0MsTzw0XqHGsMsXVyZB\\/wAev\\/\\/aAAgBAQEGPwD\\/AMD+Zrh1SNcyzGgHrODb7Ionk6ZGqEHUMifzevHxc9zKZa1BDEAdOQGQwsG8r28XDtFoHH9R\\/N147XbplkyqV4MvWpz\\/AKvksLuQqjMk5AYa32sfFTj3gaRg59PE08w+fHabjMzgHJBko6gMv6AntnaORTUMpII9YwtvvqdonDtkFGHHioyPRwp68fEbfKsqdOk5jrHEfJRU4MNiRdXHmQ8gy6W6fV84wfjZaRdEScqD1dPrr+QFzZSNFKPeQ0OFt9\\/QEE07aMUI9LL\\/APj5jgXNhKssZ6VNaZVoekH0HP5JTCG+IuRX93GRQEGlGbgOrM+jBjlk7K3P+VHkPWeJ\\/KfEbfK0T9Ok5HrHA4Fvvydm3DtoxVfWvEeqvVgXNnIssR4MhqPkhMc8naXA\\/wAqPNq+noHrz9GGt4z8PbNUFE4kf2m4n8wxU\\/l+222ZoieIGanrU5Hj04EG9L2Ev\\/EUExnr4kfnwJrd1eNswymoPrHyOn46UdrTKJc3Pq6PXTBh28m1t\\/7J5z1t0er11xU5nwPtNumZAeKHNT1qcsLb7sPhpyaahnGeFM+I9eXpwJYmDIwBVlNQQekH5Ge13GVUJFVXizdQ44a32cfDQHLWc5Dx6eC+rP04LyEsxzJOZ8HHwUpMXTE+aH1dHqwsF\\/8Ays5y5jVCfQ3R6\\/nwHQgqRUEcCPkV+I3CVYk6NRzPUOJw1vsadihFO1fN+jgOA6R0+imGnuXaSRjUsxJJ9Z8LCWsmuAf5UnMnTw6Rma5EenAhmb4a4PuSHIn0Nw+enyJNdX0ixRKKlmP0ec+gYNv3fSgzBmkHp91f6z8wwbm9kaWU+85qfDxFHJ21uP8AKkzAHoPEerLCwq3Y3JH+FJlU5V0ngfzH0fIcZ7p1jjXizkAD1nBt9hQSt\\/xnBC+pcifXTqOPiNwlaV+jUch1DgPEVRhYZ2+Jth7kh5gPQ3H564Eds\\/Z3BH+FJk3pp0H1Z+j5CjLKwVFBLMxoAB0k4aDZ1+Il4azUIP6z+brx2m4zM46E4KOoDLxNUZHAh3Am6t\\/7R5x1N0+v1UwBYyjtaVMT5OPV0+r5Bi7kBQKkngBgwbf\\/ADU4y5TRAfS3T6vnxqvpD2darEuSDj0efPic\\/FQeMlWGYIyIwIN2BuoMhqJpIufGvvev5xjtdvlDMKakOTrl0j+sVHp+QMwxN8TcD3IyKA+luH04KXEhjtycoUyXo4\\/pcK5+rxcJrd2SRcwymhHrGFt96Tt4uHaLk46+g\\/m68dvt0okApqXgy184OY8v2jkftbkVpEhqa+ZjwH++WGgLdhak\\/wCHHlUZ01Hifo9HjIXFpI0cq8GQkEesYFvvydoP+MgAb1rkD6sC52+VZU6dJzHWOI9fl3\\/OSVl6IkoXPq6PXgw2pNrbEU0IeY+erZH5qDFT41FzZSNFIPeQ0OFtt\\/TOtO3jHV7S\\/PmPmwt1YyLLEwqGU\\/T5j6D5b69wlCvSojXNzxpQemnE0Hpw1vtf8tbmo1D\\/ABCPSej1fOcF3JZjmSTUnxz8Rt8rRP06TkescDhbffY+zbh20YqvrXiPVXqwJ7V1kjbgyEEH1jyzNxuMqxihIWvM36o4n\\/euGt9lTsIuHaNm56ugfn68Ga4dnkbMsxqT6z497fbpWQ1zXirU844HjgQbyvw8vDtFzQ\\/1j8+BNAyvG2YZSCD1EeV5utwlWKIZVbpPmA4k9WDBsMeheHayDP1LwHr+bDXN5I0krGpZjUnyBEu3ylVrVozmjdY\\/3OFt9zHws594n92Tl08RU9B+fAdCGU5gjMHyrNzeSLFEvFnNBhrfYo9bcO2kFF9S8T66dWDc38rSyHpY1oK1oPMM+A8hR8FKTFXOJ80Pq6PVTAgvv5W4I988h6m6PX85xUeU7TTsqRqKlmNAPWcGDZV7eX\\/iMCIx1cCfzY+I3GVpH4CuQHUBkPV5EhIH7S36YpCSvGuXm49GBFK3w1wfckOR6m4fPQ+UhdyFUZknIDBg2ul1cZioP7tT19OfQPnwZdwlLLWqxjJF6h\\/ufI0RBu3thQdlISaCvuniPo9GBGj9jc5VikIBJp7p6fp9HlBU4aC3\\/mrgZFUNFBy4t6+ivmNMEXkpENcok5UHq6fXXyQqMLDOfibYe5IeYD0Nx+eowq20gS4IzhfJq58P0uHR0caeTrRBhcXIy7KM8Dn7TcBSnDj6MGOR+ytz\\/lR5D1nifXl5KVGRwIdx\\/moBlVjRwP1un1\\/PgfAyjtaZxNk49XT6q+TJS5ftLjoijoW4dPm9fqrhoYG+Gtj7kZ5iPS3H5qYqfJcPGSrDMEZHC2+7L8TCKDXwkAyHHg2VeOZPvY7Tbplc9K8GHWDn5K\\/z8o7ToiTmc+ro9dMGDb\\/5WA9Kn94etuj1Yqcz5Nia3dkkXMMpoR6xhYN6Tt4xl2i0DjrHA\\/m68dvtsyyqOIHEdYOY4dPkj2u4zKnmXizdS8cG32dTbRGoLmhkI4f3fVn6cNLMxd2JLMxqST0k+T63NnI0cqmoZTQjAg36PWvDtYxn614H1fNj4jb5VlTpKnMdY4j1+RvxG4SrEnRqOZ6hxPqwYNhXs06ZZACx6hwHrr6sGe5dpJGNSzGpPrPlGt1YyNFKpqCp+nzj0YW239AOjtox1e0vz1I+bAuLKRZYzwZTUeRJuL2RYoxxZjQYa22BM607eQdfsr82Z+bBub2RpZD7zmp8p\\/iNumaJ+mhyPWOB9eBb78vZP0SoCVOXvDiPVX1YE9q6yRtwZCCD6x5Cma4dUjXMsxAA9ZwYNhXtX6ZXBCjLoHE+unUcfEbjM0r9FTkOocB6vKvtNumZB0pxU9YOWBBvK\\/Dy8Na1KH+sfn68CaBleNswykEHqI8gTLKwVFBLMxoAB0k4NvtCi5mFQXNRGCD87erL047TcZmcdCcFHUBl5X6rCUiOtWjbNDwrUHqpUZ+nCwbl\\/LXBoCT\\/AIZPoPR6\\/nwHQhlOYIzB8e1OGgsP5qcZcpogPpbp9Xz4\\/npP3YNVjXJB6un1+WYFnKTDXOJ+ZD6uj1UwsN6fhbmmYc8hOfBujh0082eKjx0Yom+JuB7kZyHW3D5qnBSd+zt+iKMkLxrn5+HT5biOKTtbcf5UmY9R4jAikb4a4PuSnI9TcD66H0eNzHNJ2twP8qPM19PQPXhoUY29qcuzjPEZ+03E1rmOHo8u1hZ+3thQdnJnQZeyeIyGQ4ejAjhk7K4P+VJka+g8D6vGZ+NlHa9ESZufV0evBgtf5W3PuoTqOXS2X5qemuKnj5e1GFhuG+JtxlpkPMB6G4\\/PUejFLKTTNxMT8rj+o+on0+LzLuEoU0qqDN26h\\/uMGDaa2sGY1A1kbPjX3fV85wXkJZjmScyfkBDoSrDMEGhGBDuI+KgGVSaOP73T6\\/nxXb5ayAVaNsnHq\\/rFR4r7fcpliU8AeJ6gMzx6MNBsqdhGcu0ahc9Q4D8\\/XgzXDs8jZlmNSfWfkFWWFijqQQymhBHSDgW+8KbmIUAcUEgHD+968\\/TjtdulVyBVl4MvWOPic3N\\/KsUY6WNK5VoOkn0DPDW+wx6Rw7aQZ+peA9derBuL2RpZDxZjU\\/ISs9s7RyKahlJBHrGBb74hnj6JUoHGXSMg35vXj4jbpVlTppxHWDmPEbXN26xxIKszGgGDb7CnaNw7aQUX1LxPrp1YN1uErSyHKp6B5gOAHyGi4spGikHBlNDhbffo9Q4dtGM\\/WvA+qnVgXW3yrLEcqr0HzEcQevw8zTsqRrmWYgAdZODBsy\\/ES\\/8AENQg\\/rP5uvHbblM0hHAHJR1AZDh0fIiLmwlaKQdKmlRWtD5xlwOFt9+TS2Q7ZBkfSy9Hq+bAubORZYm4MhqPCy7kBQKkngBhoNt\\/mbgVAI\\/wwfSen1fPjtNwlJUE6Y1yReof1nP0\\/Ir8Rt0zRP00OR6xwPrwtvvidlJSnaoKoePEcR0cK5+bAmt3V42zDKag+seEGKA\\/E3Iy0IeUdbZj5q4Iu5NMOVIo6hB6un11+RntNumZB0pxU9YOWPu+5i7K60lqrmjU48cx+fr8Gv8Ae0QStZ2s9wEJoGMSF6VzpWlMGNydtu3Y0inbVGanILKAM+A5gOvAWVSpIDCvSCKgj0EGo+Rpf4Un0eDb3\\/pl59S3+xbWOT4mwU1+GmJZBWldJ4oSFAqMLBHKLS+NB2FwwAY0FdD5Kc60BoaefGiVSreYinyML\\/Ck+jwbe\\/8ATLz6lv6As59N9YjIRT1JXIgaHHMtK1pUrkKrgQ7RIYrtzRbWcgSdNApGT5Dooc+GCjgqwyIIoR8iy\\/wpPo8G3tR07befUt\\/RqOOFs93H3jZrkBKT2qD+zJx9TVGA2y3AaegLW0tEmB5QaLWjjU1BpJOVSBih4\\/Iov8KT6PBt6\\/067+pb+mssTFXUgqymhBHAg4Wy7wxfH2w0gSatM6AACgbgwoODA9Yx2uwXAnYAs8JGmZABUlk8wocxUZfImv8ACk+jwbev9Ou\\/qW\\/IrPbO0cqmqshII6iMdj3pjN4pr\\/MLRZqmpq3Q9SRWudBxwbzYbhLqIZsFykT9dDzD6PT8iK\\/wpPo8G3kefbrv6lvya3lhK8M6GqvGxVh6xhbPvbBr4KLu3AVx7Iq6DlagBPLpYk1NcC+2mZLiClS0ZzXIEhl4qRUA1HH5D1\\/hSfR4NvH+n3f1LflVv9pnkt514PG1D1Hzj0HLC23eyHs3of5q3TiaZa46gcaVK9ek4F7t00dzatXTLC2pTmRn0qTQ5MAfR8hq\\/wAKT6PBt4\\/0+7+pb8v8VtFw8EnA6TkRQihHA5E8cLb95YRZTmg7eAFomPnZMytfOpI\\/sjC3lq6zWzkhJozqRqUOR9Yy4+f5C1\\/hSfR4NuyngbC6+qbwEz7PcNEGprj4xuAQaOhyIqBhbXfQLC5NB2ubQMchnxZKmpPFRhZ1IeJxVJEIZGHoYVB+Qlf4Un0eDbt9guvqm8DI2qciFvbhfmibrU\\/SKH04EV+Btt2a1DMWgJ5jysc1yoAGrn72Bq4GtCDUGhpkRkfV8g6AmhMcgHpy8G3b7BdfVN4KILOXtbOtWtpueM9Q4qfSpGFt3cbffsQBDO1I2JKgBJTlxJyfTQDicAOKVAI9IOYPyC23VL9W3g25\\/Yrn6tvB1tyReWIqDb3BJUVoORgQymgFKGnoOBHay\\/C3hGdtcEAk\\/wBh+DdRofRhoZlKOpIZWFCCOg\\/IHbdUv1beDbn9iufq28JWyvGF9ZLksc5JZBzZI\\/tKKtWmYPmwBtU4S6JNbSc6ZQBw0n2Xy\\/RNfRgo4KsMiCKEfIDbdUv1beDbkq8TZXAH\\/wDm3hQZTQjMEYS031TuNktF52ImRagnQ+fQCKMGGeA2zThpqAtbvyyg5e772ZoCta4ofL+26pfq28G3D7JP9WfDFmhYpIpBVlNCCOkEYFp3kT4+ACgm4Tr\\/AHuD9TfPg3OwXK3Cj2ozyTIKtTVGc+C1JXUo\\/S8vrbql+rbwbcPsk\\/1Z8OW4tXaOVfZdCVI6iMLad64fiVqf5qLlmFf0h7Lj\\/wAp9Jwb3YrhbqFRqfQCGQVA51Oa5kejPj5eW3VL9W3g24fZJ\\/qz4gTcNrmkt7mMhkkjYqwINeIwlr3rir7K\\/FQKAwA0iroKBsgSSKEnHx+0zx3dr\\/xITUD9YGjKfQwHl1bdUv1beDbh9kn+rPiIX20XElvOvvRtT1HoI9Bwtt3og7Gb\\/wDatxVT7R54+gnlFVNP7OBeWEqXFs3CWJtSnMj1cDkaHy4tuqX6tvBtw+yT\\/VnxJ8Vs1w8DnJgpqrDzMpyYdYwtr3kRbC4NB28SkwklgKuubIAKnlDDLgMJcwOksEgDJJGwdCCAciKitCKjiOny2tuqX6tvBtw+yT\\/VnxN220zsikgvE3NG+YNGU5GtB6cJa70Pu+8oB2hq0Dnz19pK8c6j0jCS8Y5BqR1NVYVIqpGRFQeHlpa9Uv1beDbh9kn+rPigptc5+HbN7eQa4mNCK6TkCNRoRQg9OOwvmXbbw8FlYmFzU5K9OXKnt0\\/WwBIKVFQeII84IyI9I8srXql+rbwbcPsk\\/wBWfFSw28nb2IYFrWerRmh6KEFetSMJbq\\/wV62lexnYaWY6RySZDNiaA0IHnxRxSoBHpB4Hywtf+r9W3g09vMNUckTow4VBUg8PFi2kjC8sF\\/8Aj3BJCj+w3tJ6jT0Y0WUwtrun\\/trhgrGgJOh8lbhwqGzAocFJAVYZEHI+V1r\\/ANX6tvBpP1G+jxclruP8\\/ZLlolY61GfsyZkZmudRwwqbJMfimIHwkw0zVJpRaZP\\/AHc\\/RihyPlZa\\/wDV+rbwaT9Rvo8Xh0JDA1BGRBGEs9\\/H3haLQBmNJ1UaRk\\/vUVaANUdWFl2O4WWXTV7c8syHpBU+11rqHVih8qrT\\/q\\/VN4NJ+o30eMVngZkkU1VlJBB84IwLXvPEb6KlBOp0zrQEDP2XFSK1FaD2hg3Gx3C3Cj2k9mRePtIcxkCcqinT5U2n\\/V+qbwaT9Rvo8Zrd2Mrwzoaq8bFWHURnhbbvbD268PioQFlHpZfZf08D6cC\\/2e4juoKCpjPMhoCQ6GjLTUBmKV4E+U9oT\\/zPq28Gk\\/Ub6PGq322TPBOhBDoaHI19YqOBwtp3siIOQF3bgVyAHPH0+clSDU8Dj7w2uZLm1yHaxGoBNaBulTkcj5vKW065Pq28Gk\\/Ub6PG\\/wAbs9xJbzUKlkNKggggjgQQTkcLb96o1tZWOd1Cp7POpq0agkdA5P8Ay4W9s5EntX9maJg6H1jgfQaH0eUdp1yfVt4NJ+o30eOfidmuHhY+0oNUceZlORHXhbXvBH8BdZKJo6tAx5RVgasnvMTVh0UGFuYWWSFwCkiEMpBAORGXAjyhtOuT6tvBnRcyVIHrHjsnaLhlhYgyQPzRPT9JDkevj6cLb7sBtt3Q1ZiWgYgVyNCVJI97LPiMZ0KmtGUhlahpVWFQR6QfJ+065Pq28k9G3zarY+1BLzxnI9B4HMmopnhYLhvu69P+XM1YmP8AZk6Oph\\/ewBKpUkBhXpBFQR6CDUeTtp1yfVt5KraRSfEWAOdtPzIKla6DxQkKBVSMsLCky2d+dI+HuGoHJArokyU59BIbrxolUq3mIp5N2nXJ9W3kutpOwvbFQQIJyTpqKVRhmtONM1y4YC7bMYLk1JtrghXHtGit7L0UVJyOfs4KSAqwyIORHkzadcn1beTFRxwtpvH\\/APRs1AUCZj2qAcNMnHLzNUY1bLOO34m1lIWYeyMhwfNqchJyJIGKHj5L2nXJ9W3k0JYmKupBVgaEEcCDhLTvChv7QAKGrpmUUAFH96gGQbz8cdrsFwJ2ALPCRpmQAVJKeYZ5gkYofJW065Pq28HPkKs9u7RyKaqyEgg+gjAg70x\\/GJn\\/ADCUWfPUaseD5kVJzoOODebFOtzGK6lXKRBU+2h5hwrXh6fJS065Pq28HPkOt5YSvDOhqrxsVYesYW074RGQEit5AAJBUqKumSvQAnLSanMnAvtpmS5gpUlDmuQJDLxUioBqOPkladcn1beDnyJW\\/wBnuJLa4XIPGxU06QacQekHI4Ft3qg0SUoLq3FAf14+HrWnVgXu2zx3Vq1dMsLal4kZ9Kk0OTAH0eSFp1yfVt4Oes+RfxW0XDwScDoORFCKEcDkTxwLbvPH8JcEn+YhFYjUn2k4r0Cq1HoxHewyxy2sx0xTRsGRz5gfPmMuPo8jrTrk+rbwc9Z8i3uryRIoYxqd5GCqo85JyAxJt\\/cq2+OuUJVrifVHbqynMdDPmrI1KFGoaMuLH8Qu8kkW7b1tsiSWvxlvHLaxFD7ls4aMaqAvkSxANchSLafxFhG1Xx0p8ZFVrZzyLV1zaOp1MxzUDIDEe42EsdxaTANHNC4eNwRXJlJB4+Rlp1yfVt4OR6T5EtPOypEilndiAqqBUkk5AAYk27ujCd1v1LIZAdFtEwBFXc5tQ6TRBzI2pGNMGXvNddrHU6baIaIEB1imn3uVyhLe0AtRUf0DP3Tv5IYGP7y2fngk\\/WjOXrFD6cLY98Y\\/uDdDXmqZLNzztyuavHQBVAbVUn28LcQOkkL10SRsHRgDQlWWoIqKZHyKtOuT6tvB26z5ENt2zsd13BdOqO1IMaV0nnl9gcrFgATXSVyOAe8E4W35WFpbkrCpGk9bEMpoTQ6XKNUYWKJQqKAFUCgAHAAf01t+7980u16iz7fc1ltjXiQhPIx\\/STSevEW2by42He5CF7G6b+VkZmVVEc5yWpY5S6aBa6zWmFf3XVXU9DKwqrA9IIIIPSPIi065Pq28HbrPkM9lG\\/x+5qDS1tyCQRrA1vmqDUhQk8GoGArhodyuGt9uOoC0tmKIw1GhdhzMaBG48jg6WoaY0RKFWpNFFBUmpPrOf5NLSwufjdoVgWsLsl46VWug8YyQgWq8BWgwlis52fd3oBZ3zqFY+aOegRun2ghp0YaGZSjqSCrChBHHyGs2XiXK5\\/2lI\\/r8HYf2j9PkI0FzJ8TuFDotYCGeo0jm\\/RALrqrmFbVpIw1tPOds2x6g2lq1HdGBGmWXicmKuFOlqKy6TjsrdQq1qacSTxJPEk9JOZ6fy8e1zzDd9mQUW0vSWMY5yBFL7aDU5YqDpJAqMC12q5+B3UivwF6ypIc2yjbJZKAAmlDzAUOCjgqwyIIoR5CWX8UfQfB3\\/WP0+QWneJy92c0tYB2k7dJoo4cvNmRUA6akUw0Fgy7Nt4IosDCS4ehU80hFFFVNAo5kbS1DjTGONKkksx0gKKsak0AAzPAeBB0JDA1BGRBGIts7zV37ZV0p2dxIRcRJqBPZTZ50BADh1z4YRe7V6E3AqpewuaR3CsQgIUVIcam0qVJLUrpGKHyCsv4o+g+Dv+sfp8gDcb\\/dLHJpqkCc8z1rpCoM+YgqpNF1cta4e07uRttNiwZe1ahunU61qKZR1BRh7ysCpqMNO5LSuSWdjVjVi3E9FWJA4CuQHgyXNq7RTRsGR0JVlYcCCMwRhNu7+od+24UHbO2m8QZcJT7eQ\\/zK\\/rYF13Ov47icLqls35LmL2idUbULABCxZNSgUqRw8gbL+KPoPg7j+030+Phed4byG0iYgL2jULEsF5V4nNhWgyrU0GDa904WsrRgK3E4\\/fMDoJAT3Kgupz1KwVlNMNe3LvPdyEmSeZtcjFqaiSf0iASBQE508KS92+WSC4jNUkiYqy9GRFCMDbPxOgfd7Qii3kRVLqMliSzVGmUZ0odJAAo3QW3TuVfx30UahpY15ZogTQdpEeZcyM81zGefj+y\\/ij6D4PJ+s30+PH3Pe7iO2tkDEvIaeypY0HEkAE0AJoDh7DuPELeMEqb24UM1VJHJEciKrxY0ZHBUhsNu25Sy3d85znuHMjjLSAC3DlouVKgDVU5+HRb13eu5rK\\/gYPFPA5R1KkEEEUPEYh2n8Urb4qEaI\\/vC1QLMoGhayRiivRQzEjSzMc8JvndO8hvrRlBYxMC8ZIB0yJ7SMK0NRx4E+PbL+KPoPg8n6zfT46a93KZIYFyLOaCp4AecnoAzPRh7LuBAGBBA3C6U6Mx7UcfFsiHRjymhRlHHB3TvDdS314Tq1ynlTNiBGnsoAWbTTMA0rTxEm89172exvYyCJYHKnLoPQR6DUYj2n8VLMpIooNysVrqIDmssJPEnQupCKAE6CcDd+7V5Bf2LcJrdwy8SuY4rUqaBgDl47sv4o+g+Dy\\/xG+nxw15fyxwQJTVJKwRVqaCpNAM8sfBdx7U7g9ea6nJit1oRUDLWxydSKDSwFaqcC97zXb3kwpQEaYl9iuiMZCrIrdNGqRSviY7r3O3CewnYaZBE3JIv6MiGquPQwOIdp\\/E63Xbbp2VPvC2Vjb5mmqSIamTjmUqAB7OIt42e4iu7CcAxzwOskbVUNTUpIqAwqpzWuYB8c2X8UfQfB5f4jfT42e5uXWOKNS7u5CqqgVJJOQAHE4m2\\/ugv3pfRlozIKrbRuA45n96jKuoJ7rBlJwZ+8lwbhAWKQUpCgJYUCcDysFauTaVYjUPFQ3HujfSW1SDJCTqhlAZW0vGeVgdIr00yriDae\\/8AGdm3PSqNdgl7SVshqNBqirxPtL5iOAiv7R0mtZ0EkU0TB0dSSKqwqCKgjrBHEeN7L+KPoPg8oP8AxG+nxq1hsp+8r8UBEJBiSug1Z+B5XDgA8wDAEEY196LkvBUFbOGq26dPs8XIqw1NmyNpYEYWKJQqKAFUCgAHAAeLS3dO\\/eO1c1ks5f3ttIdLLVo2yqNRowowOYOI9s71quxbo5oGkbVaMTqOUhzTIKOetWPGmFlUho3GpHUhlYedWFQR6R41sv4o+g+Dz\\/xX\\/aPjNrOzB3Lcl\\/8Aj27Cgzb25Dyr7DDp5hpbSSMU3q8aCyBqLOyLRREgggs3ttmqsATytqAJU0wIYFVI1FAqgADqA8YxxbLdfE7WHVpNuuiz27gHMAAgpUVFUKnPEO27k52Ten0p2F0wMEjnQv7ubIczM1FcLpUe0cK6mquoZSMwVYVBB6QRmD4zsv4o+g+Dz\\/xX\\/aPjFrF5DebnmBa2\\/MwPD94wyQBqBuLLqDFaYkt7yQbdtkmpfhLVjrZGDCksvEkq1GC0XUoZTghABUlj6SxqSfOScyek+NVsbaZdx2fUC1jeVZBkB+7f24zRQOU0p0YW0S5Xad4IH8lfOF1kKzMYpTRGA05AkPmAAThoplKOpIZWFCCOgjxjZfxR9B8HuFPESuP\\/AFHxf2e73BkuyQFtbZe1nJND7I4cp1cxFVBIrTHYWo+6bA0rFGweZvYJDycKVDqQuTI2dCMaYx0KCSSSdKhRUnMmgAqc8vHMO37m53nZEIBtbpz2irzEiKYhmTNtWYYEgVFMsLDsd58LuZFW2+9Kxzf3G9iQfqmufs4ocj4vsv4o+g+D3P8AGk\\/aPi0z77cqkhBMcCc00h0swCoMyW0MFrQEila4ey2Bn2qxJIEiEG4cAsK6qUStEYUzHMjA8cFolozcWNSxzJoSc6Ak0HR0ePFliYq6kFWBoQRwIOIdq71k77s8elAJ2\\/mY0GhaJNxOlFoqvqUV6MBu694vx4VTJYzkJcKdKk6UJ51BOnUta0JoBih8W2X8UfQfB7n+NJ+0fFYu99uo7dWoEVjzMSwUaV4nmZRXgKipGDad1U+7dvYCs8grcurAVAH+XUMR+mjrUEg4kvZmea7mJaWeZi8jljUksfOc6Ci1JoB5AJd2cjxTxkMkkbFWUjgQRmDhNp7\\/AMP35t65LPq0XkYCkAB81da6ahxWi5MKnBue5e4JcsK6reQdncoKtTVESTwQtylgB0+LLFl4mdBn6TT+vwe7QdE8o\\/8AUfFLbjv1zHbW6gnU5zIUVNFFSaDM0BoMzlhrPuRbiyhqB8XdoHkNDnoirQZgrzEgqwdTUUwb\\/cp5bu8b2p7h9bnlVePAVCqDQCtATU+QiX22zSW9wldMkTFWFcjQjPMYj2v8Trf7ztsh8dAAl0vpcexJxzNA2XHA3fubfw38AUNIsZpLFkpIkiajpQuFqRpLZKx8VWP2iL9oeD3n2iX9s+J23HebiO2t1rzSNSpAJoo4s1AaKKk9Aw9h3CtqxlSBuNyKJmGAaKPi\\/FHUtRSKqQGw2571cSXV0zV1ymoXNyAg4KF1sopnpOmpHkRFvPd66ms72FgySwuVYFSCOHEVAyOWI9m\\/Fa2edaoq7naAB1UAL+9hoA\\/DUWUhqk5N0Dfu6l7DuFgSAZIGroYioV1NGRsjkwHA0rTxRY\\/aIv2h4PefaJf2z4la83CaOC3SmqSVgiipoKsaAVJpj4buPD8aTT+bkqkAB0HkrzOdLMOFFdKMKYG4d5Lhry5FKFxRFPKeROCjUuoDPSS2mlfIxd57p389heKCvaQOVJUgghhwYEEgggjPCbf+KVmIZs\\/\\/AOhYpRWPO37yAZCtVUdnRQMyuE3jYLuC\\/sJAClxbSLIhr0Er7J\\/stRh0jxNY\\/aIv2h4PfKvAXUwH\\/nPiN7m5dY4Y1Lu7kKqqBUkk5AAcTiTb+6UY3C9Qshlaot0dS6kFhQtRk0sFzGpWGoY+K713T3xBJSJwFhTo5YxyioC6ugsoagbyQG690L+aym99UbkkHmdDysOjMYj2v8SrYbVfNpT462Ba1c8i1kjzaL33YqXXgAqjEe67RPFdWcwDRzQuHQ6lDDMdNCCQcxXMeJLH7RF+0PB7\\/wC1T\\/tnxCWY0AzJOGsO7Sfed\\/UqWQ0gjNAas\\/vUDK2lfbWulqjHb957x5IOKWURKWyVBBGkUL5My1f2koGBIrgKooBkAPJMbh3RvngB\\/wASBwJIJASCQ8bVU10ipyOQzxHtnfuNdi3Eg\\/zFWe0cha8aFoyxHvVWpHMBhLm3dJYJATHLE6vG4BKko6kqwqCKgkZeIrH7RF+0PB7\\/AO1T\\/tnxA1hterddxUZw2zDQvSNcuaio1UpUal0sVOKb9crDbVDC0syyRAgoRqY870ZNQJpTUy5rhYolCooAVVFAAOAA8l692L5ltGNXtJv3kDZMM0OQI1EgimeeI9v7wf8A1\\/dWoNE767V2\\/sTUBWp4K46aazxwHRldGFVZCGUjzgioI9I8QWP2iL9oeD3\\/ANqn\\/bPhz7cJfjt2CsRZ2vOwI1Adow5YxrXQS2akiopiS2upfg9tfUotbckFkOsDtH4klWWoGSuupTg6QBUsxp0ljUnrJNT6fJuO02q6+L2cMGfbryskBFVLaM9UZYIF1IVNMRbXeSrs29OtOwu5FWGRgFqI5jRasxbSrUNBxJIGKOCKgEdR4Hw6x+0RftDwe\\/8AtU\\/7Z8M7Dc7gPetktrDzynNAaqOAAdWNfd5gDg2qMds21xzW8LAyOpVarJJ5vbVgvKylTkRjRCtAaVPEkgAVJOZNAMzn5Ppt4mG67MoK\\/BXxZlQEUrG4OpCMiKHTlQqRUYW2sbk7ZujVJsb9lVstZpHLkklFUEnkNTTTgpICrDIg5EeGWP2mL9oeD3\\/2qf8AbPhRl3qcdsRVLePnmflZqKnpCtStK0IGeWJLPaX+6dvqVBgatw4BybtKcuYDLpGasUdcEW60LU1MSWZqcNTGpNOip4ZeUVRkRiPat3I3rZlJpBdMe1jBJJ7Ob2hmSaNqUnowsXdy8EO6NkdtuiEuBmoGjgstS1B2ZLZGqgYoePhVj9ph\\/bHg9\\/8Aap\\/2z4QbvfLhYzTkiHNI5JoAqjPNqKCaLqIBIrhrPuuv3TYPUGdxqunQggFQcoiQwPAujrxYHD3c7NLcylmklkJZ2LMWNSejUxNBkCTQDymWeBmSRCGVlJBBGYII4EYh2rvaDve0JpT961LmNBoXkl96iKQqvUVJOBN3S3BHuQoMlnPSK5Tz8hPMK9KFhlXFD4RY\\/aYf2x4Pf\\/ap\\/wBs+DfH94ruK0hoSC55iAQCVUVZqVFaA0GZoMGDubatZW9R\\/M3ifvWAKHliry150Oo19l1wb2\\/mkubpvammbW7HSqk16KhFrSgJFTn5VJd2UrwzxmqSRsVZT5wRQjC7b+IsP33aCv8ANAhLxfbOb+zJVmFS41aVoGx959zL+O7UFtcBIW5joTnJCTqUECoOa06a18HsftMP7Y8H3O0kILxXtyjEcKrIwNPBH3TfbmK1tYwSZJWCjJSxA6SaAmgqTTIYkse40NF5l+OuF5a866o4\\/eFQjAtysjdBGH3XdJZLq7die0mYuV40C14ABtIpnpoCT5XR7ps1xLa3cRqksLlHU+gihxHtf4rQNf2x0p94WwVbhKsKtImSy0GrpRiaZ4G7d0L6G9g0guqGkkeSkiSM8ykagDUUrkCfBbH7TD+2PB97\\/wBSvPrm8CN1fSpDCtAXkYKoJNAKnzk0HnOGtO4sYnZhleygiIAhTVFObHSxKkimpCrDpwN17yXD314DVXl9lDWtI04KA1So93UQpoaeWUe893LuayvYmVklhcqaqQwr0EVANDliPavxVtNXBfvKyQBujOWHIN1ppJJ4YG9d1r6DcdvJoJ7Z9QFSwAcZMhOk0VwrUFaeB2P2mH9seD73\\/qV59c3gD3V3IkUMYLO7sFVQOJJOQGH2\\/uXbi\\/uVJU3ExKW6MpIIy5mNVZSBQqdLUZTg33ei9lvnB5I3osKDl9mJaLU6FJJB5hqFPLYbt3Uvp7G6FQXhcjUCCKMODChIzHThds\\/FO3+EmOQ3CzjrESSx\\/eRDNRmoBStKEkZ4Tdthu4L6xlFUnt5A6EerMH0Gh9HgNj9qh\\/bHg+9\\/6lefXN+WaaZgkaAszMaAAZkkngBiXb+6Uf3puCak1glbZHGXM\\/vUJVqL7SGqMaUwZe8lyZIasUtY+WBAdYpp986XKEt7QAJFR5dDde5u4S2chKmSMHVDKFYNpljaqOtVFQwOIdp\\/EW3G1Xp0J8ZBVrZzyLqdTVo6nU7EalHAAYh3XbZUuLK4UPFNEwZGBFRQj0HMcR0\\/l7H7VD+2PB97\\/wBSvPrm\\/Ktt20Md23BdOqO1IMaV0nnl9gcrFgATXSVyOB9\\/zhLblItLeqwqRoOZ9pqMpIJ91ipqMLFEoVFACqBQADgAPL34nujfvDExrJbP+8t5P1425T15H04j23vuv3FulKGZiXs5CA5JDAaoiaKoVgwLH2wMLcW7pLC9SkkbB0YA0JVlqCKimR\\/K2P2qH9seD73\\/AKlefXN+TezR\\/jtzUGlrbkEgjWAHf2UGqMoSfZalQK4aDcbhrfbSWAtLZiisNRoXYczGgRqV5XBKmhpjREoVak0UUFSak+s5\\/ICrd3LwtZVBksrislu9AwzSuXtMQVIzNeOIdq3ymxbxKyoEuJAbV2Y05Zmpo4jKSn62Ff3XVXU9DKwBUg9IIIIPSPydkR\\/+zD+2PB97\\/wBSvPrm\\/I\\/D3kwmvzkttDzPWqirUrpA1qW6Qp1aSMPazynbdskBBtbZiHZSOEkozNQzI4XlOTLpOOyt1CrWppxJPEk8ST0k5np+QWOz226N5s6tqbb7sl4aErq0dMZIQLVSMsR7fdzrs+9tpX4W7cLHI1BXspTRc2JorENQdOKOCKgEdR4H8jZfaYf2x4Pvf+pXn1zf09W8TF7g0020C9pM1RXJRw5QWFSKhTpqRTBg24jZ7DLlhOu4YhlOcvACq+6vMjlWAIrjTGONKkksx0gKKsak0AAzPAfISu2mVd12cf8Aw72raeVgOzlHOlC1aAlTQVUgYFvYXP3buRqfgb5lVqDWeSTJHoq1PsnMDTXBRwVYZEEUI\\/p2X2mH9seD73\\/qV59c39E3G\\/3SxyaapAnPNJWukKgz5iCqk0XVy1qcPad3I22qxcMvatQ3TKda1HRHUFHHFlYFTUYe4kJeaQku7EljVi5zPRqZiBwFTSnyGBlNCMwRiPa99f782dKKIrtiZo1\\/5c3tCla6W1LhF7t3wj3IqC+33dIrgHkB0CpWQan0roJY0JKrih4\\/0bL7TD+2PB9+VRQDdb4AD+O\\/+0XneK8htImIC9o1CxLBeVeJzYVoMq1NBg23dKBrK1YCtxcD98wOgkKnuZF0NTqUhWXDXty7z3chJknmbXIxNNRJP6RAJAoK50+RBbi3do5UYMjqSGUjMEEZgjEW1d8lbfNoQBBrYLdRqAqjRKQdQVVoFbLMmtc8CTudfCa6ClpLKUaLmMKtWJTpAoeZSRQE5Yof9tl9ph\\/bHg+\\/\\/wCq33174fc97uI7a2jDEvIaeypY0HEmgJoKmgOJLDuPGIFBK\\/G3CBjkWBKRnI5qM2yZHqCCMHdNzlku745dvcMXkpwABPCgouWZAAJNPkUS8sZXhnjNUkjYqynzgihGE2\\/8RYjvVoKj4oEJdiutqs\\/CSrMKl+bStAcHce5l9HdqtdcJolxGAT7cROoVArXMU6f9ll9ph\\/bHg\\/eLadm2S+26Q7vuSJd7tbtAsqJdyRGa2Q17WMsG7OXONmjdCMq4+8u8N1JfXla65TyrmzAIg5VALtppmFOmtPkYj3TZriW1u4jVJYXKOp9BFDiLZ\\/xTtmv4CwX7ytQBcqCVBMkZoktAGOWhiTmx4Y2vvNbR6NvuUtr6NpeR+zcLIoZDzK1DmCMjkfBztffzbIbshaRXAAS4i407OUcwpqJpXTXMjEu9fhPcffm3CrfBS6Y7xB5l4JLT0aWP6Jw9juUMkFwntRyqVYVzzBz+ReO+22yO27I+Z3G+BjjI88a+1J\\/dFPThNwuLf793ta1vL9FZVJ1D93Dmi1VqGus5Agg+FGLvrtiPee5fW9IrpPZ4SAZ5IF5wwC5CmJN57gOe8mzrmUiTReRgAV1RZhxUnNCTQZqMPaXkbxTxkq8cilWUjiCDmD8ianurYNFteoCXcbqsVsgqASGObkA10oGNAcQbz3rH\\/cG\\/R6H1zrS2icaG\\/dxe9pZTRnOatQrgIgAUCgAyAA8NZu8lktvu4Vuz3K1VUnB0kLrIH7xQSG0t5qVArifeO7kZ7wbBHrftrRSZ44xrNZYeOSKCzLVQTTDRSqVdSVZWFCCOIIPT8h\\/wncTa5bmFTSW6f93bR5MRrlaignSQBxJypiHfPxImXvBu0baxb6aWSkFhmjZyChU81KMvAg4Szso0hgjUKkcahVVRwAAoAOrxDJfbrZjbt8YGm42KrHKWJJrKtNMmZJOoaj+lh9xtofvzYRUi9skYsg1KoE0eZQksAKFgeg5GlDx+Qtdk7ibbPfTEgO6LSKIFlXVJIeVVBYVJOQzxFvv4ySjddw5XXb4HK2sdVBIkYUaRg1RQEJlXmrlHtOx20NnZQjTHDBGsaKPQqgDxLJuFtb\\/cW9twvNvRVRjyj95DkjUVaCmg5kkk4kvtysjuWyJw3GxDSRgeeRaao\\/7wp6fkITY+5u3XG43z1pHbxlyKAsSSMhkCc\\/NiLffxsujNOGJG1WbgRjS2XazDNgaV0pTI5tWoxH3f7p2MG37dD7ENugRa0AqacTQCpNSacfFBRwCpFCDmCDife+7Cr3f391J120YFtI4DU7SIUALMV1OudF9kkk4eTvNt7T7QHKx7laAyW7CradRGaEhS2lwCB8gkWx92rOa+v52VI4YELsSzBRw4VJAqcs8Rb1+NN58JCaN92WThpSPNJMKqvUmr9YYGx9x9stttsxxSBKFsyQXc1ZyCxoWJIr4se0u0WWCVWSSN1DKysKFWByIIyIOJt47iN\\/25vT1bTEuu0kY580XFKnpQ0\\/snD2ffPb3W1DFYr6AF7aUDTmslB+mozANTTj8gEW07JbTXd7OwSKCBGkkcnoCqCTiDe\\/xcnOzbaSrmxhIa7kWoNGOaxVFRnqYfo4Xau4m2Q2Y0hZJ6ap5clBLynmOrSCRULXMKPGD7du1vFdWkoAkhnRZI2ANRqVgQaEA5jEu8\\/hVP9w7nSotHrJZyEBRQcXjyDGo1AsfZAx939\\/NrmtFJpHcAa7eX9SVeU9Va+jy8S1s43lnkYKkcalmYngABmTiPee\\/7nu5s7ZiORNd5ICDTTFkEFQKlyDQ5KcCHuVtiJde\\/ez0luX9qlZCMsnK8oWq5GvjSfYe8NrFebfcoY5oZl1KysKHqPmIzHEGuJ9+\\/By6G33Z1yfdt0SYGPO2mKTilSVRQ1VAFS2G2Pv3tk+33AJCNItY5QGK6o5BVXUlTQg+XAjjBZmIAAFSSegYg3nfo\\/uDu+5Vu3u1PbyJVSeyh9rNSSrPpWopXCv3cslud3Kr2m5XSq9wTpAbQafu1JBOlfPQk5eOJO7\\/e2xg3DbpfbguEDrWhFRXgQCaEUI6DiXffwTujFMWBO1XjgxnU2fZTE1UCtdL6shk1aDDbH3y264269SlY7iMqTVQwoTkciDl5\\/LWPcbe0+6djfP4+\\/Vo1Yc3+GlNb8y6SQKCoriO9t7Vd235SSdxvUDOM6js4zVI6Cma8xOdegeOzsffjbLbcrM8EnSpXMHkcUZCSoqVIrTPEu9fgreG5hA1fdl84EooBURzUCt0mj6fNU4k2HvbYXG3bhEaPDcxlG6xXiPMRUHyxjm7u2DW20FwJNxugY4FFV1aSc3IVw2lakitMW+7b9Au\\/d4lVWe4uwGgjemfYxEaaA8GcFunLh5AHYu\\/e3xXsIDdlIRSWJmUrqjcZgitRxFaEg0GJ99\\/B+5+9rAa5Pu+chLpF52ojezJRQqjg7MclxNsveG0msr+3YpLBcRtG6spoQVYA8R5WpZ9zNvdrXUFlvpwUtogdWbSUP6LAUBJIpxxBvffhh3i3uMq4EyabONwQRpiNddCOL1B\\/RwlpaIsUESqkcaKFVVUUCqBkABkAPIM2Hfva4bpwtI7lRouI\\/Skq8wp5jVfRh94\\/CuSTf9qzY2zKq3kVWUBQAaS8a1ULQKSQOl7LcIpILiM0eOVSjL05g0I8qV2XuJtsl3Ial5TRIY1BAJeRqKANQr05jLPEW8\\/ixON93ECvwUepLNCQRmcnkpXp0io4EYTbtpt4rW0iBEcMCLHGoJqdKqABUknIeQ5TvrtiNe0ol\\/b0iuk9nhIBzZKBRwwA4AYl3fuIT3j2ZKtphXTeIo\\/Si9\\/+4T+rh7W7jaKaNiro6lWUjiCDmCPKVdi7jbbcbjdkjV2SckYPvSOeVB6WIxBv34z3fxt0pV\\/uu0akCkFTSWX2n4MrKoUUOTYi2LuvZQWFhCqqkNugReVQoJpxNAAWNSaZnyLkn3yxWz3hlbRuNmBHKGOsguByyDW5ZqjUxAq2Jt52GP7\\/AO76Fm+ItFPbxpViO1h9rJQCzJqWppXBjkBV1JBBFCCOII8oY9i7o2FxuN\\/L7MNvGXbrNOA9JoMRb3+NV72KsNQ2uxar5hhSWbgCOVqIG6QSMJ3d7mWEG3bdGWYRQLQVYkkkmpJz4knzcPI+S93Cz+7N7YGm42AWOQt55Epok9NRq\\/tDEm4yWn3vsi0Px1grOFHIP3iU1JzPpBI5iCRl5PQ7L3ftJr2\\/uGCRQW8bSSOzGgAVQTxOIN9\\/GC4+6rE6JPu6Ah7l15G0yMOWOqllOZdWHDEewdx9uhsoEVVd0QdrMQKapXpV2PEk+oAZeScm5bdbjYd9bP4uxQLG5oAO0hyQ5LxXS2ZJJOJL7dbI7jsaZjcbEGSIDzyLTVH\\/AHhTzMfJpLOxieaeQ0SONSzMfMAKk4h3j8T2bYNnLAtbmhvZF5gQEIIjNVHt+62oA8MCw7ibXDauVpJcsO0uJfS8rcxr5hRfMPJZ7S7RZYJVZJI3UMrKwoVYHIgjIg4n3rumP+3t+k1vrgXVbSudbc8Xu6mYVZDkq0C4Y96tvaXa9REW42tZbdwCQCWGaEgV0uFNCPJZYIFZ5HIVVUEkk5AADiTiDeO9qv3e7vyKJBLOlbiVSFZeziJBAZWyZssj05FT3P25TuOnS+4XNJbl6gg85HKDUiiBRTLyaezvY0mgkUq8cihlZTxBBqCOvEu8\\/h0V7vb27BjGoJspKnmJjAJQ0qRooK5aekfDd+drlggY0ju4\\/wB5byZKTpkWq5agCPPl5JUGE3K6iOx7AaMby9Rg0i6ipEMeRcgqQalQMqnMVju9pshuG+LQtuV6BJLqGk1jU8sdCoI0jUM+Y+T0m2bvbxXVnKAJIZ41kjcA1AZWBBzFcxiXefwnnGxbgRX4KXU9m5AA5Tm8dadGoVPADDbN3722S0kFCkoo8MikkApItVIOk06cjll5Hx321WR27Y3zO43wMcRHnjWmqT+6Kf2sRble2w33flHNd36hkUkMD2UOaKKNTm1HIEEeUUux957KC\\/sJlZXhnQOvMpUkV4GhIDChFcjifffwauxYXR1yfdl2S0DHnbTFLmye6qqwKgZlsNsnfnbbjb7kEhTKh0SAGlUccrA04g+RanultzrtuoCTcLkGO2QVzo59sge6tTiDee93\\/wBh36PQ+qddNrE40NyRZ6tLKaM5NVNCuEtLRFigiVUjjRQqqqigVQMgAMgB5SybD3usLfcbCQUaG4jDr1iuYPpFCPPibfPwUulUM2obVeOQBUqNMUzE5e23OchRQSc8PsXfHb7jbb5KViuIyhoQGBFciKEHLz+Q\\/wB39w9sluUX\\/EuX\\/d28eRPPK1FHDhmScqYj3f8AE6cb\\/uYqfh0DR2aHmHDJ3yKkE6aMvAjCWdjEkNvEoVI41CoqjgAooAB5h5UtsPfjbbfcbNgQomQFkJINY39pDUDNSK0zyxLvX4L3nxcIq33ZeuFlA80c2St1Pp\\/WOJdk7y2c1jfQsyPDOhRgVYqePGhBFRll5BrsfcTbJ7+4JAdkWkUQLBdUkh5UUFhUk4h3\\/wDGSdN0uwoYbZAWW3RiFIEjghnKnUCByHI1IyMW0bFaw2djCNMcFvGscaj0KoAHla21d+9shvBpKxz00zxHSwBSQcw06yQM1rmQcTb7+ENyd428Fn+75qJdotWNEb2ZQBpHusSfZxLtG+W01newsVkhnRkdSOgqwB8fpsXc3b7jcr560it4y5oAWJNMgKAnPzYTfPxvuO0Ioy7XZS8tQzAiaUcQQFICEcSCRTOPYu6Vhb7dYRABYbeMIuQpU0zJ9JqfT5Ymw7+bXFdSBaR3Sjs7mL9SVaMOo1Xzg4k3b8OHPeLa1oexRQl4nsD\\/AA+D1YtTQSQq1OHs76J4Z4zR45FKsp8xBoR47i2Pu3aTX1\\/OypHDAhdmLMFGQ9JAqcsW\\/eH8ZrtrK3kVZBtdof35BFaTSEUjPnVQxHAkHC7D3H22326zUAMIUAZyCTWR\\/ac1JzYmlcsvLUr3x25BuAFI9wtgIrpcgBVwOYAKBR9QpkKYl3zuex7w7EmpmaFCt1CiqWJkjFQVAB5lJ6gSBh7a5Ro5Y2KujgqykZEEHMEeN0sdthkuLh66Y4lLMaCpoBnkMQ71+LE\\/3Jtxo3wUVHu3HGjcVjr6dTD9EYG19w9rhs+ULJPTXPLkoJklarGukEioWuYUeXMlzvdiLLemDaNxsgI5tR1kFxTTINT6m1DU1BzDE+67LCd\\/7vxlmFzZoTMiAmhlhFWFBSpXUtenBRwQwNCDxB8Zpa2kbSzSMFREUszE8AAMyTiLd+\\/zHu3szjUFlTVeSChppiJGippm5Bp7pwIu5W2Il5Tnvrikt0\\/tcZCMsnK8gUFcjXy9bcp7f7o30j\\/39iiqXJZSTKmQkNAQCSDzVJNBiTcbi0+9tjTP4+wVpFUco\\/eJTWnM2kEihINDTxgEQEsTQAcScQ7tvkR7v7A+ljcXiETSISK9lDkxJUkgtpXLjiOfZLEXu8Kq69xvAJJSw0ElAeWMakDLpGpSTzfIDLum1Q\\/cG+vU\\/E2SARO3\\/MhyU8OK6T6cPJvlmb7ZwRo3KyVngIIYgNlVGopJBGQzrQgnxZHuNpZ\\/dWxvn94X4aNGHN\\/hpTXJmumqigJFThdzhg++N9A\\/9\\/fIrFCGYgxR5iM0IBIJPLUEVPyCPaXaLLBKrJJG6hlZWFCrA5EEZEHE+89z\\/wD67vsmt9UC6rWVzqbnhy06mYVZCKKMkOGPe3bnbbdREe4WwMts4rlVx7BPmeh8UpL3a29oNoLhZNyugY7dRVdWknNyAwbSlSRiLd+8kSd4O8C6X7e6SsELaRURxGqmjVo7DVSmQIzCIAFAoAMgAPkHezvokmt5VKvHIoZGU8QVNQQfMcTb5+G8y9391kbWbfTWyYnSMkXOMUDHlrVm4ADHwnfva5baFjSO6T95bSZKTplWqkjUARxBy8S\\/Ddx9slngU0ku5B2dvHkxGqRqLU6SAPPliHeO\\/jf9x70lG0yLos42GfLFxeh6XND+iMJaWiLFBEqpHGihVVVFAqgZAAZAD5C5dp3q3iu7KddMsM6B0cVrQq1Qc8+vFxvv4RTHaNyCs42+Q67WVgKhUYnVETwFSy+gDDbP3622aykDEJKykxSAMyho5BysCVNPOBXxCuz9xdtmvZCwDyhSIowWVSzyHJQCy18wNeGIt5\\/Fm4G97iKN8FDqS0Q+Zjk8nr0j0Yj2zaLeK1s4gRHDBGscaAmpCqoAGZrkPkPl2HvTZQX+3zBleG4jDrzKVJFeBoSAwoRXI4m378F7v4K5JZ\\/uu8YtAxJY0il9pOKqqvqFBm2G2Pvztlxt10CdPapySAe8jjlcelSfDYu73crb5twvZW0hYl5RkTVmNFUUBNSRkD5sQ77+NN0L2ddLja7NyIQQQaSy5M4yIITSM\\/axFsPdaygsNvhChIbeMIvKoUE04mgALGpNMz8ib93u+dhBuO3SFWMM61FVIIIIoQcugjLLgcSbx+Ct72gyP3ZfuA3uj93Nkp99jr00yUE4fYe+O33O238dKw3MZRqEAgiuRFCDUVHhMew90rC43HcJTyw20Zdus04D0mgxHvf413ht4zmNrsXBkNQf8SbMLQ6TRA3SCRhdk7k7bb7bZj3IEoW5i3MxqzULGmomlcvkXOw9+ttg3G0z0iVeaMmlSjijIchmpHAYl3\\/8GLl9wtRrdtsuiO3RVUt+7kyEnDSFIDVIzOZEuyd5LSaxv4GZJIZ0KMpVipyPpBFRl4LFtGxW015ezMFjhgQu7E5ZKtTiDffxguPumwOiT7vgIe6deVqOwqsVVLKfadWGa4GxdxNvisoSF7WQCssrKoXVI5zJNKngK1IAqfkbba+\\/m1w3nKVjnppniyYApKtGGnUSBUrXMqcT73+Ec53nbQWcWMxVLtFqTRTkktBQZaWP6OJdp3u2mtL2BissE6NHIhHQVYAjwFLSyieaeQ6UjjUszHzACpOI93\\/EZz3c2tsxC667xxzD\\/D4JRgtdZBKtUDH3f3G26OGVq9pdyAPcyVJNHloCQOAAoKDhXP5H1tu\\/W3LNcRrpiu4j2dxGCysQrjz6acwNATSlcSbt+HTnvHtS59lGui8Qco\\/wuD8xNNBJ0ipGHtL2J4Z4zpeORSrKfMQaEflVhhUvI5CqqipJOQAA4k4g3nvLGe7+wSaH7W6WlxJGdDVii48yMSrNRagg4U90tuV9yAAfcLqktyx9DkUQehAo+SNj3t21U3Eiibha0iuVPpcCjj0OGGJt47pK3eHu\\/GpkMsCUuIlAZm7SIEkhVWpdcsx05BoJ1ZJEJVlYEEEZEEHMEfkodwltm2bu+7DVf3iEErzAmKM0Z6FCvRQkVyzxHfbVZjcd8UCu43yrJKGBBrEtNMeYBGkah+l8k8t3vNiLDe2DadysQI5tR1EGQU0yDU2ptQ1GntDE267XAd+2FKt8TYoWljXzyw5sKDiV1L6cFWFCMiD\\/AEhd7JaCx2UMFk3G9qkQqA3IvtyGhB5RTMVYYj3Lcbcb\\/vq5\\/F3yBo0NCD2cOaDJuLamyBBB+St7+K2+5N6YCl5YIqqaaBzw5I1FWgpp9ok1OJNxvLP712NM\\/vDbw0iKOXORKa482pVhpJBof9q\\/9oba423Vpk3C5rFbJnnzn2yP0U1HEG9d9Kd4t+jKuDMtLSJwVYaIveIKnNyQQaacJaWiLFBEqpHGihVVVFAqgZAAZAD5LSjgFSKEHMEHEu6bRF\\/2\\/vr1PxNkg7F2\\/wCbBkp610N6Tgbp3\\/u37y3SnkhaL4e2GTDmQO7McwRVxRl4HCbftcEVtax10RQoqItSSaKoAFSSev8A8PX\\/AP\\/Z\"\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "# 🌍 FACTURA CLIENTE EXTRANJERO Y MONEDA EXTRANJERA\n\n## 📄 Descripción General\n\nEste endpoint permite emitir **facturas de exportación a clientes extranjeros** utilizando **moneda extranjera** (USD, EUR, etc.). El sistema maneja automáticamente la conversión a pesos colombianos mediante la tasa de cambio (`calculationrate`), cumpliendo con las normas DIAN para operaciones internacionales.\n\n**Características clave:**\n- **Cliente extranjero:** Identificación internacional (pasaporte, tax ID)\n- **Moneda extranjera:** USD, EUR, GBP, etc. (currency_id)\n- **Tasa de cambio:** calculationrate (TRM del día)\n- **País destino:** country_id (ISO 3166-1)\n- **IVA:** Generalmente 0% (exportaciones exentas)\n- **type_liability_id:** 117 (No responsable de IVA - extranjero)\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/invoice\n```\n\n**Características:**\n- **Método:** POST (síncrono)\n- **Autenticación:** Bearer token\n- **Respuesta:** CUFE + XML firmado\n\n---\n\n## 💱 Campos Específicos: Moneda Extranjera\n\n### 1. Moneda y Tasa de Cambio\n\n| Campo | Valor Ejemplo | Descripción |\n|-------|---------------|-------------|\n| **currency_id** | 149 | **USD - Dólar estadounidense** |\n| **calculationrate** | \"4250\" | **Tasa de cambio TRM** (string) |\n| **line_extension_amount** | \"425000.00\" | Subtotal en **COP** |\n| **payable_amount** | \"425000.00\" | Total en **COP** |\n\n**Crítico:** Los montos se expresan en **pesos colombianos (COP)**, la moneda extranjera es **referencial** en el XML.\n\n### 2. Cliente Extranjero\n\n| Campo | Valor Ejemplo | Descripción |\n|-------|---------------|-------------|\n| **identification_number** | \"AB1234567\" | ID internacional (pasaporte, tax ID) |\n| **name** | \"CLIENTE DEL EXTRANJERO\" | Razón social |\n| **type_document_identification_id** | **8** | **Pasaporte** |\n| **country_id** | **65** | **Estados Unidos (USA)** |\n| **municipality_name** | \"Ashville\" | Ciudad extranjera |\n| **state_name** | \"Alabama\" | Estado/Provincia |\n| **type_regime_id** | 2 | No aplica régimen colombiano |\n| **type_liability_id** | **117** | **No responsable IVA** |\n| **merchant_registration** | \"000000\" | No aplica registro mercantil |\n\n### 3. Impuestos (Exportación)\n\n```json\n\"tax_totals\": [{\n \"tax_id\": 1,\n \"tax_amount\": \"0.00\",\n \"percent\": \"0.00\",\n \"taxable_amount\": \"425000.00\"\n}]\n```\n\n**IVA 0%:** Exportaciones están exentas de IVA según normativa DIAN.\n\n---\n\n## 📝 Notas Críticas sobre Facturación Internacional\n\n### 📌 1. Monedas Soportadas (currency_id)\n\n**Principales monedas:**\n\n| currency_id | Código | Moneda | País/Región |\n|-------------|--------|--------|-------------|\n| **149** | USD | Dólar estadounidense | Estados Unidos |\n| **52** | EUR | Euro | Zona Euro |\n| **60** | GBP | Libra esterlina | Reino Unido |\n| **41** | CAD | Dólar canadiense | Canadá |\n| **85** | MXN | Peso mexicano | México |\n| **20** | BRL | Real brasileño | Brasil |\n| **100** | JPY | Yen japonés | Japón |\n| **26** | CNY | Yuan chino | China |\n\n**Consultar tabla completa:** Base de datos API → tabla `currencies`\n\n```sql\nSELECT id, code, name \nFROM currencies \nWHERE active = 1\nORDER BY code;\n```\n\n### 📌 2. Tasa de Cambio (calculationrate)\n\n```json\n{\n \"currency_id\": 149, // USD\n \"calculationrate\": \"4250\" // 1 USD = $4,250 COP\n}\n```\n\n**Funcionamiento:**\n\n```javascript\n// Valor en moneda extranjera (USD)\nconst amountUSD = 100.00;\n\n// Tasa de cambio TRM\nconst trm = 4250;\n\n// Conversión a COP (para DIAN)\nconst amountCOP = amountUSD * trm;\n// = 100 * 4250 = $425,000 COP\n\n// En invoice_lines:\n{\n \"line_extension_amount\": \"425000.00\", // COP\n \"price_amount\": \"425000.00\" // COP\n}\n```\n\n**Fuente TRM oficial:**\n- Banco de la República de Colombia\n- https://www.banrep.gov.co/es/estadisticas/trm\n- Se toma TRM del día de la factura\n\n**Ejemplo cálculo:**\n```\nProducto: Licencia Software\nPrecio: USD $100.00\nTRM 2025-11-07: $4,250 COP\n\nSubtotal COP: 100 × 4,250 = $425,000\nIVA (0%): $0\nTotal: $425,000 COP\n\nEn XML aparece:\n- DocumentCurrencyCode: COP\n- PricingCurrencyCode: USD\n- CalculationRate: 4250\n- LineExtensionAmount: 425000.00\n```\n\n### 📌 3. Tipos de Identificación Extranjera\n\n**type_document_identification_id para extranjeros:**\n\n| ID | Tipo | Uso |\n|----|------|-----|\n| **8** | **Pasaporte** | Personas naturales extranjeras |\n| **9** | **Documento extranjero** | ID fiscal de otro país |\n| **50** | **NIT extranjero** | Empresas extranjeras |\n| **91** | **NUIP** | Identificación unificada |\n\n**Ejemplo real:**\n```json\n// Persona natural USA\n{\n \"identification_number\": \"AB1234567\", // Pasaporte\n \"type_document_identification_id\": 8,\n \"country_id\": 65 // USA\n}\n\n// Empresa USA\n{\n \"identification_number\": \"12-3456789\", // EIN Tax ID\n \"type_document_identification_id\": 50,\n \"country_id\": 65\n}\n\n// Empresa europea\n{\n \"identification_number\": \"ESB12345678\", // VAT Number\n \"type_document_identification_id\": 50,\n \"country_id\": 68 // España\n}\n```\n\n### 📌 4. Países (country_id)\n\n**Principales destinos exportación:**\n\n| country_id | Código ISO | País |\n|------------|------------|------|\n| **65** | US | Estados Unidos |\n| **68** | ES | España |\n| **97** | MX | México |\n| **13** | BR | Brasil |\n| **39** | FR | Francia |\n| **38** | DE | Alemania |\n| **94** | IT | Italia |\n| **46** | CN | China |\n\n**Consultar tabla:**\n```sql\nSELECT id, code, name \nFROM countries \nWHERE id != 46 -- Excluir Colombia\nORDER BY name;\n```\n\n### 📌 5. Responsabilidad Fiscal Extranjera\n\n```json\n{\n \"type_regime_id\": 2, // No aplica régimen colombiano\n \"type_liability_id\": 117 // No responsable de IVA\n}\n```\n\n**type_liability_id para extranjeros:**\n\n| ID | Descripción | Uso |\n|----|-------------|-----|\n| **117** | **No responsable de IVA** | **Clientes extranjeros** |\n| **22** | Régimen simple | Personas naturales (excepcional) |\n\n**Crítico:** Extranjeros NO son responsables de IVA colombiano.\n\n### 📌 6. Ubicación Geográfica Extranjera\n\n```json\n{\n \"municipality_name\": \"Ashville\", // Ciudad (texto libre)\n \"state_name\": \"Alabama\", // Estado/Provincia\n \"country_id\": 65, // USA\n \"address\": \"EVERGREEN AV 5 68\"\n}\n```\n\n**Importante:**\n- `municipality_id` NO se usa (solo aplica ciudades Colombia)\n- `municipality_name` y `state_name` son **texto libre**\n- `country_id` es **obligatorio**\n- Formato dirección según país destino\n\n**Ejemplos por país:**\n```json\n// USA\n{\n \"address\": \"123 Main Street, Suite 100\",\n \"municipality_name\": \"Miami\",\n \"state_name\": \"Florida\",\n \"country_id\": 65\n}\n\n// España\n{\n \"address\": \"Calle Gran Vía 45, 3º A\",\n \"municipality_name\": \"Madrid\",\n \"state_name\": \"Comunidad de Madrid\",\n \"country_id\": 68\n}\n\n// México\n{\n \"address\": \"Av. Reforma 222, Col. Juárez\",\n \"municipality_name\": \"Ciudad de México\",\n \"state_name\": \"CDMX\",\n \"country_id\": 97\n}\n```\n\n### 📌 7. IVA en Exportaciones (0%)\n\n```json\n\"tax_totals\": [{\n \"tax_id\": 1, // IVA\n \"tax_amount\": \"0.00\", // Sin IVA\n \"percent\": \"0.00\", // 0%\n \"taxable_amount\": \"425000.00\" // Base gravable\n}]\n```\n\n**Normativa DIAN:**\n- Exportaciones de bienes: IVA 0%\n- Exportaciones de servicios: IVA 0%\n- Base gravable se reporta, impuesto = 0\n\n**Excepción - Servicios nacionales:**\n```json\n// Si el servicio se presta EN Colombia (cliente extranjero visita)\n\"tax_totals\": [{\n \"tax_id\": 1,\n \"tax_amount\": \"80750.00\", // 19% IVA\n \"percent\": \"19.00\",\n \"taxable_amount\": \"425000.00\"\n}]\n```\n\n### 📌 8. Estructura XML Generado\n\n**Sección moneda en XML UBL 2.1:**\n\n```xml\n\n COP\n 1\n \n \n \n USD\n COP\n 4250\n 2025-11-07\n \n \n \n \n \n \n AB1234567\n \n \n CLIENTE DEL EXTRANJERO\n \n \n \n Ashville\n Alabama\n \n US\n \n \n \n \n \n \n \n \n 425000.00\n 425000.00\n 425000.00\n 425000.00\n \n\n```\n\n### 📌 9. Cálculo Completo: USD → COP\n\n**Escenario: Venta de licencia software a USA**\n\n```javascript\n// Datos base\nconst producto = {\n descripcion: \"Licencia Software Enterprise\",\n precioUSD: 100.00,\n cantidad: 1\n};\n\nconst trm = 4250; // TRM del día\nconst currency_id = 149; // USD\n\n// Conversión\nconst subtotalUSD = producto.precioUSD * producto.cantidad;\n// = 100 * 1 = 100 USD\n\nconst subtotalCOP = subtotalUSD * trm;\n// = 100 * 4250 = 425,000 COP\n\nconst ivaCOP = 0; // Exportación exenta\n\nconst totalCOP = subtotalCOP + ivaCOP;\n// = 425,000 + 0 = 425,000 COP\n\n// Body API\nconst factura = {\n currency_id: 149,\n calculationrate: \"4250\",\n invoice_lines: [{\n description: \"Licencia Software Enterprise\",\n invoiced_quantity: 1,\n price_amount: \"425000.00\", // COP\n line_extension_amount: \"425000.00\" // COP\n }],\n tax_totals: [{\n tax_id: 1,\n tax_amount: \"0.00\",\n percent: \"0.00\",\n taxable_amount: \"425000.00\"\n }],\n legal_monetary_totals: {\n line_extension_amount: \"425000.00\",\n tax_exclusive_amount: \"425000.00\",\n tax_inclusive_amount: \"425000.00\",\n payable_amount: \"425000.00\"\n }\n};\n```\n\n### 📌 10. Validaciones Sistema\n\n**Al enviar factura extranjera, API valida:**\n\n✓ `currency_id` existe en tabla currencies \n✓ `calculationrate` es numérico positivo \n✓ `country_id` válido (no Colombia = 46) \n✓ `type_document_identification_id` compatible con extranjeros (8, 9, 50) \n✓ `type_liability_id` = 117 para extranjeros \n✓ Conversión moneda: COP = cantidad × precio × TRM \n✓ Si exportación: IVA debe ser 0% \n\n**Validación TRM:**\n```javascript\nif (data.currency_id !== 35) { // 35 = COP\n if (!data.calculationrate || parseFloat(data.calculationrate) <= 0) {\n throw new Error('calculationrate requerido para moneda extranjera');\n }\n \n // Validar TRM razonable (USD ejemplo)\n const trm = parseFloat(data.calculationrate);\n if (trm < 3000 || trm > 6000) {\n console.warn('TRM fuera de rango esperado USD');\n }\n}\n```\n\n### 📌 11. Errores Comunes\n\n| Error | Causa | Solución |\n|-------|-------|----------|\n| \"Invalid currency_id\" | Moneda no existe | Consultar tabla currencies |\n| \"calculationrate required\" | Falta TRM | Incluir tasa de cambio |\n| \"Invalid country for foreign\" | country_id = 46 (Colombia) | Usar país extranjero |\n| \"Tax rate must be 0% for export\" | IVA > 0 en exportación | Establecer percent: 0.00 |\n| \"type_liability_id invalid\" | No es 117 | Usar 117 para extranjeros |\n| \"municipality_id not allowed\" | ID ciudad colombiana | Usar municipality_name (texto) |\n\n### 📌 12. Casos de Uso Reales\n\n**A. Exportación Software (USA)**\n```json\n{\n \"customer\": {\n \"identification_number\": \"12-3456789\",\n \"name\": \"MICROSOFT CORP\",\n \"type_document_identification_id\": 50,\n \"country_id\": 65,\n \"municipality_name\": \"Redmond\",\n \"state_name\": \"Washington\",\n \"type_liability_id\": 117\n },\n \"currency_id\": 149,\n \"calculationrate\": \"4250\",\n \"tax_totals\": [{\"tax_id\": 1, \"percent\": \"0.00\"}]\n}\n```\n\n**B. Servicios de Consultoría (España)**\n```json\n{\n \"customer\": {\n \"identification_number\": \"ESB98765432\",\n \"name\": \"CONSULTORA MADRID SL\",\n \"type_document_identification_id\": 50,\n \"country_id\": 68,\n \"municipality_name\": \"Madrid\",\n \"state_name\": \"Comunidad de Madrid\",\n \"type_liability_id\": 117\n },\n \"currency_id\": 52, // EUR\n \"calculationrate\": \"4600\", // 1 EUR = $4,600 COP\n \"tax_totals\": [{\"tax_id\": 1, \"percent\": \"0.00\"}]\n}\n```\n\n**C. Venta Productos (México)**\n```json\n{\n \"customer\": {\n \"identification_number\": \"XAXX010101000\",\n \"name\": \"COMERCIAL MEXICANA SA\",\n \"type_document_identification_id\": 50,\n \"country_id\": 97,\n \"municipality_name\": \"Guadalajara\",\n \"state_name\": \"Jalisco\",\n \"type_liability_id\": 117\n },\n \"currency_id\": 85, // MXN\n \"calculationrate\": \"220\", // 1 MXN = $220 COP\n \"tax_totals\": [{\"tax_id\": 1, \"percent\": \"0.00\"}]\n}\n```\n\n### 📌 13. PDF Factura Extranjera\n\n**Información adicional en PDF:**\n\n```\n╔═══════════════════════════════════════════════╗\n║ FACTURA DE EXPORTACIÓN ║\n║ INVOICE - EXPORT DOCUMENT ║\n╠═══════════════════════════════════════════════╣\n║ Cliente / Customer: ║\n║ CLIENTE DEL EXTRANJERO ║\n║ Passport: AB1234567 ║\n║ ║\n║ Dirección / Address: ║\n║ EVERGREEN AV 5 68 ║\n║ Ashville, Alabama ║\n║ United States ║\n╠═══════════════════════════════════════════════╣\n║ Moneda / Currency: USD ║\n║ Tasa de Cambio / Exchange Rate: $4,250 COP ║\n║ Fecha TRM / Rate Date: 2025-11-07 ║\n╠═══════════════════════════════════════════════╣\n║ DETALLE ║\n║ ------------------------------------------- ║\n║ Licencia Software USD $100.00 ║\n║ (Equiv. COP $425,000) ║\n║ ║\n║ Subtotal: COP $425,000.00 ║\n║ IVA 0% (Exportación): COP $0.00 ║\n║ TOTAL: COP $425,000.00 ║\n║ ║\n║ TOTAL USD EQUIV: USD $100.00 ║\n╠═══════════════════════════════════════════════╣\n║ IVA 0% - Exportación exenta de IVA ║\n║ VAT 0% - Export VAT exempt ║\n╚═══════════════════════════════════════════════╝\n```\n\n### 📌 14. Documentos Soporte Exportación\n\n**Además de factura electrónica:**\n\n1. **Declaración de Exportación (DIAN)**\n - DEX (Declaración de Exportación)\n - Registro ante DIAN/Aduana\n\n2. **Documentos de Transporte**\n - AWB (Air Waybill) - aéreo\n - BL (Bill of Lading) - marítimo\n - Guía courier - terrestre\n\n3. **Factura Comercial**\n - Commercial Invoice (inglés)\n - Complementa factura electrónica\n\n4. **Certificados**\n - Certificado de Origen\n - Certificados sanitarios (si aplica)\n\n5. **Pago**\n - Declaración de Cambio\n - Registro divisas (>USD 10,000)\n\n### 📌 15. Resumen: Facturación Internacional\n\n- **Propósito:** Facturar a clientes fuera de Colombia\n- **Moneda:** USD, EUR, etc. (currency_id)\n- **TRM:** calculationrate (Banco de la República)\n- **Montos:** Expresados en COP (obligatorio DIAN)\n- **Cliente:** identification extranjera (pasaporte, tax ID)\n- **País:** country_id diferente a 46 (Colombia)\n- **IVA:** Generalmente 0% (exportaciones)\n- **Responsabilidad:** type_liability_id = 117\n- **Ubicación:** municipality_name y state_name texto libre\n- **XML:** Incluye PricingExchangeRate con TRM\n- **PDF:** Muestra equivalencia USD/EUR y COP\n- **Normativa:** Cumple regulación DIAN exportaciones" }, "response": [] }, { "name": "SendInvoice-TestSetId Varias Tarifas y Descuentos", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": 990000215,\r\n \"type_document_id\": 1,\r\n \"prefix\": \"SETP\",\r\n \"resolution_number\": \"18760000001\",\r\n \"date\": \"2025-11-07\",\r\n \"time\": \"11:12:48\",\r\n \"customer\": {\r\n \"identification_number\": 89008003,\r\n \"name\": \"ALEXANDER OBANDO LONDONO\",\r\n \"phone\": \"3103891693\",\r\n \"address\": \"BRR LIMONAR MZ 6 CS 3 ET 1\",\r\n \"email\": \"alexander_obando@hotmail.com\",\r\n \"merchant_registration\": \"0000-00\",\r\n \"type_document_identification_id\": 3,\r\n \"type_organization_id\": 2,\r\n \"municipality_id\": 149,\r\n \"type_regime_id\": 2\r\n },\r\n \"payment_form\": {\r\n \"payment_form_id\": 1,\r\n \"payment_method_id\": 10,\r\n \"payment_due_date\": \"2021-08-17\",\r\n \"duration_measure\": \"0\"\r\n },\r\n \"allowance_charges\": [\r\n {\r\n \"discount_id\": 1,\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"1317.08\",\r\n \"base_amount\": \"32246.50\"\r\n }\r\n ],\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"32246.50\",\r\n \"tax_exclusive_amount\": \"32246.50\",\r\n \"tax_inclusive_amount\": \"36014.00\",\r\n \"allowance_total_amount\": \"1317.08\",\r\n \"charge_total_amount\": \"0.00\",\r\n \"payable_amount\": \"34696.92\"\r\n },\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"0.00\",\r\n \"percent\": \"0\",\r\n \"taxable_amount\": \"5400.00\"\r\n },\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"476.19\",\r\n \"percent\": \"5\",\r\n \"taxable_amount\": \"9523.81\"\r\n },\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"3291.31\",\r\n \"percent\": \"19\",\r\n \"taxable_amount\": \"17322.69\"\r\n }\r\n ],\r\n \"invoice_lines\": [\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"4\",\r\n \"line_extension_amount\": \"6722.69\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"336.13\",\r\n \"base_amount\": \"8000.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"1277.31\",\r\n \"taxable_amount\": \"6722.69\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"BONOS POR SERVICIOS\",\r\n \"code\": \"BONOS\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"1764.70\",\r\n \"base_quantity\": \"4\"\r\n },\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"9523.81\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"380.95\",\r\n \"base_amount\": \"10000.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"476.19\",\r\n \"taxable_amount\": \"9523.81\",\r\n \"percent\": \"5.00\"\r\n }\r\n ],\r\n \"description\": \"CARNE MOLIDA\",\r\n \"code\": \"CARNE\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"9904.76\",\r\n \"base_quantity\": \"1\"\r\n },\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"2\",\r\n \"line_extension_amount\": \"3000.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"360.00\",\r\n \"base_amount\": \"3000.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"0.00\",\r\n \"taxable_amount\": \"3000.00\",\r\n \"percent\": \"0.00\"\r\n }\r\n ],\r\n \"description\": \"CESANTIA MERCANTIL\",\r\n \"code\": \"CESANTIA\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"1680.00\",\r\n \"base_quantity\": \"2\"\r\n },\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"2000.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"2380.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"380.00\",\r\n \"taxable_amount\": \"2000.00\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"COMISION POR SERVICIOS\",\r\n \"code\": \"COMISION\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"2000.00\",\r\n \"base_quantity\": \"1\"\r\n },\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"2\",\r\n \"line_extension_amount\": \"2400.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"240.00\",\r\n \"base_amount\": \"2400.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"0.00\",\r\n \"taxable_amount\": \"2400.00\",\r\n \"percent\": \"0.00\"\r\n }\r\n ],\r\n \"description\": \"CURUBA\",\r\n \"code\": \"CURUBA\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"1320.00\",\r\n \"base_quantity\": \"2\"\r\n },\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"1000.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"1190.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"190.00\",\r\n \"taxable_amount\": \"1000.00\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"MANZANA\",\r\n \"code\": \"MANZANA\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"1000.00\",\r\n \"base_quantity\": \"1\"\r\n },\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"4\",\r\n \"line_extension_amount\": \"7600.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"9044.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"1444.00\",\r\n \"taxable_amount\": \"7600.00\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"PERAS\",\r\n \"code\": \"PERAS\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"1900.00\",\r\n \"base_quantity\": \"4\"\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "# 📄 ENVIAR FACTURA ELECTRÓNICA - MÚLTIPLES TARIFAS DE IVA\n\n## 📋 Descripción General\nEndpoint especializado para facturas que incluyen productos/servicios con diferentes tarifas de IVA en una misma transacción. Permite combinar artículos con IVA 19%, 5%, 0% y excluidos en una sola factura.\n\n## 🔗 URL del Endpoint\n**Síncrono (recomendado):** `POST /api/ubl2.1/invoice`\n**Asíncrono:** `POST /api/ubl2.1/invoice/{testSetId}`\n\n## 🔑 Campos Principales Específicos\n| Campo | Tipo | Descripción |\n|-------|------|-------------|\n| `tax_totals` | array | Array con totales por cada tarifa de IVA |\n| `invoice_lines` | array | Cada línea con su tarifa específica |\n| `legal_monetary_totals` | object | Totales consolidados de todas las tarifas |\n\n## 📊 Tarifas de IVA Soportadas\n- **19%:** Tarifa general (tax_id: 1, percent: \"19.00\")\n- **5%:** Tarifa reducida (tax_id: 1, percent: \"5.00\")\n- **0%:** Tarifa cero/exento (tax_id: 1, percent: \"0.00\")\n- **Excluido:** Sin IVA aplicable\n\n## 💰 Estructura de Tax Totals\nEl array `tax_totals` debe consolidar por tarifa:\n```json\n\"tax_totals\": [\n {\n \"tax_id\": 1,\n \"tax_amount\": \"190000.00\",\n \"taxable_amount\": \"1000000.00\",\n \"percent\": \"19.00\"\n },\n {\n \"tax_id\": 1,\n \"tax_amount\": \"25000.00\",\n \"taxable_amount\": \"500000.00\",\n \"percent\": \"5.00\"\n },\n {\n \"tax_id\": 1,\n \"tax_amount\": \"0.00\",\n \"taxable_amount\": \"200000.00\",\n \"percent\": \"0.00\"\n }\n]\n```\n\n## 📦 Invoice Lines con Diferentes Tarifas\nCada línea especifica su propia tarifa:\n```json\n{\n \"description\": \"Producto con IVA 19%\",\n \"price_amount\": \"1000000.00\",\n \"tax_totals\": [\n {\n \"tax_id\": 1,\n \"tax_amount\": \"190000.00\",\n \"taxable_amount\": \"1000000.00\",\n \"percent\": \"19.00\"\n }\n ]\n},\n{\n \"description\": \"Producto con IVA 5%\",\n \"price_amount\": \"500000.00\",\n \"tax_totals\": [\n {\n \"tax_id\": 1,\n \"tax_amount\": \"25000.00\",\n \"taxable_amount\": \"500000.00\",\n \"percent\": \"5.00\"\n }\n ]\n}\n```\n\n## 📊 Cálculo de Totales\n- **tax_exclusive_amount:** Suma de todos los taxable_amount\n- **tax_inclusive_amount:** Suma de taxable_amount + todos los tax_amount\n- **payable_amount:** Total final con todos los impuestos\n- El tax_amount en tax_totals debe ser la suma de los tax_amount de las líneas con esa tarifa\n\n## ⚙️ Comportamiento del Sistema\n- **Consolidación Automática:** Agrupa impuestos por tarifa\n- **Validación de Tarifas:** Verifica que las tarifas sean válidas según DIAN\n- **Cálculo Verificado:** Valida que los totales consolidados cuadren\n- **Modo Síncrono:** Respuesta con desglose de impuestos por tarifa\n- **Modo Asíncrono:** ZIP_KEY para consulta posterior\n\n## ✅ Validaciones Críticas\n- Validación de que tax_totals consolida correctamente las tarifas\n- Verificación de que cada línea tiene tax_totals correcto\n- Validación de tarifas permitidas por DIAN (19%, 5%, 0%)\n- Verificación de que la suma de tax_amount por tarifa cuadra\n- Validación de que tax_exclusive_amount suma todos los taxable\n\n## 💾 Impacto en Base de Datos\n- Tabla `documents`: Registro con totales consolidados\n- Tabla `document_lines`: Una fila por línea con su tarifa\n- Tabla `tax_totals`: Registro separado por cada tarifa de IVA\n- Guardado de desglose para reportes tributarios\n\n## 📤 Respuesta Exitosa (200 - Síncrono)\n```json\n{\n \"success\": true,\n \"message\": \"Factura procesada exitosamente\",\n \"ResponseDian\": {\n \"Envelope\": {\n \"Body\": {\n \"SendBillSyncResponse\": {\n \"SendBillSyncResult\": {\n \"IsValid\": \"true\",\n \"StatusCode\": \"00\",\n \"StatusDescription\": \"Procesado Correctamente\"\n }\n }\n }\n }\n },\n \"cufe\": \"...\",\n \"tax_breakdown\": {\n \"iva_19\": \"190000.00\",\n \"iva_5\": \"25000.00\",\n \"iva_0\": \"0.00\"\n },\n \"pdf_url\": \"storage/pdf/...\"\n}\n```\n\n## 📤 Respuesta Exitosa (200 - Asíncrono)\n```json\n{\n \"success\": true,\n \"message\": \"Factura enviada al set de pruebas\",\n \"zip_key\": \"...\",\n \"tax_rates_count\": 3\n}\n```\n\n## ⚠️ Errores Comunes\n- **400:** Tarifa de IVA no válida o no permitida por DIAN\n- **401:** Token de autorización inválido\n- **422:** Consolidación incorrecta de tax_totals o totales no cuadran\n- **500:** Error al procesar múltiples tarifas\n\n## 🔐 Autenticación\n```\nAuthorization: Bearer {API_TOKEN}\nContent-Type: application/json\n```\n\n## 💻 Ejemplo cURL\n```bash\ncurl -X POST \"http://midominio.com/api/ubl2.1/invoice\" \\\n -H \"Authorization: Bearer {TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"number\": 990000123,\n \"tax_totals\": [\n {\"tax_id\": 1, \"percent\": \"19.00\", \"tax_amount\": \"190000\", \"taxable_amount\": \"1000000\"},\n {\"tax_id\": 1, \"percent\": \"5.00\", \"tax_amount\": \"25000\", \"taxable_amount\": \"500000\"}\n ],\n \"invoice_lines\": [\n {\"description\": \"Art IVA 19%\", \"tax_totals\": [{\"percent\": \"19.00\", ...}]},\n {\"description\": \"Art IVA 5%\", \"tax_totals\": [{\"percent\": \"5.00\", ...}]}\n ]\n }'\n```\n\n## 📝 Casos de Uso Comunes\n1. **Supermercados:** Alimentos (5%) + productos generales (19%)\n2. **Restaurantes:** Comida (5%) + bebidas alcohólicas (19%)\n3. **Farmacias:** Medicamentos (0%) + cosméticos (19%)\n4. **Librerías:** Libros (0%) + útiles escolares (19%)\n\n## 📌 Notas Importantes\n1. El array tax_totals debe tener una entrada por cada tarifa utilizada\n2. Cada línea en invoice_lines debe Especificar correctamente su tarifa\n3. La suma de tax_amount de todas las líneas con percent X debe igualar el tax_amount del tax_totals con percent X\n4. El sistema valida automáticamente la consolidación correcta\n5. Las tarifas deben corresponder con la clasificación DIAN del producto\n6. El PDF generado muestra el desglose por tarifa de IVA\n7. Modo síncrono recomendado para validar cálculos complejos" }, "response": [] }, { "name": "SendInvoice-TestSetId Delivery", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": 990000216,\r\n \"type_document_id\": 1,\r\n \"resolution_number\": \"18760000001\",\r\n \"prefix\": \"SETP\",\r\n \"date\": \"2025-11-07\",\r\n \"time\": \"04:08:12\",\r\n \"sendmail\": true,\r\n \"customer\": {\r\n \"identification_number\": 900166483,\r\n \"dv\": 1,\r\n \"name\": \"INVERSIONES DAVAL SAS\",\r\n \"phone\": \"3103891693\",\r\n \"address\": \"CLL 4 NRO 33-90\",\r\n \"email\": \"alexanderobandolondono@gmail.com\",\r\n \"merchant_registration\": \"0000000-00\",\r\n \"type_document_identification_id\": 6,\r\n \"type_organization_id\": 1,\r\n \"municipality_id\": 822,\r\n \"type_regime_id\": 1\r\n },\r\n \"delivery\": {\r\n \"languaje_id\": 79,\r\n \"country_id\": 46,\r\n \"municipality_id\": 822,\r\n \"address\": \"CLL 4 NRO 33-90\",\r\n \"actual_delivery_date\": \"2025-11-07\"\r\n },\r\n \"deliveryparty\": {\r\n \"identification_number\": 890050452,\r\n \"dv\": 9,\r\n \"name\": \"INVERSIONES DAVAL SAS\",\r\n \"phone\": \"3103891693\",\r\n \"address\": \"CLL 4 NRO 33-90\",\r\n \"email\": \"alexanderobandolondono@gmail.com\",\r\n \"merchant_registration\": \"0000000-00\",\r\n \"type_document_identification_id\": 6,\r\n \"type_organization_id\": 1,\r\n \"municipality_id\": 822,\r\n \"type_regime_id\": 1\r\n },\r\n \"payment_form\": {\r\n \"payment_form_id\": 2,\r\n \"payment_method_id\": 30,\r\n \"payment_due_date\": \"2025-12-07\",\r\n \"duration_measure\": \"30\"\r\n },\r\n \"allowance_charges\": [\r\n {\r\n \"discount_id\": 1,\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"840336.13\"\r\n }\r\n ],\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"840336.13\",\r\n \"tax_exclusive_amount\": \"840336.13\",\r\n \"tax_inclusive_amount\": \"1000000.00\",\r\n \"allowance_total_amount\": \"0.00\",\r\n \"charge_total_amount\": \"0.00\",\r\n \"payable_amount\": \"1000000.00\"\r\n },\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"159663.86\",\r\n \"percent\": \"19\",\r\n \"taxable_amount\": \"840336.13\"\r\n }\r\n ],\r\n \"invoice_lines\": [\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"840336.13\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"1000000000.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"159663.86\",\r\n \"taxable_amount\": \"840336.13\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"COMISION POR SERVICIOS\",\r\n \"code\": \"COMISION\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"840336.13\",\r\n \"base_quantity\": \"1\"\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "# 🚚 ENVIAR FACTURA ELECTRÓNICA - CON DELIVERY\n\n## 📋 Descripción General\nEndpoint para envío de facturas electrónicas que incluyen información de entrega (delivery). Permite Especificar la empresa transportadora o persona responsable de realizar la entrega física de los productos.\n\n## 🔗 URL del Endpoint\n**Síncrono (recomendado):** `POST /api/ubl2.1/invoice`\n**Asíncrono:** `POST /api/ubl2.1/invoice/{testSetId}`\n\n## 🔑 Campos Principales Específicos\n| Campo | Tipo | Descripción |\n|-------|------|-------------|\n| `delivery` | object | Datos de la entrega |\n| `delivery.actual_delivery_date` | date | Fecha de entrega (YYYY-MM-DD) |\n| `delivery.actual_delivery_time` | time | Hora de entrega (HH:MM:SS) |\n| `delivery_party` | object | Empresa o persona que realiza la entrega |\n| `delivery_party.party_name` | string | Nombre de la transportadora |\n| `delivery_party.party_identification` | string | NIT/Identificación del transportador |\n| `delivery_party.physical_location` | object | Dirección de entrega |\n\n## 📦 Estructura de Delivery\n```json\n\"delivery\": {\n \"actual_delivery_date\": \"2025-11-20\",\n \"actual_delivery_time\": \"14:30:00\"\n},\n\"delivery_party\": {\n \"party_name\": \"Transportes Express S.A.S.\",\n \"party_identification\": \"900123456\",\n \"party_identification_type\": \"31\",\n \"physical_location\": {\n \"address\": {\n \"city_name\": \"Bogotá D.C.\",\n \"postal_zone\": \"110111\",\n \"address_line\": \"Calle 123 # 45-67\"\n }\n }\n}\n```\n\n## 💼 Casos de Uso\n- **E-commerce:** Entregas por empresas de logística\n- **Distribución:** Transporte propio de mercancías\n- **Domicilios:** Servicios de mensajería\n- **Exportaciones:** Empresas de transporte internacional\n\n## ⚙️ Comportamiento del Sistema\n- **Modo Síncrono:** Validación inmediata de datos de entrega\n- **Modo Asíncrono:** ZIP_KEY para consulta posterior\n- **XML Generation:** delivery y delivery_party se incluyen en el XML UBL 2.1\n- **Trazabilidad:** Seguimiento de quién y cuándo entrega\n- **Validación:** Verifica formatos de fecha, hora y NIT del transportador\n\n## ✅ Validaciones Críticas\n- Validación de formato de fecha (YYYY-MM-DD)\n- Validación de formato de hora (HH:MM:SS)\n- Verificación de NIT del delivery_party\n- Validación de que actual_delivery_date no sea anterior a document.date\n- Coherencia entre dirección de entrega y customer\n\n## 💾 Impacto en Base de Datos\n- Tabla `documents`: Campos `delivery_date`, `delivery_time`\n- Tabla `delivery_parties`: Registro del transportador\n- Tabla `addresses`: Dirección de entrega\n- Índice por delivery_party_identification para búsquedas\n\n## 📤 Respuesta Exitosa (200 - Síncrono)\n```json\n{\n \"success\": true,\n \"message\": \"Factura procesada exitosamente\",\n \"ResponseDian\": {\n \"Envelope\": {\n \"Body\": {\n \"SendBillSyncResponse\": {\n \"SendBillSyncResult\": {\n \"IsValid\": \"true\",\n \"StatusCode\": \"00\",\n \"StatusDescription\": \"Procesado Correctamente\"\n }\n }\n }\n }\n },\n \"cufe\": \"...\",\n \"delivery\": {\n \"actual_delivery_date\": \"2025-11-20\",\n \"actual_delivery_time\": \"14:30:00\"\n },\n \"delivery_party\": \"Transportes Express S.A.S.\",\n \"pdf_url\": \"storage/pdf/...\"\n}\n```\n\n## 📤 Respuesta Exitosa (200 - Asíncrono)\n```json\n{\n \"success\": true,\n \"message\": \"Factura enviada al set de pruebas\",\n \"zip_key\": \"...\",\n \"delivery_party_id\": \"900123456\"\n}\n```\n\n## ⚠️ Errores Comunes\n- **400:** Formato de fecha u hora inválido en delivery\n- **401:** Token de autorización inválido\n- **422:** NIT del delivery_party inválido o fecha de entrega anterior a fecha de factura\n- **500:** Error interno al procesar delivery\n\n## 🔐 Autenticación\n```\nAuthorization: Bearer {API_TOKEN}\nContent-Type: application/json\n```\n\n## 💻 Ejemplo cURL\n```bash\ncurl -X POST \"http://midominio.com/api/ubl2.1/invoice\" \\\n -H \"Authorization: Bearer {TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"number\": 990000124,\n \"delivery\": {\n \"actual_delivery_date\": \"2025-11-20\",\n \"actual_delivery_time\": \"14:30:00\"\n },\n \"delivery_party\": {\n \"party_name\": \"Transportes Express S.A.S.\",\n \"party_identification\": \"900123456\"\n },\n \"customer\": {...},\n \"invoice_lines\": [...]\n }'\n```\n\n## 📝 Campos Relacionados\n- **despatch_document_reference:** Referencia a remisión de mercancías\n- **delivery_terms:** Términos y condiciones de entrega (INCOTERMS)\n- **transport_handling_unit:** Unidades de transporte (pallets, cajas)\n\n## 📌 Notas Importantes\n1. Los campos delivery y delivery_party son opcionales\n2. Útil para trazabilidad logística completa\n3. El delivery_party puede ser diferente al emisor y receptor\n4. La fecha de entrega puede ser igual o posterior a la fecha de la factura\n5. El XML incluye Delivery y DeliveryParty en el esquema UBL 2.1\n6. Facilita auditorías de transporte y logística\n7. Aparece en el PDF de representación gráfica si está configurado" }, "response": [] }, { "name": "SendInvoice - TestSetId Impuesto Licores", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": \"990000217\",\r\n \"type_document_id\": 1,\r\n \"date\": \"2025-11-07\",\r\n \"time\": \" 18:34:00\",\r\n \"resolution_number\": \"18760000001\",\r\n \"prefix\": \"SETP\",\r\n \"notes\": \"Pedido Desde App Desde Cotización:CT-664857 CT-664857 V14\",\r\n \"disable_confirmation_text\": true,\r\n \"establishment_name\": \"RINVAL S.A.S\",\r\n \"establishment_address\": \"CLL 11 # 47B 20 ESPERANZA\",\r\n \"establishment_phone\": \"3172657814\",\r\n \"establishment_municipality\": \"687\",\r\n \"establishment_email\": \"\",\r\n \"sendmail\": true,\r\n \"sendmailtome\": true,\r\n \"send_customer_credentials\": false,\r\n \"customer\": {\r\n \"identification_number\": 17348947,\r\n \"dv\": 6,\r\n \"name\": \"WILSON DAZA CASTILLO\",\r\n \"phone\": \"3102156276\",\r\n \"address\": \"CRR 35 A 5 A - 80 SUR\",\r\n \"email\": \"alexanderobndolondono@gmail.com\",\r\n \"merchant_registration\": \"000000\",\r\n \"type_document_identification_id\": 3,\r\n \"type_organization_id\": 2,\r\n \"type_liability_id\": 117,\r\n \"municipality_id\": 687,\r\n \"type_regime_id\": 2\r\n },\r\n \"payment_form\": {\r\n \"payment_form_id\": 1,\r\n \"payment_method_id\": 1,\r\n \"payment_due_date\": \"2025-11-07\",\r\n \"duration_measure\": 0\r\n },\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"4500.00\",\r\n \"percent\": \"5.00\",\r\n \"taxable_amount\": \"90000.000\"\r\n },\r\n {\r\n \"tax_id\": 19,\r\n \"unit_measure_id\": \"70\",\r\n \"tax_amount\": \"10000.00\",\r\n \"taxable_amount\": \"0.00\",\r\n \"percent\": \"0.00\",\r\n \"per_unit_amount\": \"5000.00\",\r\n \"base_unit_measure\": \"2.00\"\r\n }\r\n ],\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"90000.000\",\r\n \"tax_exclusive_amount\": \"90000.000\",\r\n \"tax_inclusive_amount\": \"104500.000\",\r\n \"allowance_total_amount\": \"0.000\",\r\n \"charge_total_amount\": \"0.000\",\r\n \"payable_amount\": \"104500.000\"\r\n },\r\n \"invoice_lines\": [\r\n {\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"4500.00\",\r\n \"percent\": \"5.00\",\r\n \"taxable_amount\": \"90000.000\"\r\n },\r\n {\r\n \"tax_id\": 19,\r\n \"unit_measure_id\": \"70\",\r\n \"tax_amount\": \"10000.00\",\r\n \"taxable_amount\": \"0.00\",\r\n \"percent\": \"0.00\",\r\n \"per_unit_amount\": \"5000.00\",\r\n \"base_unit_measure\": \"2.00\"\r\n }\r\n ],\r\n \"unit_measure_id\": 1076,\r\n \"invoiced_quantity\": \"2.000\",\r\n \"line_extension_amount\": \"90000.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"description\": \"LDM AGUARDIENTE LLANERO EDICION COLEO 750 C.C BOTELLA \",\r\n \"notes\": \"\",\r\n \"code\": \"LDM001002\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"45000.000\",\r\n \"base_quantity\": \"2\"\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "# 🛍️ ENVIAR FACTURA ELECTRÓNICA - CON IMPUESTO A LA BOLSA PLÁSTICA (INCBP)\n\n## 📋 Descripción General\nEndpoint para envío de facturas electrónicas que incluyen el Impuesto Nacional al Consumo de Bolsas Plásticas (INCBP). Aplica cuando se cobran bolsas plásticas en establecimientos comerciales según Ley 1819 de 2016.\n\n## 🔗 URL del Endpoint\n**Síncrono (recomendado):** `POST /api/ubl2.1/invoice`\n**Asíncrono:** `POST /api/ubl2.1/invoice/{testSetId}`\n\n## 🔑 Campos Principales Específicos\n| Campo | Tipo | Descripción |\n|-------|------|-------------|\n| `tax_totals[].tax_id` | integer | **10** = Impuesto Bolsas Plásticas (INCBP) |\n| `tax_totals[].tax_amount` | decimal | Valor total del impuesto ($50 por bolsa en 2025) |\n| `tax_totals[].taxable_amount` | decimal | Base gravable (cantidad de bolsas) |\n| `tax_totals[].percent` | string | Valor unitario del impuesto (ej: \"50.00\") |\n| `tax_totals[].unit_measure_id` | integer | **94** = Unidad (bolsas) |\n\n## 📦 Estructura de INCBP en Invoice Line\n```json\n\"invoice_lines\": [\n {\n \"unit_measure_id\": 70,\n \"invoiced_quantity\": 1.00,\n \"line_extension_amount\": 1000.00,\n \"description\": \"Producto principal\",\n \"code\": \"PROD001\",\n \"price_amount\": 1000.00,\n \"tax_totals\": [\n {\n \"tax_id\": 10,\n \"tax_amount\": 100.00,\n \"taxable_amount\": 2.00,\n \"percent\": \"50.00\",\n \"unit_measure_id\": 94\n },\n {\n \"tax_id\": 1,\n \"tax_amount\": 190.00,\n \"taxable_amount\": 1000.00,\n \"percent\": \"19.00\"\n }\n ]\n }\n]\n```\n\n## 💼 Casos de Uso\n- **Supermercados:** Cobro por bolsas plásticas entregadas\n- **Tiendas Retail:** Comercios que entregan bolsas plásticas\n- **Droguerías:** Farmacias con bolsas plásticas\n- **Comercio General:** Cualquier establecimiento que entregue bolsas\n\n## 💰 Cálculo del Impuesto\n```\nINCBP por factura = Número de bolsas × Valor unitario vigente\n\nEjemplo 2025:\n- 2 bolsas × $50 = $100 INCBP\n- Base gravable (taxable_amount): 2.00\n- Tarifa (percent): \"50.00\"\n- Impuesto (tax_amount): 100.00\n```\n\n## ⚙️ Comportamiento del Sistema\n- **Modo Síncrono:** Validación inmediata del INCBP\n- **Modo Asíncrono:** ZIP_KEY para consulta posterior\n- **XML Generation:** tax_id=10 se incluye en TaxTotal del XML UBL 2.1\n- **Consolidación:** El INCBP se suma al total de impuestos\n- **Validación:** Verifica que percent corresponda al valor vigente\n\n## ✅ Validaciones Críticas\n- Verificación de tax_id = 10 para INCBP\n- Validación de percent según valor vigente ($50 en 2025)\n- Coherencia entre taxable_amount, percent y tax_amount\n- Verificación de unit_measure_id = 94 (unidades)\n- Cálculo correcto: `tax_amount = taxable_amount × percent`\n\n## 💾 Impacto en Base de Datos\n- Tabla `tax_totals`: Registro del INCBP por línea\n- Tabla `documents`: tax_inclusive_amount incluye INCBP\n- Reportes fiscales: Separación de INCBP de otros impuestos\n- Auditoría: Trazabilidad de bolsas plásticas cobradas\n\n## 📤 Respuesta Exitosa (200 - Síncrono)\n```json\n{\n \"success\": true,\n \"message\": \"Factura procesada exitosamente\",\n \"ResponseDian\": {\n \"Envelope\": {\n \"Body\": {\n \"SendBillSyncResponse\": {\n \"SendBillSyncResult\": {\n \"IsValid\": \"true\",\n \"StatusCode\": \"00\",\n \"StatusDescription\": \"Procesado Correctamente\"\n }\n }\n }\n }\n },\n \"cufe\": \"...\",\n \"tax_totals\": [\n {\n \"tax_id\": 10,\n \"tax_amount\": 100.00,\n \"taxable_amount\": 2.00\n }\n ],\n \"pdf_url\": \"storage/pdf/...\"\n}\n```\n\n## ⚠️ Errores Comunes\n- **400:** tax_id incorrecto para INCBP (debe ser 10)\n- **401:** Token de autorización inválido\n- **422:** Valor unitario no corresponde al vigente o cálculo incorrecto de tax_amount\n- **500:** Error interno al procesar INCBP\n\n## 🔐 Autenticación\n```\nAuthorization: Bearer {API_TOKEN}\nContent-Type: application/json\n```\n\n## 💻 Ejemplo cURL\n```bash\ncurl -X POST \"http://midominio.com/api/ubl2.1/invoice\" \\\n -H \"Authorization: Bearer {TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"number\": 990000125,\n \"invoice_lines\": [{\n \"description\": \"Compras varias\",\n \"price_amount\": 1000.00,\n \"tax_totals\": [\n {\n \"tax_id\": 10,\n \"tax_amount\": 100.00,\n \"taxable_amount\": 2.00,\n \"percent\": \"50.00\",\n \"unit_measure_id\": 94\n }\n ]\n }]\n }'\n```\n\n## 📝 Valores Vigentes del INCBP\n- **2017-2019:** $20 por bolsa\n- **2020:** $30 por bolsa\n- **2021:** $40 por bolsa\n- **2022-2025:** $50 por bolsa\n\n## 📌 Notas Importantes\n1. El INCBP es un impuesto nacional obligatorio (Ley 1819/2016)\n2. Se aplica por cada bolsa plástica entregada al consumidor\n3. No aplica sobre bolsas biodegradables o reutilizables\n4. El tax_id = 10 es específico para INCBP en el estándar DIAN\n5. Debe aparecer desglosado en el PDF de representación gráfica\n6. Se reporta separadamente en declaraciones tributarias\n7. El valor unitario se actualiza anualmente por el Gobierno" }, "response": [] }, { "name": "SendInvoice - TestSetId Impuesto Bolsa", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": 990000218,\r\n \"type_document_id\": 1,\r\n \"date\": \"2025-11-07\",\r\n \"time\": \"04:08:12\",\r\n \"resolution_number\": \"18760000001\",\r\n \"prefix\": \"SETP\",\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"sendmail\": true,\r\n \"customer\": {\r\n \"identification_number\": 900166483,\r\n \"dv\": 1,\r\n \"name\": \"INVERSIONES DAVAL SAS\",\r\n \"phone\": \"3103891693\",\r\n \"address\": \"CLL 4 NRO 33-90\",\r\n \"email\": \"alexanderobandolondono@gmail.com\",\r\n \"merchant_registration\": \"0000000-00\",\r\n \"type_document_identification_id\": 6,\r\n \"type_organization_id\": 1,\r\n \"type_liability_id\": 7,\r\n \"municipality_id\": 822,\r\n \"type_regime_id\": 1\r\n },\r\n \"payment_form\": {\r\n \"payment_form_id\": 2,\r\n \"payment_method_id\": 30,\r\n \"payment_due_date\": \"2025-12-07\",\r\n \"duration_measure\": \"30\"\r\n },\r\n \"allowance_charges\": [\r\n {\r\n \"discount_id\": 1,\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"840336.13\"\r\n }\r\n ],\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"840336.13\",\r\n \"tax_exclusive_amount\": \"840336.13\",\r\n \"tax_inclusive_amount\": \"1000500.00\",\r\n \"allowance_total_amount\": \"0.00\",\r\n \"charge_total_amount\": \"0.00\",\r\n \"payable_amount\": \"1000500.00\"\r\n },\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"159663.86\",\r\n \"percent\": \"19\",\r\n \"taxable_amount\": \"840336.13\"\r\n },\r\n {\r\n \"tax_id\": 10,\r\n \"unit_measure_id\": \"70\",\r\n \"tax_amount\": \"500.00\",\r\n \"percent\": \"0\",\r\n \"taxable_amount\": \"500.00\",\r\n \"per_unit_amount\": \"50.00\",\r\n \"base_unit_measure\": \"1.00\"\r\n }\r\n ],\r\n \"invoice_lines\": [\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"840336.13\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"1000000.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"159663.86\",\r\n \"taxable_amount\": \"840336.13\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"COMISION POR SERVICIOS\",\r\n \"code\": \"COMISION\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"840336.13\",\r\n \"base_quantity\": \"1\"\r\n },\r\n {\r\n \"unit_measure_id\": \"70\",\r\n \"invoiced_quantity\": \"10\",\r\n \"line_extension_amount\": \"0.00\",\r\n \"reference_price_id\": 3,\r\n \"free_of_charge_indicator\": true,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"500.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": \"10\",\r\n \"unit_measure_id\": \"70\",\r\n \"tax_amount\": \"500.00\",\r\n \"taxable_amount\": \"0.00\",\r\n \"percent\": \"0.00\",\r\n \"per_unit_amount\": \"50.00\",\r\n \"base_unit_measure\": \"1.00\"\r\n }\r\n ],\r\n \"description\": \"INCBP IMPUESTO NACIONAL AL CONSUMO DE BOLSAS PLASTICAS\",\r\n \"code\": \"BOLSA\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"50.00\",\r\n \"base_quantity\": \"1\"\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "# 🛍️ ENVIAR FACTURA ELECTRÓNICA - CON IMPUESTO A LA BOLSA PLÁSTICA (INCBP)\n\n## 📋 Descripción General\nEndpoint para envío de facturas electrónicas que incluyen el Impuesto Nacional al Consumo de Bolsas Plásticas (INCBP). Aplica cuando se cobran bolsas plásticas en establecimientos comerciales según Ley 1819 de 2016.\n\n## 🔗 URL del Endpoint\n**Síncrono (recomendado):** `POST /api/ubl2.1/invoice`\n**Asíncrono:** `POST /api/ubl2.1/invoice/{testSetId}`\n\n## 🔑 Campos Principales Específicos\n| Campo | Tipo | Descripción |\n|-------|------|-------------|\n| `tax_totals[].tax_id` | integer | **10** = Impuesto Bolsas Plásticas (INCBP) |\n| `tax_totals[].tax_amount` | decimal | Valor total del impuesto ($50 por bolsa en 2025) |\n| `tax_totals[].taxable_amount` | decimal | Base gravable (cantidad de bolsas) |\n| `tax_totals[].percent` | string | Valor unitario del impuesto (ej: \"50.00\") |\n| `tax_totals[].unit_measure_id` | integer | **94** = Unidad (bolsas) |\n\n## 📦 Estructura de INCBP en Invoice Line\n```json\n\"invoice_lines\": [\n {\n \"unit_measure_id\": 70,\n \"invoiced_quantity\": 1.00,\n \"line_extension_amount\": 1000.00,\n \"description\": \"Producto principal\",\n \"code\": \"PROD001\",\n \"price_amount\": 1000.00,\n \"tax_totals\": [\n {\n \"tax_id\": 10,\n \"tax_amount\": 100.00,\n \"taxable_amount\": 2.00,\n \"percent\": \"50.00\",\n \"unit_measure_id\": 94\n },\n {\n \"tax_id\": 1,\n \"tax_amount\": 190.00,\n \"taxable_amount\": 1000.00,\n \"percent\": \"19.00\"\n }\n ]\n }\n]\n```\n\n## 💼 Casos de Uso\n- **Supermercados:** Cobro por bolsas plásticas entregadas\n- **Tiendas Retail:** Comercios que entregan bolsas plásticas\n- **Droguerías:** Farmacias con bolsas plásticas\n- **Comercio General:** Cualquier establecimiento que entregue bolsas\n\n## 💰 Cálculo del Impuesto\n```\nINCBP por factura = Número de bolsas × Valor unitario vigente\n\nEjemplo 2025:\n- 2 bolsas × $50 = $100 INCBP\n- Base gravable (taxable_amount): 2.00\n- Tarifa (percent): \"50.00\"\n- Impuesto (tax_amount): 100.00\n```\n\n## ⚙️ Comportamiento del Sistema\n- **Modo Síncrono:** Validación inmediata del INCBP\n- **Modo Asíncrono:** ZIP_KEY para consulta posterior\n- **XML Generation:** tax_id=10 se incluye en TaxTotal del XML UBL 2.1\n- **Consolidación:** El INCBP se suma al total de impuestos\n- **Validación:** Verifica que percent corresponda al valor vigente\n\n## ✅ Validaciones Críticas\n- Verificación de tax_id = 10 para INCBP\n- Validación de percent según valor vigente ($50 en 2025)\n- Coherencia entre taxable_amount, percent y tax_amount\n- Verificación de unit_measure_id = 94 (unidades)\n- Cálculo correcto: `tax_amount = taxable_amount × percent`\n\n## 💾 Impacto en Base de Datos\n- Tabla `tax_totals`: Registro del INCBP por línea\n- Tabla `documents`: tax_inclusive_amount incluye INCBP\n- Reportes fiscales: Separación de INCBP de otros impuestos\n- Auditoría: Trazabilidad de bolsas plásticas cobradas\n\n## 📤 Respuesta Exitosa (200 - Síncrono)\n```json\n{\n \"success\": true,\n \"message\": \"Factura procesada exitosamente\",\n \"ResponseDian\": {\n \"Envelope\": {\n \"Body\": {\n \"SendBillSyncResponse\": {\n \"SendBillSyncResult\": {\n \"IsValid\": \"true\",\n \"StatusCode\": \"00\",\n \"StatusDescription\": \"Procesado Correctamente\"\n }\n }\n }\n }\n },\n \"cufe\": \"...\",\n \"tax_totals\": [\n {\n \"tax_id\": 10,\n \"tax_amount\": 100.00,\n \"taxable_amount\": 2.00\n }\n ],\n \"pdf_url\": \"storage/pdf/...\"\n}\n```\n\n## ⚠️ Errores Comunes\n- **400:** tax_id incorrecto para INCBP (debe ser 10)\n- **401:** Token de autorización inválido\n- **422:** Valor unitario no corresponde al vigente o cálculo incorrecto de tax_amount\n- **500:** Error interno al procesar INCBP\n\n## 🔐 Autenticación\n```\nAuthorization: Bearer {API_TOKEN}\nContent-Type: application/json\n```\n\n## 💻 Ejemplo cURL\n```bash\ncurl -X POST \"http://midominio.com/api/ubl2.1/invoice\" \\\n -H \"Authorization: Bearer {TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"number\": 990000125,\n \"invoice_lines\": [{\n \"description\": \"Compras varias\",\n \"price_amount\": 1000.00,\n \"tax_totals\": [\n {\n \"tax_id\": 10,\n \"tax_amount\": 100.00,\n \"taxable_amount\": 2.00,\n \"percent\": \"50.00\",\n \"unit_measure_id\": 94\n }\n ]\n }]\n }'\n```\n\n## 📝 Valores Vigentes del INCBP\n- **2017-2019:** $20 por bolsa\n- **2020:** $30 por bolsa\n- **2021:** $40 por bolsa\n- **2022-2025:** $50 por bolsa\n\n## 📌 Notas Importantes\n1. El INCBP es un impuesto nacional obligatorio (Ley 1819/2016)\n2. Se aplica por cada bolsa plástica entregada al consumidor\n3. No aplica sobre bolsas biodegradables o reutilizables\n4. El tax_id = 10 es específico para INCBP en el estándar DIAN\n5. Debe aparecer desglosado en el PDF de representación gráfica\n6. Se reporta separadamente en declaraciones tributarias\n7. El valor unitario se actualiza anualmente por el Gobierno" }, "response": [] }, { "name": "SendCreditNote-TestSetId Varias Lineas", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"billing_reference\": {\r\n\t\t\"number\": \"SETP990000184\",\r\n\t\t\"uuid\": \"7ff5640c3cf343f6a3299a9c9bb01afa9ac370ba38075f06ac3e6a70c1c3dacc1e391f3f5a257c38fbf5c66e005d660d\",\r\n\t\t\"issue_date\": \"2025-10-29\"\r\n },\r\n \"discrepancyresponsecode\": 2,\r\n \"discrepancyresponsedescription\": \"PRUEBA DE MOTIVO NOTA CREDITO\",\r\n \"notes\": \"PRUEBA DE NOTA CREDITO\",\r\n \"resolution_number\": \"0000000000\",\r\n \"prefix\": \"NC\",\r\n \"number\": 19,\r\n \"type_document_id\": 4,\r\n \"date\": \"2025-11-07\",\r\n \"time\": \"10:00:52\",\r\n \"customer\": {\r\n \"identification_number\": 89008003,\r\n \"name\": \"ALEXANDER OBANDO LONDONO\",\r\n \"phone\": \"3103891693\",\r\n \"address\": \"BRR EL CARDAL MZ 4 CS 7 ET 1\",\r\n \"email\": \"alexander_obando@hotmail.com\",\r\n \"merchant_registration\": \"0000-00\",\r\n \"type_document_identification_id\": 3,\r\n \"type_organization_id\": 2,\r\n \"municipality_id\": 149,\r\n \"type_regime_id\": 2\r\n },\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"0.00\",\r\n \"taxable_amount\": \"15000.00\",\r\n \"percent\": \"0.00\"\r\n },\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"3193.28\",\r\n \"taxable_amount\": \"16806.72\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"31806.72\",\r\n \"tax_exclusive_amount\": \"31806.72\",\r\n \"tax_inclusive_amount\": \"35000.00\",\r\n \"allowance_total_amount\": \"0.00\",\r\n \"charge_total_amount\": \"0.00\",\r\n \"payable_amount\": \"35000.00\"\r\n },\r\n \"credit_note_lines\": [\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"10084.03\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"12000.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"1915.97\",\r\n \"taxable_amount\": \"10084.03\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"COMISION POR SERVICIOS\",\r\n \"code\": \"COMISION\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"10084.03\",\r\n \"base_quantity\": \"1\"\r\n },\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"6722.69\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"8000.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"1277.31\",\r\n \"taxable_amount\": \"6722.69\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"BONOS POR SERVICIOS\",\r\n \"code\": \"BONOS\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"6722.69\",\r\n \"base_quantity\": \"1\"\r\n },\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"15000.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"15000.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"0.00\",\r\n \"taxable_amount\": \"15000.00\",\r\n \"percent\": \"0.00\"\r\n }\r\n ],\r\n \"description\": \"CESANTIA MERCANTIL\",\r\n \"code\": \"CESANTIA\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"15000.00\",\r\n \"base_quantity\": \"1\"\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/credit-note", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "credit-note" ] }, "description": "# 📋 ENVIAR FACTURA ELECTRÓNICA - CON VARIAS LÍNEAS DE DETALLE\n\n## 📋 Descripción General\nEndpoint para envío de facturas electrónicas con múltiples líneas de productos o servicios en el array invoice_lines. Permite facturar varios ítems diferentes en un mismo documento electrónico.\n\n## 🔗 URL del Endpoint\n**Síncrono (recomendado):** `POST /api/ubl2.1/invoice`\n**Asíncrono:** `POST /api/ubl2.1/invoice/{testSetId}`\n\n## 🔑 Campos Principales Específicos\n| Campo | Tipo | Descripción |\n|-------|------|-------------|\n| `invoice_lines` | array | Arreglo con múltiples líneas de productos |\n| `invoice_lines[].unit_measure_id` | integer | Unidad de medida por línea |\n| `invoice_lines[].invoiced_quantity` | decimal | Cantidad por línea |\n| `invoice_lines[].line_extension_amount` | decimal | Subtotal por línea (cantidad × precio) |\n| `invoice_lines[].description` | string | Descripción del producto/servicio |\n| `invoice_lines[].code` | string | Código del producto |\n| `invoice_lines[].price_amount` | decimal | Precio unitario |\n| `invoice_lines[].tax_totals` | array | Impuestos específicos por línea |\n\n## 📦 Estructura de Varias Líneas\n```json\n\"invoice_lines\": [\n {\n \"unit_measure_id\": 70,\n \"invoiced_quantity\": 5.00,\n \"line_extension_amount\": 500.00,\n \"description\": \"Producto A\",\n \"code\": \"PROD-A-001\",\n \"price_amount\": 100.00,\n \"tax_totals\": [\n {\"tax_id\": 1, \"tax_amount\": 95.00, \"percent\": \"19.00\"}\n ]\n },\n {\n \"unit_measure_id\": 70,\n \"invoiced_quantity\": 3.00,\n \"line_extension_amount\": 300.00,\n \"description\": \"Producto B\",\n \"code\": \"PROD-B-002\",\n \"price_amount\": 100.00,\n \"tax_totals\": [\n {\"tax_id\": 1, \"tax_amount\": 57.00, \"percent\": \"19.00\"}\n ]\n },\n {\n \"unit_measure_id\": 70,\n \"invoiced_quantity\": 2.00,\n \"line_extension_amount\": 200.00,\n \"description\": \"Producto C\",\n \"code\": \"PROD-C-003\",\n \"price_amount\": 100.00,\n \"tax_totals\": [\n {\"tax_id\": 1, \"tax_amount\": 38.00, \"percent\": \"19.00\"}\n ]\n }\n]\n```\n\n## 💼 Casos de Uso\n- **Comercio Retail:** Múltiples productos en una venta\n- **Restaurantes:** Varios platos y bebidas en una cuenta\n- **Supermercados:** Compras con múltiples artículos\n- **Servicios:** Múltiples conceptos en una factura\n- **E-commerce:** Órdenes con varios ítems\n\n## 💰 Cálculo de Totales\n```\nSubtotal = Σ line_extension_amount de todas las líneas\nImpuestos = Σ tax_amount de todas las líneas\nTotal = Subtotal + Impuestos\n\nEjemplo:\nLínea 1: $500.00 + IVA $95.00 = $595.00\nLínea 2: $300.00 + IVA $57.00 = $357.00\nLínea 3: $200.00 + IVA $38.00 = $238.00\n----------------------------------------\nTotal Factura: $1,190.00\n```\n\n## ⚙️ Comportamiento del Sistema\n- **Modo Síncrono:** Validación inmediata de todas las líneas\n- **Modo Asíncrono:** ZIP_KEY para consulta posterior\n- **XML Generation:** Cada línea se serializa en InvoiceLine del XML UBL 2.1\n- **Consolidación:** Los impuestos se totalizan por tax_id\n- **Validación:** Verifica coherencia de cálculos en cada línea\n\n## ✅ Validaciones Críticas\n- Validación de que invoice_lines sea un array no vacío\n- Verificación de cálculo por línea: `line_extension_amount = invoiced_quantity × price_amount`\n- Validación de impuestos por línea\n- Coherencia entre subtotales y total de la factura\n- Verificación de códigos de producto únicos (si aplica)\n- Límite máximo de líneas según configuración (típicamente 1000)\n\n## 💾 Impacto en Base de Datos\n- Tabla `invoice_lines`: Un registro por cada línea\n- Tabla `tax_totals`: Impuestos consolidados por línea\n- Tabla `documents`: Totales consolidados de la factura\n- Índices por code y description para búsquedas\n\n## 📤 Respuesta Exitosa (200 - Síncrono)\n```json\n{\n \"success\": true,\n \"message\": \"Factura procesada exitosamente\",\n \"ResponseDian\": {\n \"Envelope\": {\n \"Body\": {\n \"SendBillSyncResponse\": {\n \"SendBillSyncResult\": {\n \"IsValid\": \"true\",\n \"StatusCode\": \"00\",\n \"StatusDescription\": \"Procesado Correctamente\"\n }\n }\n }\n }\n },\n \"cufe\": \"...\",\n \"invoice_lines_count\": 3,\n \"line_extension_amount\": 1000.00,\n \"tax_exclusive_amount\": 1000.00,\n \"tax_inclusive_amount\": 1190.00,\n \"payable_amount\": 1190.00,\n \"pdf_url\": \"storage/pdf/...\"\n}\n```\n\n## ⚠️ Errores Comunes\n- **400:** invoice_lines vacío o no es un array\n- **401:** Token de autorización inválido\n- **422:** Error de cálculo en line_extension_amount o impuestos por línea, códigos de producto duplicados\n- **500:** Error interno al procesar múltiples líneas\n\n## 🔐 Autenticación\n```\nAuthorization: Bearer {API_TOKEN}\nContent-Type: application/json\n```\n\n## 💻 Ejemplo cURL\n```bash\ncurl -X POST \"http://midominio.com/api/ubl2.1/invoice\" \\\n -H \"Authorization: Bearer {TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"number\": 990000126,\n \"invoice_lines\": [\n {\"invoiced_quantity\": 5, \"price_amount\": 100, \"description\": \"Producto A\"},\n {\"invoiced_quantity\": 3, \"price_amount\": 100, \"description\": \"Producto B\"},\n {\"invoiced_quantity\": 2, \"price_amount\": 100, \"description\": \"Producto C\"}\n ],\n \"customer\": {...}\n }'\n```\n\n## 📌 Notas Importantes\n1. No hay límite mínimo de líneas (puede ser 1 o más)\n2. Cada línea puede tener diferentes impuestos y tarifas\n3. Los códigos de producto ayudan a la trazabilidad\n4. El PDF muestra todas las líneas en formato tabla\n5. Útil para integración con sistemas POS o ERP\n6. Cada línea puede tener descuentos individuales (allowance_charges)\n7. El sistema consolida automáticamente los impuestos por tipo" }, "response": [] }, { "name": "SendInvoice-TestSetId Allowance A Credito", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": 990000219,\r\n \"type_document_id\": 1,\r\n \"date\": \"2025-11-07\",\r\n \"time\": \"04:36:32\",\r\n \"resolution_number\": \"18760000001\",\r\n \"prefix\": \"SETP\",\r\n \"customer\": {\r\n \"identification_number\": 89008003,\r\n \"name\": \"ALEXANDER OBANDO LONDONO\",\r\n \"phone\": \"3103891693\",\r\n \"address\": \"BRR LIMONAR MZ 6 CS 3 ET 1\",\r\n \"email\": \"alexander_obando@hotmail.com\",\r\n \"merchant_registration\": \"0000-00\",\r\n \"type_document_identification_id\": 3,\r\n \"type_organization_id\": 2,\r\n \"municipality_id\": 149,\r\n \"type_regime_id\": 2\r\n },\r\n \"payment_form\": {\r\n \"payment_form_id\": 2,\r\n \"payment_method_id\": 10,\r\n \"payment_due_date\": \"2025-11-07\",\r\n \"duration_measure\": \"30\"\r\n },\r\n \"allowance_charges\": [\r\n {\r\n \"discount_id\": 1,\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"600.00\",\r\n \"base_amount\": \"8067.23\"\r\n }\r\n ],\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"8067.23\",\r\n \"tax_exclusive_amount\": \"8067.23\",\r\n \"tax_inclusive_amount\": \"9600.00\",\r\n \"allowance_total_amount\": \"600.00\",\r\n \"charge_total_amount\": \"0.00\",\r\n \"payable_amount\": \"9000.00\"\r\n },\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"1532.77\",\r\n \"percent\": \"19\",\r\n \"taxable_amount\": \"8067.23\"\r\n }\r\n ],\r\n \"invoice_lines\": [\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"8\",\r\n \"line_extension_amount\": \"8067.23\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"600.00\",\r\n \"base_amount\": \"9600.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"1532.77\",\r\n \"taxable_amount\": \"8067.23\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"MANZANA\",\r\n \"code\": \"MANZANA\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"1083.40\",\r\n \"base_quantity\": \"8\"\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "# 💳 ENVIAR FACTURA ELECTRÓNICA - CON PAGO A CRÉDITO Y DESCUENTO\n\n## 📋 Descripción General\nEndpoint para envío de facturas electrónicas con pago a crédito (payment_means_type = 2) y descuentos aplicados mediante allowance_charges. Permite facturar con condiciones de pago diferido y aplicar descuentos comerciales.\n\n## 🔗 URL del Endpoint\n**Síncrono (recomendado):** `POST /api/ubl2.1/invoice`\n**Asíncrono:** `POST /api/ubl2.1/invoice/{testSetId}`\n\n## 🔑 Campos Principales Específicos\n| Campo | Tipo | Descripción |\n|-------|------|-------------|\n| `type_document_id` | integer | **1** = Factura de Venta |\n| `payment_means_type` | integer | **2** = Pago a Crédito |\n| `payment_due_date` | date | Fecha límite de pago (YYYY-MM-DD) |\n| `allowance_charges` | array | Descuentos globales de la factura |\n| `allowance_charges[].charge_indicator` | boolean | **false** = Descuento |\n| `allowance_charges[].allowance_charge_reason` | string | Motivo del descuento |\n| `allowance_charges[].amount` | decimal | Valor del descuento |\n| `allowance_charges[].base_amount` | decimal | Subtotal sobre el que aplica |\n\n## 📦 Estructura de Crédito y Descuento\n```json\n{\n \"type_document_id\": 1,\n \"payment_means_type\": 2,\n \"payment_due_date\": \"2025-12-20\",\n \"allowance_charges\": [\n {\n \"charge_indicator\": false,\n \"allowance_charge_reason\": \"Descuento comercial\",\n \"amount\": 100.00,\n \"base_amount\": 1000.00\n }\n ],\n \"invoice_lines\": [...]\n}\n```\n\n## 💼 Casos de Uso\n- **B2B:** Ventas a empresas con plazos de pago (30, 60, 90 días)\n- **Distribuidores:** Descuentos por volumen con pago diferido\n- **Mayoristas:** Condiciones comerciales especiales\n- **Contratos:** Facturación con términos de crédito acordados\n\n## 💰 Cálculo de Totales con Descuento\n```\nSubtotal = Σ line_extension_amount\nDescuento = Valor en allowance_charges (charge_indicator = false)\nBase Gravable = Subtotal - Descuento\nImpuestos = Base Gravable × Tarifa IVA\nTotal = Base Gravable + Impuestos\n\nEjemplo:\nSubtotal: $1,000.00\nDescuento 10%: -$100.00\nBase Gravable: $900.00\nIVA 19%: $171.00\nTotal a Pagar: $1,071.00\n```\n\n## 📅 Tipos de Pago (payment_means_type)\n- **1:** Contado\n- **2:** Crédito (requiere payment_due_date)\n- **10:** Efectivo\n- **42:** Consignación\n- **48:** Tarjeta de crédito\n- **49:** Tarjeta débito\n\n## ⚙️ Comportamiento del Sistema\n- **Modo Síncrono:** Validación inmediata de crédito y descuentos\n- **Modo Asíncrono:** ZIP_KEY para consulta posterior\n- **XML Generation:** PaymentMeans y AllowanceCharge en XML UBL 2.1\n- **Validación:** Verifica payment_due_date >= document.date\n- **Descuentos:** Se aplican antes de calcular impuestos\n\n## ✅ Validaciones Críticas\n- Validación de payment_means_type = 2 para crédito\n- Verificación de payment_due_date obligatorio para crédito\n- Validación de que payment_due_date sea igual o posterior a document.date\n- Coherencia entre base_amount y amount en allowance_charges\n- Verificación de charge_indicator = false para descuentos\n- Cálculo correcto de impuestos sobre base gravable (después de descuentos)\n\n## 💾 Impacto en Base de Datos\n- Tabla `documents`: payment_means_type, payment_due_date\n- Tabla `allowance_charges`: Registro de descuentos\n- Tabla `accounts_receivable`: Saldo por cobrar\n- Alertas de cartera: Seguimiento de vencimientos\n\n## 📤 Respuesta Exitosa (200 - Síncrono)\n```json\n{\n \"success\": true,\n \"message\": \"Factura procesada exitosamente\",\n \"ResponseDian\": {\n \"Envelope\": {\n \"Body\": {\n \"SendBillSyncResponse\": {\n \"SendBillSyncResult\": {\n \"IsValid\": \"true\",\n \"StatusCode\": \"00\",\n \"StatusDescription\": \"Procesado Correctamente\"\n }\n }\n }\n }\n },\n \"cufe\": \"...\",\n \"payment_means_type\": 2,\n \"payment_due_date\": \"2025-12-20\",\n \"allowance_total\": 100.00,\n \"line_extension_amount\": 1000.00,\n \"tax_exclusive_amount\": 900.00,\n \"payable_amount\": 1071.00,\n \"pdf_url\": \"storage/pdf/...\"\n}\n```\n\n## ⚠️ Errores Comunes\n- **400:** payment_means_type inválido\n- **401:** Token de autorización inválido\n- **422:** payment_due_date faltante o anterior a document.date, charge_indicator incorrecto para descuentos, cálculo de descuento incorrecto\n- **500:** Error interno al procesar crédito y descuentos\n\n## 🔐 Autenticación\n```\nAuthorization: Bearer {API_TOKEN}\nContent-Type: application/json\n```\n\n## 💻 Ejemplo cURL\n```bash\ncurl -X POST \"http://midominio.com/api/ubl2.1/invoice\" \\\n -H \"Authorization: Bearer {TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"number\": 990000127,\n \"payment_means_type\": 2,\n \"payment_due_date\": \"2025-12-20\",\n \"allowance_charges\": [\n {\n \"charge_indicator\": false,\n \"allowance_charge_reason\": \"Descuento 10%\",\n \"amount\": 100.00,\n \"base_amount\": 1000.00\n }\n ],\n \"invoice_lines\": [...],\n \"customer\": {...}\n }'\n```\n\n## 📌 Notas Importantes\n1. payment_due_date es obligatorio cuando payment_means_type = 2\n2. Los descuentos (allowance) reducen la base gravable antes de impuestos\n3. charge_indicator = false para descuentos, true para cargos adicionales\n4. El PDF muestra claramente el plazo de pago y descuentos\n5. Útil para gestión de cartera y cuentas por cobrar\n6. Pueden combinarse múltiples descuentos en el array allowance_charges\n7. El sistema genera alertas automáticas de vencimiento" }, "response": [] }, { "name": "SendInvoice-TestSetId Allowance Dos Invoice Lines", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": 990000220,\r\n \"type_document_id\": 1,\r\n \"date\": \"2025-11-07\",\r\n \"time\": \"21:19:42\",\r\n \"resolution_number\": \"18760000001\",\r\n \"prefix\": \"SETP\",\r\n \"customer\": {\r\n \"identification_number\": 89008003,\r\n \"name\": \"ALEXANDER OBANDO LONDONO\",\r\n \"phone\": \"3103891693\",\r\n \"address\": \"BRR LIMONAR MZ 6 CS 3 ET 1\",\r\n \"email\": \"alexander_obando@hotmail.com\",\r\n \"merchant_registration\": \"0000-00\",\r\n \"type_document_identification_id\": 3,\r\n \"type_organization_id\": 2,\r\n \"municipality_id\": 149,\r\n \"type_regime_id\": 2\r\n },\r\n \"payment_form\": {\r\n \"payment_form_id\": 1,\r\n \"payment_method_id\": 10,\r\n \"payment_due_date\": \"2025-11-07\",\r\n \"duration_measure\": \"0\"\r\n },\r\n \"allowance_charges\": [\r\n {\r\n \"discount_id\": 1,\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"230000.00\",\r\n \"base_amount\": \"9663865.54\"\r\n }\r\n ],\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"9663865.54\",\r\n \"tax_exclusive_amount\": \"9663865.55\",\r\n \"tax_inclusive_amount\": \"11500000.00\",\r\n \"allowance_total_amount\": \"230000.00\",\r\n \"charge_total_amount\": \"0.00\",\r\n \"payable_amount\": \"11270000.00\"\r\n },\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"1836134.45\",\r\n \"percent\": \"19\",\r\n \"taxable_amount\": \"9663865.55\"\r\n }\r\n ],\r\n \"invoice_lines\": [\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"1260504.20\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"30000.00\",\r\n \"base_amount\": \"1500000.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"239495.80\",\r\n \"taxable_amount\": \"1260504.20\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"BONOS POR SERVICIOS\",\r\n \"code\": \"BONOS\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"1290504.20\",\r\n \"base_quantity\": \"1\"\r\n },\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"8403361.34\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"200000.00\",\r\n \"base_amount\": \"10000000.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"1596638.65\",\r\n \"taxable_amount\": \"8403361.34\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"COMISION POR SERVICIOS\",\r\n \"code\": \"COMISION\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"8603361.34\",\r\n \"base_quantity\": \"1\"\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "# 📋💰 ENVIAR FACTURA ELECTRÓNICA - DOS LÍNEAS CON DESCUENTO\n\n## 📋 Descripción General\nEndpoint para envío de facturas electrónicas con dos líneas de detalle y descuento global aplicado mediante allowance_charges. Combina múltiples productos con descuentos comerciales.\n\n## 🔗 URL del Endpoint\n**Síncrono (recomendado):** `POST /api/ubl2.1/invoice`\n**Asíncrono:** `POST /api/ubl2.1/invoice/{testSetId}`\n\n## 🔑 Campos Principales Específicos\n| Campo | Tipo | Descripción |\n|-------|------|-------------|\n| `invoice_lines` | array | Dos o más líneas de productos |\n| `allowance_charges` | array | Descuentos globales aplicados |\n| `allowance_charges[].charge_indicator` | boolean | **false** = Descuento |\n| `allowance_charges[].amount` | decimal | Valor del descuento |\n| `allowance_charges[].base_amount` | decimal | Subtotal sobre el que aplica |\n\n## 📦 Estructura de Dos Líneas + Descuento\n```json\n{\n \"invoice_lines\": [\n {\n \"invoiced_quantity\": 10.00,\n \"line_extension_amount\": 1000.00,\n \"description\": \"Producto A\",\n \"code\": \"PROD-A-001\",\n \"price_amount\": 100.00,\n \"tax_totals\": [\n {\"tax_id\": 1, \"percent\": \"19.00\", \"tax_amount\": 190.00}\n ]\n },\n {\n \"invoiced_quantity\": 5.00,\n \"line_extension_amount\": 500.00,\n \"description\": \"Producto B\",\n \"code\": \"PROD-B-002\",\n \"price_amount\": 100.00,\n \"tax_totals\": [\n {\"tax_id\": 1, \"percent\": \"19.00\", \"tax_amount\": 95.00}\n ]\n }\n ],\n \"allowance_charges\": [\n {\n \"charge_indicator\": false,\n \"allowance_charge_reason\": \"Descuento por volumen\",\n \"amount\": 150.00,\n \"base_amount\": 1500.00\n }\n ]\n}\n```\n\n## 💰 Cálculo de Totales\n```\nLínea 1: 10 × $100 = $1,000.00\nLínea 2: 5 × $100 = $500.00\nSubtotal: $1,500.00\n\nDescuento 10%: -$150.00\nBase Gravable: $1,350.00\n\nIVA 19% sobre $1,350: $256.50\nTotal a Pagar: $1,606.50\n```\n\n## 💼 Casos de Uso\n- **Retail:** Promociones de \"compra 2 y obtén descuento\"\n- **Mayoristas:** Descuentos por volumen en múltiples productos\n- **E-commerce:** Cupones de descuento aplicados al carrito\n- **B2B:** Descuentos comerciales en órdenes mixtas\n\n## ⚙️ Comportamiento del Sistema\n- **Modo Síncrono:** Validación inmediata de líneas y descuentos\n- **Modo Asíncrono:** ZIP_KEY para consulta posterior\n- **XML Generation:** Múltiples InvoiceLines y AllowanceCharge en XML UBL 2.1\n- **Consolidación:** Impuestos se calculan sobre base gravable (después de descuento)\n- **Validación:** Verifica coherencia entre subtotales, descuentos e impuestos\n\n## ✅ Validaciones Críticas\n- Validación de que invoice_lines tenga al menos 2 elementos\n- Verificación de cálculo por línea: `line_extension_amount = invoiced_quantity × price_amount`\n- Validación de que base_amount en allowance_charges = Σ line_extension_amount\n- Coherencia de impuestos: se calculan sobre (Subtotal - Descuento)\n- Verificación de charge_indicator = false para descuentos\n\n## 💾 Impacto en Base de Datos\n- Tabla `invoice_lines`: Dos registros (uno por línea)\n- Tabla `allowance_charges`: Registro del descuento global\n- Tabla `tax_totals`: Impuestos consolidados por línea\n- Tabla `documents`: Totales finales de la factura\n\n## 📤 Respuesta Exitosa (200 - Síncrono)\n```json\n{\n \"success\": true,\n \"message\": \"Factura procesada exitosamente\",\n \"ResponseDian\": {\n \"Envelope\": {\n \"Body\": {\n \"SendBillSyncResponse\": {\n \"SendBillSyncResult\": {\n \"IsValid\": \"true\",\n \"StatusCode\": \"00\",\n \"StatusDescription\": \"Procesado Correctamente\"\n }\n }\n }\n }\n },\n \"cufe\": \"...\",\n \"invoice_lines_count\": 2,\n \"line_extension_amount\": 1500.00,\n \"allowance_total\": 150.00,\n \"tax_exclusive_amount\": 1350.00,\n \"tax_inclusive_amount\": 1606.50,\n \"payable_amount\": 1606.50,\n \"pdf_url\": \"storage/pdf/...\"\n}\n```\n\n## ⚠️ Errores Comunes\n- **400:** invoice_lines con menos de 2 elementos\n- **401:** Token de autorización inválido\n- **422:** Descuento excede subtotal, base_amount no coincide con Σ line_extension_amount, cálculo de impuestos incorrecto\n- **500:** Error interno al procesar líneas múltiples con descuento\n\n## 🔐 Autenticación\n```\nAuthorization: Bearer {API_TOKEN}\nContent-Type: application/json\n```\n\n## 💻 Ejemplo cURL\n```bash\ncurl -X POST \"http://midominio.com/api/ubl2.1/invoice\" \\\n -H \"Authorization: Bearer {TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"number\": 990000128,\n \"invoice_lines\": [\n {\"invoiced_quantity\": 10, \"price_amount\": 100, \"description\": \"Producto A\"},\n {\"invoiced_quantity\": 5, \"price_amount\": 100, \"description\": \"Producto B\"}\n ],\n \"allowance_charges\": [\n {\"charge_indicator\": false, \"amount\": 150, \"base_amount\": 1500}\n ],\n \"customer\": {...}\n }'\n```\n\n## 📌 Notas Importantes\n1. El descuento global se aplica proporcionalmente sobre todas las líneas\n2. Los impuestos se calculan DESPUÉS de aplicar el descuento\n3. Cada línea puede tener diferentes impuestos y tarifas\n4. El PDF muestra claramente el desglose de líneas y descuento\n5. Útil para promociones comerciales con múltiples productos\n6. Pueden combinarse descuentos por línea y descuentos globales\n7. El allowance_charge_reason aparece en el PDF explicativo" }, "response": [] }, { "name": "SendInvoicePrepaidPayment-TestSetId", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": 990000221,\r\n \"type_document_id\": 1,\r\n \"date\": \"2025-11-07\",\r\n \"time\": \"06:08:12\",\r\n \"resolution_number\": \"18760000001\",\r\n \"prefix\": \"SETP\",\r\n \"customer\": {\r\n \"identification_number\": 89008003,\r\n \"name\": \"ALEXANDER OBANDO LONDONO\",\r\n \"phone\": \"3103891693\",\r\n \"address\": \"BRR LIMONAR MZ 6 CS 3 ET 1\",\r\n \"email\": \"alexander_obando@hotmail.com\",\r\n \"merchant_registration\": \"0000-00\",\r\n \"type_document_identification_id\": 3,\r\n \"type_organization_id\": 2,\r\n \"municipality_id\": 149,\r\n \"type_regime_id\": 2\r\n },\r\n \"payment_form\": {\r\n \"payment_form_id\": 1,\r\n \"payment_method_id\": 10,\r\n \"payment_due_date\": \"2025-11-07\",\r\n \"duration_measure\": \"0\"\r\n },\r\n \"prepaid_payment\": {\r\n \"idpayment\": \"A3123856\",\r\n \"paidamount\": \"100000.00\",\r\n \"receiveddate\": \"2020-03-01\",\r\n \"paiddate\": \"2020-03-05\",\r\n \"instructionid\": \"PRUEBA DE PREPAGO RECIBIDO\"\r\n },\r\n \"allowance_charges\": [\r\n {\r\n \"discount_id\": 1,\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"840336.13\"\r\n }\r\n ],\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"840336.13\",\r\n \"tax_exclusive_amount\": \"840336.13\",\r\n \"tax_inclusive_amount\": \"1000000.00\",\r\n \"allowance_total_amount\": \"0.00\",\r\n \"charge_total_amount\": \"0.00\",\r\n \"pre_paid_amount\": \"100000.00\",\r\n \"payable_amount\": \"1000000.00\"\r\n },\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"159663.86\",\r\n \"percent\": \"19\",\r\n \"taxable_amount\": \"840336.13\"\r\n }\r\n ],\r\n \"invoice_lines\": [\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"840336.13\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"1000000.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"159663.86\",\r\n \"taxable_amount\": \"840336.13\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"COMISION POR SERVICIOS\",\r\n \"code\": \"COMISION\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"840336.13\",\r\n \"base_quantity\": \"1\"\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "# 💳 ENVIAR FACTURA ELECTRÓNICA - CON PREPAGO / ANTICIPO\n\n## 📋 Descripción General\nEndpoint para envío de facturas electrónicas que registran prepagos o anticipos realizados previamente. Permite descontar pagos adelantados del total a pagar mediante el objeto prepaid_payment.\n\n## 🔗 URL del Endpoint\n**Síncrono (recomendado):** `POST /api/ubl2.1/invoice`\n**Asíncrono:** `POST /api/ubl2.1/invoice/{testSetId}`\n\n## 🔑 Campos Principales Específicos\n| Campo | Tipo | Descripción |\n|-------|------|-------------|\n| `prepaid_payment` | object | Datos del prepago realizado |\n| `prepaid_payment.id` | string | Identificador del prepago/anticipo |\n| `prepaid_payment.paid_amount` | decimal | Valor pagado anticipadamente |\n| `prepaid_payment.received_date` | date | Fecha de recepción del prepago (YYYY-MM-DD) |\n| `prepaid_payment.paid_date` | date | Fecha en que se realizó el pago (YYYY-MM-DD) |\n| `prepaid_payment.instruction_id` | string | Referencia de la transacción bancaria |\n\n## 📦 Estructura de Prepaid Payment\n```json\n{\n \"prepaid_payment\": {\n \"id\": \"ANTICIPO-2025-001\",\n \"paid_amount\": 500.00,\n \"received_date\": \"2025-11-10\",\n \"paid_date\": \"2025-11-10\",\n \"instruction_id\": \"TRX-123456789\"\n },\n \"invoice_lines\": [...]\n}\n```\n\n## 💰 Cálculo con Prepago\n```\nSubtotal: $1,000.00\nIVA 19%: $190.00\nTotal Factura: $1,190.00\n\nPrepago Realizado: -$500.00\n--------------------------------\nSaldo a Pagar: $690.00\n```\n\n## 💼 Casos de Uso\n- **Construcción:** Anticipos en contratos de obra\n- **Proyectos:** Pagos adelantados en servicios profesionales\n- **Importaciones:** Anticipos para importación de mercancías\n- **Reservas:** Pagos adelantados de servicios turísticos\n- **Suscripciones:** Prepagos de servicios recurrentes\n\n## ⚙️ Comportamiento del Sistema\n- **Modo Síncrono:** Validación inmediata del prepago\n- **Modo Asíncrono:** ZIP_KEY para consulta posterior\n- **XML Generation:** PrepaidPayment se incluye en el XML UBL 2.1\n- **Cálculo:** El saldo a pagar = Total Factura - Prepago\n- **Validación:** Verifica que paid_amount no exceda el total de la factura\n\n## ✅ Validaciones Críticas\n- Validación de que paid_amount sea menor o igual al payable_amount\n- Verificación de formato de fechas (YYYY-MM-DD)\n- Validación de que received_date y paid_date sean iguales o anteriores a document.date\n- Coherencia entre instruction_id y registros bancarios\n- Verificación de id único del prepago\n\n## 💾 Impacto en Base de Datos\n- Tabla `prepaid_payments`: Registro del anticipo\n- Tabla `documents`: payable_amount refleja saldo pendiente\n- Tabla `payment_transactions`: Vinculación con transacción bancaria\n- Tabla `accounts_receivable`: Actualización de saldo por cobrar\n\n## 📤 Respuesta Exitosa (200 - Síncrono)\n```json\n{\n \"success\": true,\n \"message\": \"Factura procesada exitosamente\",\n \"ResponseDian\": {\n \"Envelope\": {\n \"Body\": {\n \"SendBillSyncResponse\": {\n \"SendBillSyncResult\": {\n \"IsValid\": \"true\",\n \"StatusCode\": \"00\",\n \"StatusDescription\": \"Procesado Correctamente\"\n }\n }\n }\n }\n },\n \"cufe\": \"...\",\n \"prepaid_payment\": {\n \"id\": \"ANTICIPO-2025-001\",\n \"paid_amount\": 500.00,\n \"received_date\": \"2025-11-10\"\n },\n \"line_extension_amount\": 1000.00,\n \"tax_inclusive_amount\": 1190.00,\n \"payable_amount\": 690.00,\n \"pdf_url\": \"storage/pdf/...\"\n}\n```\n\n## ⚠️ Errores Comunes\n- **400:** Formato de fecha inválido en prepaid_payment\n- **401:** Token de autorización inválido\n- **422:** paid_amount excede payable_amount, fechas futuras en prepago, id de prepago duplicado\n- **500:** Error interno al procesar prepago\n\n## 🔐 Autenticación\n```\nAuthorization: Bearer {API_TOKEN}\nContent-Type: application/json\n```\n\n## 💻 Ejemplo cURL\n```bash\ncurl -X POST \"http://midominio.com/api/ubl2.1/invoice\" \\\n -H \"Authorization: Bearer {TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"number\": 990000129,\n \"prepaid_payment\": {\n \"id\": \"ANTICIPO-2025-001\",\n \"paid_amount\": 500.00,\n \"received_date\": \"2025-11-10\",\n \"paid_date\": \"2025-11-10\",\n \"instruction_id\": \"TRX-123456789\"\n },\n \"invoice_lines\": [...],\n \"customer\": {...}\n }'\n```\n\n## 📝 Campos Relacionados\n- **payment_means_type:** Forma de pago del saldo restante\n- **payment_due_date:** Fecha límite para el saldo pendiente\n- **legal_monetary_totals.payable_amount:** Total a pagar (incluye deducción de prepago)\n\n## 📌 Notas Importantes\n1. El prepago se descuenta del total a pagar de la factura\n2. El PDF muestra claramente el prepago y el saldo pendiente\n3. Útil para trazabilidad de anticipos y pagos parciales\n4. El instruction_id vincula con comprobantes bancarios\n5. Puede combinarse con payment_means_type para el saldo restante\n6. El XML incluye PrepaidPayment en el esquema UBL 2.1\n7. Facilita auditorías y conciliación de anticipos" }, "response": [] }, { "name": "SendInvoice-TestSetId Charge", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": 990000222,\r\n \"type_document_id\": 1,\r\n \"date\": \"2025-11-07\",\r\n \"time\": \"20:20:24\",\r\n \"resolution_number\": \"18760000001\",\r\n \"prefix\": \"SETP\",\r\n \"customer\": {\r\n \"identification_number\": 89008003,\r\n \"name\": \"ALEXANDER OBANDO LONDONO\",\r\n \"phone\": \"3103891693\",\r\n \"address\": \"BRR EL CARDAL MZ 4 CS 7 ET 1\",\r\n \"email\": \"alexander_obando@hotmail.com\",\r\n \"merchant_registration\": \"0000-00\",\r\n \"type_document_identification_id\": 3,\r\n \"type_organization_id\": 2,\r\n \"municipality_id\": 149,\r\n \"type_regime_id\": 2\r\n },\r\n \"payment_form\": {\r\n \"payment_form_id\": 1,\r\n \"payment_method_id\": 10,\r\n \"payment_due_date\": \"2025-11-07\",\r\n \"duration_measure\": \"0\"\r\n },\r\n \"allowance_charges\": [\r\n {\r\n \"discount_id\": 1,\r\n \"charge_indicator\": true,\r\n \"allowance_charge_reason\": \"CARGO POR CONSIGNACION BANCARIA\",\r\n \"amount\": \"7000.00\",\r\n \"base_amount\": \"300000.00\"\r\n }\r\n ],\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"300000.00\",\r\n \"tax_exclusive_amount\": \"300000.00\",\r\n \"tax_inclusive_amount\": \"357000.00\",\r\n \"allowance_total_amount\": \"0.00\",\r\n \"charge_total_amount\": \"7000.00\",\r\n \"payable_amount\": \"364000.00\"\r\n },\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"57000.00\",\r\n \"percent\": \"19\",\r\n \"taxable_amount\": \"300000.00\"\r\n }\r\n ],\r\n \"invoice_lines\": [\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"300000.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": true,\r\n \"allowance_charge_reason\": \"CARGO POR CONSIGNACION BANCARIA\",\r\n \"amount\": \"7000.00\",\r\n \"base_amount\": \"357000.00\",\r\n \"multiplier_factor_numeric\": \"1.96\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"57000.00\",\r\n \"taxable_amount\": \"300000.00\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"COMISION POR SERVICIOS\",\r\n \"code\": \"COMISION\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"293000.00\",\r\n \"base_quantity\": \"1\"\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "# 💵 ENVIAR FACTURA ELECTRÓNICA - CON CARGOS ADICIONALES\n\n## 📋 Descripción General\nEndpoint para envío de facturas electrónicas que incluyen cargos adicionales (charges) mediante allowance_charges con charge_indicator=true. Permite agregar conceptos como recargos bancarios, costos de envío, manejo, etc.\n\n## 🔗 URL del Endpoint\n**Síncrono (recomendado):** `POST /api/ubl2.1/invoice`\n**Asíncrono:** `POST /api/ubl2.1/invoice/{testSetId}`\n\n## 🔑 Campos Principales Específicos\n| Campo | Tipo | Descripción |\n|-------|------|-------------|\n| `allowance_charges` | array | Cargos adicionales aplicados |\n| `allowance_charges[].charge_indicator` | boolean | **true** = Cargo (false = Descuento) |\n| `allowance_charges[].allowance_charge_reason` | string | Motivo del cargo |\n| `allowance_charges[].amount` | decimal | Valor del cargo adicional |\n| `allowance_charges[].base_amount` | decimal | Subtotal sobre el que se calcula |\n\n## 📦 Estructura de Cargos\n```json\n{\n \"invoice_lines\": [...],\n \"allowance_charges\": [\n {\n \"charge_indicator\": true,\n \"allowance_charge_reason\": \"Cargo por consignación bancaria\",\n \"amount\": 5000.00,\n \"base_amount\": 100000.00\n }\n ]\n}\n```\n\n## 💰 Cálculo con Cargos\n```\nSubtotal: $100,000.00\nCargo Consignación: +$5,000.00\nBase Gravable: $105,000.00\nIVA 19%: $19,950.00\n----------------------------------\nTotal a Pagar: $124,950.00\n```\n\n## 💼 Casos de Uso y Tipos de Cargos\n- **Financieros:** Cargo por consignación, recargo por tarjeta\n- **Logísticos:** Cargo por envío, manejo, empaque\n- **Administrativos:** Cargo por procesamiento, servicio\n- **Seguridad:** Cargo por seguro, transporte valores\n- **Intereses:** Recargo por mora, financiación\n\n## ⚙️ Comportamiento del Sistema\n- **Modo Síncrono:** Validación inmediata de cargos\n- **Modo Asíncrono:** ZIP_KEY para consulta posterior\n- **XML Generation:** AllowanceCharge con ChargeIndicator=true en XML UBL 2.1\n- **Cálculo:** Los cargos incrementan la base gravable ANTES de impuestos\n- **Validación:** Verifica charge_indicator = true y coherencia de montos\n\n## ✅ Validaciones Críticas\n- Validación de charge_indicator = true para cargos\n- Verificación de allowance_charge_reason obligatorio\n- Coherencia entre amount y base_amount\n- Validación de que amount sea positivo\n- Impuestos se calculan sobre (Subtotal + Cargos)\n\n## 💾 Impacto en Base de Datos\n- Tabla `allowance_charges`: Registro del cargo con charge_indicator=1\n- Tabla `documents`: tax_exclusive_amount incluye cargos\n- Tabla `legal_monetary_totals`: payable_amount total incrementado\n- Auditoría: Trazabilidad de cargos aplicados\n\n## 📤 Respuesta Exitosa (200 - Síncrono)\n```json\n{\n \"success\": true,\n \"message\": \"Factura procesada exitosamente\",\n \"ResponseDian\": {\n \"Envelope\": {\n \"Body\": {\n \"SendBillSyncResponse\": {\n \"SendBillSyncResult\": {\n \"IsValid\": \"true\",\n \"StatusCode\": \"00\",\n \"StatusDescription\": \"Procesado Correctamente\"\n }\n }\n }\n }\n },\n \"cufe\": \"...\",\n \"allowance_charges\": [\n {\n \"charge_indicator\": true,\n \"allowance_charge_reason\": \"Cargo por consignación bancaria\",\n \"amount\": 5000.00\n }\n ],\n \"line_extension_amount\": 100000.00,\n \"charge_total\": 5000.00,\n \"tax_exclusive_amount\": 105000.00,\n \"tax_inclusive_amount\": 124950.00,\n \"payable_amount\": 124950.00,\n \"pdf_url\": \"storage/pdf/...\"\n}\n```\n\n## ⚠️ Errores Comunes\n- **400:** charge_indicator incorrecto (debe ser true para cargos)\n- **401:** Token de autorización inválido\n- **422:** allowance_charge_reason faltante, amount negativo o cero, cálculo de impuestos incorrecto\n- **500:** Error interno al procesar cargos\n\n## 🔐 Autenticación\n```\nAuthorization: Bearer {API_TOKEN}\nContent-Type: application/json\n```\n\n## 💻 Ejemplo cURL\n```bash\ncurl -X POST \"http://midominio.com/api/ubl2.1/invoice\" \\\n -H \"Authorization: Bearer {TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"number\": 990000130,\n \"invoice_lines\": [\n {\"invoiced_quantity\": 1, \"price_amount\": 100000, \"description\": \"Producto\"}\n ],\n \"allowance_charges\": [\n {\n \"charge_indicator\": true,\n \"allowance_charge_reason\": \"Cargo por consignación\",\n \"amount\": 5000,\n \"base_amount\": 100000\n }\n ],\n \"customer\": {...}\n }'\n```\n\n## 📝 Diferencia: Cargos vs Descuentos\n| Aspecto | Cargo (true) | Descuento (false) |\n|---------|-------------|------------------|\n| **charge_indicator** | true | false |\n| **Efecto** | Incrementa base gravable | Reduce base gravable |\n| **Impuestos** | Sobre (Subtotal + Cargo) | Sobre (Subtotal - Descuento) |\n| **Uso** | Recargos, envíos, manejo | Promociones, bonificaciones |\n\n## 📌 Notas Importantes\n1. Los cargos INCREMENTAN la base gravable antes de calcular impuestos\n2. charge_indicator = true diferencia cargos de descuentos\n3. El PDF muestra claramente el cargo y su motivo\n4. Pueden aplicarse múltiples cargos en el array allowance_charges\n5. Útil para transparencia en costos adicionales\n6. El XML incluye AllowanceCharge con ChargeIndicator en UBL 2.1\n7. Común en e-commerce para cargos de envío y manejo" }, "response": [] }, { "name": "SendInvoice-TestSetId Charge Encabezado", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": 990000223,\r\n \"type_document_id\": 1,\r\n \"date\": \"2025-11-07\",\r\n \"time\": \"20:20:24\",\r\n \"resolution_number\": \"18760000001\",\r\n \"prefix\": \"SETP\",\r\n \"customer\": {\r\n \"identification_number\": 89008003,\r\n \"name\": \"ALEXANDER OBANDO LONDONO\",\r\n \"phone\": \"3103891693\",\r\n \"address\": \"BRR EL CARDAL MZ 4 CS 7 ET 1\",\r\n \"email\": \"alexander_obando@hotmail.com\",\r\n \"merchant_registration\": \"0000-00\",\r\n \"type_document_identification_id\": 3,\r\n \"type_organization_id\": 2,\r\n \"municipality_id\": 149,\r\n \"type_regime_id\": 2\r\n },\r\n \"payment_form\": {\r\n \"payment_form_id\": 1,\r\n \"payment_method_id\": 10,\r\n \"payment_due_date\": \"2025-11-07\",\r\n \"duration_measure\": \"0\"\r\n },\r\n \"allowance_charges\": [\r\n {\r\n \"discount_id\": 1,\r\n \"charge_indicator\": true,\r\n \"allowance_charge_reason\": \"CARGO POR CONSIGNACION BANCARIA\",\r\n \"amount\": \"7000.00\",\r\n \"base_amount\": \"300000.00\"\r\n }\r\n ],\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"252100.84\",\r\n \"tax_exclusive_amount\": \"252100.84\",\r\n \"tax_inclusive_amount\": \"300000.00\",\r\n \"allowance_total_amount\": \"0.00\",\r\n \"charge_total_amount\": \"7000.00\",\r\n \"payable_amount\": \"307000.00\"\r\n },\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"47899.16\",\r\n \"percent\": \"19\",\r\n \"taxable_amount\": \"252100.84\"\r\n }\r\n ],\r\n \"invoice_lines\": [\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"252100.84\",\r\n \"free_of_charge_indicator\": false,\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"47899.16\",\r\n \"taxable_amount\": \"252100.84\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"COMISION POR SERVICIOS\",\r\n \"code\": \"COMISION\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"300000.00\",\r\n \"base_quantity\": \"1\"\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "# 💵 ENVIAR FACTURA ELECTRÓNICA - CON CARGOS ADICIONALES EN ENCABEZADO\n\n## 📋 Descripción General\nEndpoint para envío de facturas electrónicas que incluyen cargos adicionales (charges) a nivel de encabezado mediante allowance_charges con charge_indicator=true. Los cargos se aplican globalmente sobre toda la factura.\n\n## 🔗 URL del Endpoint\n**Síncrono (recomendado):** `POST /api/ubl2.1/invoice`\n**Asíncrono:** `POST /api/ubl2.1/invoice/{testSetId}`\n\n## 🔑 Campos Principales Específicos\n| Campo | Tipo | Descripción |\n|-------|------|-------------|\n| `allowance_charges` | array | Cargos a nivel de encabezado (globales) |\n| `allowance_charges[].charge_indicator` | boolean | **true** = Cargo adicional |\n| `allowance_charges[].allowance_charge_reason` | string | Motivo del cargo |\n| `allowance_charges[].amount` | decimal | Valor del cargo |\n| `allowance_charges[].base_amount` | decimal | Subtotal total de la factura |\n\n## 📦 Ubicación del Cargo: Encabezado vs Línea\n```\n┌─ ENCABEZADO (este endpoint)\n│ allowance_charges: []\n│ └─ Se aplica sobre TODA la factura\n│\n└─ LÍNEAS\n invoice_lines[]\n ├─ allowance_charges: []\n └─ Se aplica solo sobre ESA línea específica\n```\n\n## 💰 Cálculo con Cargo en Encabezado\n```\nLínea 1: $50,000.00\nLínea 2: $50,000.00\nSubtotal: $100,000.00\n\nCargo Global (Encabezado): +$5,000.00\nBase Gravable: $105,000.00\nIVA 19%: $19,950.00\n--------------------------------------\nTotal a Pagar: $124,950.00\n```\n\n## 💼 Casos de Uso\n- **E-commerce:** Cargo único de envío para todo el pedido\n- **Servicios:** Cargo administrativo global\n- **Financiero:** Recargo por forma de pago aplicado a toda la factura\n- **Logística:** Cargo de manejo para el pedido completo\n\n## ⚙️ Comportamiento del Sistema\n- **Modo Síncrono:** Validación inmediata del cargo global\n- **Modo Asíncrono:** ZIP_KEY para consulta posterior\n- **XML Generation:** AllowanceCharge en nivel Invoice (no InvoiceLine) del XML UBL 2.1\n- **Aplicación:** El cargo se suma al subtotal ANTES de calcular impuestos\n- **Consolidación:** Afecta tax_exclusive_amount global\n\n## ✅ Validaciones Críticas\n- Validación de charge_indicator = true\n- Verificación de allowance_charge_reason obligatorio\n- Coherencia: base_amount debe ser igual a Σ line_extension_amount\n- Validación de amount positivo\n- Cálculo: tax_exclusive_amount = Subtotal + Cargos - Descuentos\n\n## 💾 Impacto en Base de Datos\n- Tabla `allowance_charges`: level = 'invoice' (encabezado)\n- Tabla `documents`: charge_total_amount consolidado\n- Tabla `legal_monetary_totals`: tax_exclusive_amount incrementado\n- Diferenciación: Cargos de encabezado vs línea\n\n## 📤 Respuesta Exitosa (200 - Síncrono)\n```json\n{\n \"success\": true,\n \"message\": \"Factura procesada exitosamente\",\n \"ResponseDian\": {\n \"Envelope\": {\n \"Body\": {\n \"SendBillSyncResponse\": {\n \"SendBillSyncResult\": {\n \"IsValid\": \"true\",\n \"StatusCode\": \"00\",\n \"StatusDescription\": \"Procesado Correctamente\"\n }\n }\n }\n }\n },\n \"cufe\": \"...\",\n \"allowance_charges_header\": [\n {\n \"level\": \"invoice\",\n \"charge_indicator\": true,\n \"amount\": 5000.00\n }\n ],\n \"line_extension_amount\": 100000.00,\n \"charge_total_amount\": 5000.00,\n \"tax_exclusive_amount\": 105000.00,\n \"payable_amount\": 124950.00,\n \"pdf_url\": \"storage/pdf/...\"\n}\n```\n\n## ⚠️ Errores Comunes\n- **400:** charge_indicator incorrecto\n- **401:** Token de autorización inválido\n- **422:** base_amount no coincide con subtotal de líneas, amount negativo\n- **500:** Error interno al procesar cargo de encabezado\n\n## 🔐 Autenticación\n```\nAuthorization: Bearer {API_TOKEN}\nContent-Type: application/json\n```\n\n## 💻 Ejemplo cURL\n```bash\ncurl -X POST \"http://midominio.com/api/ubl2.1/invoice\" \\\n -H \"Authorization: Bearer {TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"number\": 990000131,\n \"invoice_lines\": [\n {\"price_amount\": 50000, \"invoiced_quantity\": 1},\n {\"price_amount\": 50000, \"invoiced_quantity\": 1}\n ],\n \"allowance_charges\": [\n {\n \"charge_indicator\": true,\n \"allowance_charge_reason\": \"Cargo de envío\",\n \"amount\": 5000,\n \"base_amount\": 100000\n }\n ]\n }'\n```\n\n## 📌 Notas Importantes\n1. Los cargos de encabezado afectan TODA la factura\n2. Se aplican ANTES de calcular impuestos (incrementan base gravable)\n3. El PDF muestra el cargo separado del subtotal de productos\n4. Útil cuando el cargo no es atribuible a un producto específico\n5. Pueden combinarse cargos de encabezado y cargos por línea\n6. El XML diferencia nivel Invoice vs InvoiceLine\n7. Común para gastos de envío, manejo, seguros globales" }, "response": [] }, { "name": "SendInvoice-TestSetId Articulos Con Dos Impuestos - Telefonia Celular", "protocolProfileBehavior": { "disabledSystemHeaders": [] }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "host", "value": "apidian2026-8.oo", "type": "text", "disabled": true } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": 990000224,\r\n \"type_document_id\": 1,\r\n \"resolution_number\": \"18760000001\",\r\n \"prefix\": \"SETP\",\r\n \"date\": \"2025-11-07\",\r\n \"time\": \"04:07:12\",\r\n \"sendmail\": false,\r\n \"customer\": {\r\n \"identification_number\": 73187745,\r\n \"dv\": null,\r\n \"name\": \"ARNOLD JOSE PEREZ\",\r\n \"phone\": \"3042484748\",\r\n \"address\": \"CLL 4 NRO 33-95\",\r\n \"email\": \"alexanderobandolondono@gmail.com\",\r\n \"merchant_registration\": \"0000000-00\",\r\n \"type_document_identification_id\": 3,\r\n \"type_organization_id\": 2,\r\n \"municipality_id\": 823,\r\n \"type_regime_id\": 2\r\n },\r\n \"payment_form\": {\r\n \"payment_form_id\": 1,\r\n \"payment_method_id\": 10,\r\n \"payment_due_date\": \"2025-11-07\",\r\n \"duration_measure\": \"0\"\r\n },\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"142013.42\",\r\n \"tax_exclusive_amount\": \"142013.42\",\r\n \"tax_inclusive_amount\": \"169634.49\",\r\n \"allowance_total_amount\": \"0.00\",\r\n \"charge_total_amount\": \"0.00\",\r\n \"payable_amount\": \"169634.49\"\r\n },\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"26982.55\",\r\n \"percent\": \"19\",\r\n \"taxable_amount\": \"142013.4\"\r\n },\r\n {\r\n \"tax_id\": 4,\r\n \"tax_amount\": \"638.52\",\r\n \"percent\": \"4\",\r\n \"taxable_amount\": \"15963.00\"\r\n }\r\n ],\r\n \"invoice_lines\": [\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"15963.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"3032.97\",\r\n \"taxable_amount\": \"15963.00\",\r\n \"percent\": \"19.00\"\r\n },\r\n {\r\n \"tax_id\": 4,\r\n \"tax_amount\": \"638.52\",\r\n \"taxable_amount\": \"15963.00\",\r\n \"percent\": \"4.00\"\r\n }\r\n ],\r\n \"description\": \"Cadena tejido chino (peso 3.4gr)\",\r\n \"code\": \"Item\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"19634.49\",\r\n \"base_quantity\": \"1\"\r\n },\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"126050.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"23949.58\",\r\n \"taxable_amount\": \"126050.00\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"Anillo chibcha (peso 43.5gr)\",\r\n \"code\": \"Item\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"150000.00\",\r\n \"base_quantity\": \"1\"\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "# 📱 ENVIAR FACTURA ELECTRÓNICA - ARTÍCULOS CON DOS IMPUESTOS (IVA + CONSUMO)\n\n## 📋 Descripción General\nEndpoint para envío de facturas electrónicas con productos que tienen dos impuestos simultáneos: IVA e Impuesto al Consumo. Aplica en casos específicos como telefonía celular, vehículos, bienes suntuarios.\n\n## 🔗 URL del Endpoint\n**Síncrono (recomendado):** `POST /api/ubl2.1/invoice`\n**Asíncrono:** `POST /api/ubl2.1/invoice/{testSetId}`\n\n## 🔑 Campos Principales Específicos\n| Campo | Tipo | Descripción |\n|-------|------|-------------|\n| `tax_totals` | array | Arreglo con múltiples impuestos por línea |\n| `tax_totals[].tax_id` | integer | **1** = IVA, **4** = Consumo |\n| `tax_totals[].percent` | string | Tarifa del impuesto (ej: \"19.00\" IVA, \"4.00\" Consumo) |\n| `tax_totals[].tax_amount` | decimal | Valor calculado del impuesto |\n| `tax_totals[].taxable_amount` | decimal | Base gravable (mismo valor para ambos impuestos) |\n\n## 📦 Estructura de Dos Impuestos en Línea\n```json\n\"invoice_lines\": [\n {\n \"unit_measure_id\": 70,\n \"invoiced_quantity\": 1.00,\n \"line_extension_amount\": 1000000.00,\n \"description\": \"Plan celular\",\n \"code\": \"PLAN-001\",\n \"price_amount\": 1000000.00,\n \"tax_totals\": [\n {\n \"tax_id\": 1,\n \"percent\": \"19.00\",\n \"tax_amount\": 190000.00,\n \"taxable_amount\": 1000000.00\n },\n {\n \"tax_id\": 4,\n \"percent\": \"4.00\",\n \"tax_amount\": 40000.00,\n \"taxable_amount\": 1000000.00\n }\n ]\n }\n]\n```\n\n## 💼 Casos de Uso por Sector\n- **Telefonía Celular:** IVA 19% + Consumo 4%\n- **Vehículos:** IVA + Consumo (varía según cilindraje)\n- **Licores:** IVA + Consumo (varía según grados alcohol)\n- **Alimentos Ultraprocesados:** IVA + Impuesto Saludable\n- **Bienes Suntuarios:** IVA + Consumo específico\n\n## 💰 Cálculo con Dos Impuestos\n```\nBase Gravable: $1,000,000.00\nIVA 19%: $190,000.00\nImpuesto Consumo 4%: $40,000.00\n---------------------------------\nTotal Impuestos: $230,000.00\nTotal a Pagar: $1,230,000.00\n```\n\n## 📋 Tipos de Impuesto (tax_id)\n- **1:** IVA (Impuesto al Valor Agregado)\n- **4:** Impuesto Nacional al Consumo\n- **5:** Impuesto Saludable (alimentos ultraprocesados)\n- **10:** INCBP (Impuesto Bolsas Plásticas)\n\n## ⚙️ Comportamiento del Sistema\n- **Modo Síncrono:** Validación inmediata de múltiples impuestos\n- **Modo Asíncrono:** ZIP_KEY para consulta posterior\n- **XML Generation:** Múltiples TaxTotal por línea en XML UBL 2.1\n- **Consolidación:** Sistema agrupa por tax_id al nivel documento\n- **Validación:** Verifica cálculos independientes de cada impuesto\n\n## ✅ Validaciones Críticas\n- Validación de tax_id válidos (1, 4, 5, 10, etc.)\n- Verificación de percent según normativa DIAN\n- Coherencia: `tax_amount = taxable_amount × (percent / 100)`\n- Validación de que taxable_amount sea igual para ambos impuestos\n- Verificación de combinaciones permitidas de impuestos\n\n## 💾 Impacto en Base de Datos\n- Tabla `tax_totals`: Múltiples registros por línea (uno por cada tax_id)\n- Tabla `tax_consolidation`: Totales por tax_id a nivel documento\n- Tabla `documents`: tax_inclusive_amount incluye suma de todos los impuestos\n- Reportes: Desglose por tipo de impuesto\n\n## 📤 Respuesta Exitosa (200 - Síncrono)\n```json\n{\n \"success\": true,\n \"message\": \"Factura procesada exitosamente\",\n \"ResponseDian\": {\n \"Envelope\": {\n \"Body\": {\n \"SendBillSyncResponse\": {\n \"SendBillSyncResult\": {\n \"IsValid\": \"true\",\n \"StatusCode\": \"00\",\n \"StatusDescription\": \"Procesado Correctamente\"\n }\n }\n }\n }\n },\n \"cufe\": \"...\",\n \"tax_totals_summary\": [\n {\"tax_id\": 1, \"tax_amount\": 190000.00},\n {\"tax_id\": 4, \"tax_amount\": 40000.00}\n ],\n \"line_extension_amount\": 1000000.00,\n \"tax_exclusive_amount\": 1000000.00,\n \"tax_inclusive_amount\": 1230000.00,\n \"payable_amount\": 1230000.00,\n \"pdf_url\": \"storage/pdf/...\"\n}\n```\n\n## ⚠️ Errores Comunes\n- **400:** tax_id inválido o no permitido\n- **401:** Token de autorización inválido\n- **422:** Combinación de impuestos no permitida, percent incorrecto según normativa, cálculo de tax_amount incorrecto, taxable_amount diferente entre impuestos\n- **500:** Error interno al procesar múltiples impuestos\n\n## 🔐 Autenticación\n```\nAuthorization: Bearer {API_TOKEN}\nContent-Type: application/json\n```\n\n## 💻 Ejemplo cURL\n```bash\ncurl -X POST \"http://midominio.com/api/ubl2.1/invoice\" \\\n -H \"Authorization: Bearer {TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"number\": 990000132,\n \"invoice_lines\": [{\n \"invoiced_quantity\": 1,\n \"price_amount\": 1000000,\n \"description\": \"Plan celular\",\n \"tax_totals\": [\n {\"tax_id\": 1, \"percent\": \"19.00\", \"tax_amount\": 190000, \"taxable_amount\": 1000000},\n {\"tax_id\": 4, \"percent\": \"4.00\", \"tax_amount\": 40000, \"taxable_amount\": 1000000}\n ]\n }],\n \"customer\": {...}\n }'\n```\n\n## 📌 Notas Importantes\n1. Ambos impuestos se calculan sobre la MISMA base gravable\n2. Es poco frecuente pero válido según normativa DIAN\n3. El PDF debe mostrar claramente ambos impuestos desglosados\n4. Útil en sectores regulados con impuestos especiales\n5. El XML incluye múltiples TaxTotal por línea\n6. Los totales por tax_id se consolidan a nivel documento\n7. Verificar normativa vigente para combinaciones permitidas" }, "response": [] }, { "name": "SendInvoice-TestSetId Articulos Con impuesto Saludable Alimentos Ultraprocesados", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "host", "value": "apidian2026-8.oo", "type": "text", "disabled": true } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": 990000225,\r\n \"type_document_id\": 1,\r\n \"resolution_number\": \"18760000001\",\r\n \"prefix\": \"SETP\",\r\n \"date\": \"2025-11-07\",\r\n \"time\": \"04:07:12\",\r\n \"sendmail\": false,\r\n \"customer\": {\r\n \"identification_number\": 89008003,\r\n \"dv\": 2,\r\n \"name\": \"ALEXANDER OBANDO LONDOÑO\",\r\n \"phone\": \"3103891693\",\r\n \"address\": \"CLL 11 NRO 21-73\",\r\n \"email\": \"alexander_obando@hotmail.com\",\r\n \"merchant_registration\": \"0000000-00\",\r\n \"type_document_identification_id\": 3,\r\n \"type_organization_id\": 2,\r\n \"municipality_id\": 822,\r\n \"type_regime_id\": 2\r\n },\r\n \"payment_form\": {\r\n \"payment_form_id\": 1,\r\n \"payment_method_id\": 10,\r\n \"payment_due_date\": \"2025-11-07\",\r\n \"duration_measure\": \"0\"\r\n },\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"141270.95\",\r\n \"tax_exclusive_amount\": \"141270.95\",\r\n \"tax_inclusive_amount\": \"169634.48\",\r\n \"allowance_total_amount\": \"0.00\",\r\n \"charge_total_amount\": \"0.00\",\r\n \"payable_amount\": \"169634.48\"\r\n },\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"26841.48\",\r\n \"percent\": \"19\",\r\n \"taxable_amount\": \"141270.95\"\r\n },\r\n {\r\n \"tax_id\": 22,\r\n \"tax_amount\": \"1522.05\",\r\n \"percent\": \"10\",\r\n \"taxable_amount\": \"15220.53\"\r\n }\r\n ],\r\n \"invoice_lines\": [\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"15220.53\",\r\n \"free_of_charge_indicator\": false,\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"2891.90\",\r\n \"taxable_amount\": \"15220.53\",\r\n \"percent\": \"19.00\"\r\n },\r\n {\r\n \"tax_id\": 22,\r\n \"tax_amount\": \"1522.05\",\r\n \"taxable_amount\": \"15220.53\",\r\n \"percent\": \"10.00\"\r\n }\r\n ],\r\n \"description\": \"PRODUCTO ALIMENTICIO ULTRAPROCESADO\",\r\n \"code\": \"ULTRAPROCESADO\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"19634.49\",\r\n \"base_quantity\": \"1\"\r\n },\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"126050.42\",\r\n \"free_of_charge_indicator\": false,\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"23949.58\",\r\n \"taxable_amount\": \"126050.42\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"PRODUCTO ALIMENTICIO NO ULTRAPROCESADO\",\r\n \"code\": \"NOULTRAPROCESADO\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"150000.00\",\r\n \"base_quantity\": \"1\"\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "# 🍟 FACTURA - DOS IMPUESTOS (IVA + IMPUESTO SALUDABLE ALIMENTOS)\n\nEndpoint para facturas con alimentos ultraprocesados que tienen IVA e Impuesto Saludable (tax_id=1 y tax_id=5). Ley 2277/2022.\n\n**Campos:** tax_totals[] con tax_id: 1 (IVA 19%), tax_id: 5 (Imp. Saludable 10% o 15%). Ambos calculados sobre misma base gravable. Aplica a: alimentos ultraprocesados, productos alto sodio/azúcar. Cálculo ejemplo: Base $10,000 + IVA $1,900 + Imp.Saludable $1,000 = $12,900." }, "response": [] }, { "name": "SendInvoice-TestSetId Articulos Con impuesto Licores", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "host", "value": "apidian2026-8.oo", "type": "text", "disabled": true } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": 990000226,\r\n \"type_document_id\": 1,\r\n \"date\": \"2025-11-07\",\r\n \"time\": \"04:08:12\",\r\n \"resolution_number\": \"18760000001\",\r\n \"prefix\": \"SETP\",\r\n \"sendmail\": false,\r\n \"sendmailtome\": false,\r\n \"send_customer_credentials\": false,\r\n \"notes\": \"ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA\",\r\n \"disable_confirmation_text\": true,\r\n \"establishment_name\": \"TORRE SOFTWARE\",\r\n \"establishment_address\": \"BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n \"establishment_phone\": \"3226563672\",\r\n \"establishment_municipality\": 600,\r\n \"establishment_email\": \"alternate_email@alternate.com\",\r\n \"head_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"foot_note\": \"PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN\",\r\n \"customer\": {\r\n \"identification_number\": 89008003,\r\n \"dv\": 2,\r\n \"name\": \"INVERSIONES DAVAL SAS\",\r\n \"phone\": \"3103891693\",\r\n \"address\": \"CLL 4 NRO 33-90\",\r\n \"email\": \"alexanderobandolondono@gmail.com\",\r\n \"merchant_registration\": \"0000000-00\",\r\n \"type_document_identification_id\": 6,\r\n \"type_organization_id\": 1,\r\n \"type_liability_id\": 7,\r\n \"municipality_id\": 822,\r\n \"type_regime_id\": 1\r\n },\r\n \"payment_form\": {\r\n \"payment_form_id\": 2,\r\n \"payment_method_id\": 2,\r\n \"payment_due_date\": \"2025-11-07\",\r\n \"duration_measure\": 0\r\n },\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"11512000.000\",\r\n \"tax_exclusive_amount\": \"11512000.000\",\r\n \"tax_inclusive_amount\": \"14500000.000\",\r\n \"allowance_total_amount\": 0,\r\n \"charge_total_amount\": \"0\",\r\n \"payable_amount\": \"14500000.000\"\r\n },\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"0.000\",\r\n \"percent\": \"0.00\",\r\n \"taxable_amount\": \"11512000.000\",\r\n \"unit_measure_id\": null,\r\n \"per_unit_amount\": null,\r\n \"base_unit_measure\": null\r\n },\r\n {\r\n \"tax_id\": 19,\r\n \"tax_amount\": \"2988000.000\",\r\n \"percent\": \"0\",\r\n \"taxable_amount\": \"0\",\r\n \"unit_measure_id\": \"70\",\r\n \"per_unit_amount\": null,\r\n \"base_unit_measure\": null\r\n }\r\n ],\r\n \"with_holding_tax_total\": [\r\n {\r\n \"tax_id\": 6,\r\n \"tax_amount\": \"287800.000\",\r\n \"percent\": \"2.500\",\r\n \"taxable_amount\": \"11512000.000\",\r\n \"unit_measure_id\": null,\r\n \"per_unit_amount\": null,\r\n \"base_unit_measure\": null\r\n }\r\n ],\r\n \"invoice_lines\": [\r\n {\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"0.000000\",\r\n \"percent\": \"0.00\",\r\n \"taxable_amount\": \"11512000.000\",\r\n \"unit_measure_id\": null,\r\n \"per_unit_amount\": null,\r\n \"base_unit_measure\": null\r\n },\r\n {\r\n \"tax_id\": 19,\r\n \"tax_amount\": \"2988000.000\",\r\n \"percent\": \"0\",\r\n \"taxable_amount\": \"0\",\r\n \"unit_measure_id\": \"70\",\r\n \"per_unit_amount\": \"250.000\",\r\n \"base_unit_measure\": \"11952\"\r\n }\r\n ],\r\n \"unit_measure_id\": 1076,\r\n \"invoiced_quantity\": \"250.000\",\r\n \"line_extension_amount\": \"11512000.000\",\r\n \"free_of_charge_indicator\": false,\r\n \"description\": \"AGUILA RN 330CC X 30 \",\r\n \"notes\": \"\",\r\n \"code\": \"100003\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"46048.000\",\r\n \"base_quantity\": \"1\"\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "# 🍷 FACTURA - DOS IMPUESTOS (IVA + IMPUESTO LICORES)\n\nEndpoint para bebidas alcohólicas con IVA e Impuesto al Consumo (tax_id=1 y tax_id=4). Tarifa según grados alcohol: 2.5°-15°: 20%, 15°-20°: 25%, >20°: 35%. Ambos sobre misma base. Cálculo ejemplo: Base $50,000 + IVA 19% $9,500 + Imp.Consumo 25% $12,500 = $72,000. Aplica: vinos, cervezas, licores." }, "response": [] }, { "name": "SendInvoice-TestSetId Articulos Con impuesto Saludable Bebidas Azucaradas", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "host", "value": "apidian2026-8.oo", "type": "text", "disabled": true } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": 990000227,\r\n \"type_document_id\": 1,\r\n \"resolution_number\": \"18760000001\",\r\n \"prefix\": \"SETP\",\r\n \"date\": \"2025-11-07\",\r\n \"time\": \"04:07:12\",\r\n \"sendmail\": false,\r\n \"customer\": {\r\n \"identification_number\": 89008003,\r\n \"dv\": 2,\r\n \"name\": \"ALEXANDER OBANDO LONDOÑO\",\r\n \"phone\": \"3103891693\",\r\n \"address\": \"CLL 11 NRO 21-73\",\r\n \"email\": \"alexander_obando@hotmail.com\",\r\n \"merchant_registration\": \"0000000-00\",\r\n \"type_document_identification_id\": 3,\r\n \"type_organization_id\": 2,\r\n \"municipality_id\": 822,\r\n \"type_regime_id\": 2\r\n },\r\n \"payment_form\": {\r\n \"payment_form_id\": 1,\r\n \"payment_method_id\": 10,\r\n \"payment_due_date\": \"2025-11-07\",\r\n \"duration_measure\": \"0\"\r\n },\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"12255.04\",\r\n \"tax_exclusive_amount\": \"12605.04\",\r\n \"tax_inclusive_amount\": \"15000.00\",\r\n \"allowance_total_amount\": \"0.00\",\r\n \"charge_total_amount\": \"0.00\",\r\n \"payable_amount\": \"15000.00\"\r\n },\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"2394.96\",\r\n \"percent\": \"19\",\r\n \"taxable_amount\": \"12605.04\"\r\n },\r\n {\r\n \"tax_id\": 21,\r\n \"unit_measure_id\": \"852\",\r\n \"tax_amount\": \"350.00\",\r\n \"taxable_amount\": \"8403.36\",\r\n \"percent\": \"0.00\",\r\n \"per_unit_amount\": \"35.00\",\r\n \"base_unit_measure\": \"1000.00\"\r\n }\r\n ],\r\n \"invoice_lines\": [\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"8053.36\",\r\n \"free_of_charge_indicator\": false,\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"1596.64\",\r\n \"taxable_amount\": \"8403.36\",\r\n \"percent\": \"19.00\"\r\n },\r\n {\r\n \"tax_id\": 21,\r\n \"unit_measure_id\": \"852\",\r\n \"tax_amount\": \"350.00\",\r\n \"taxable_amount\": \"8403.36\",\r\n \"percent\": \"0.00\",\r\n \"per_unit_amount\": \"35.00\",\r\n \"base_unit_measure\": \"1000.00\"\r\n }\r\n ],\r\n \"description\": \"BEBIDA AZUCARADA 1000 ML MAYOR DE 10 GR X 100 ML\",\r\n \"code\": \"AZUCARADA1000ML15GR100ML\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"10000.00\",\r\n \"base_quantity\": \"1\"\r\n },\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"4201.68\",\r\n \"free_of_charge_indicator\": false,\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"798.32\",\r\n \"taxable_amount\": \"4201.68\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"BEBIDA NO AZUCARADA\",\r\n \"code\": \"NOAZUCARADA1000ML\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"5000.00\",\r\n \"base_quantity\": \"1\"\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "# 🥤 FACTURA - DOS IMPUESTOS (IVA + IMPUESTO BEBIDAS AZUCARADAS)\n\nEndpoint para bebidas azucaradas con IVA e Impuesto Saludable (tax_id=1 y tax_id=5). Ley 2277/2022. Tarifas: 6-10g/100ml: 10%, >10g/100ml: 15%. Ambos sobre misma base. Cálculo: Base $5,000 + IVA $950 + Imp.Saludable $500 = $6,450. Aplica: gaseosas, jugos, energizantes. Excluye: jugos 100% naturales, leche." }, "response": [] }, { "name": "SendInvoice-TestSetId Articulos Con impuesto Saludable Bebidas Azucaradas Varias", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "host", "value": "apidian2026-8.oo", "type": "text", "disabled": true } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": 990000228,\r\n \"type_document_id\": 1,\r\n \"resolution_number\": \"18760000001\",\r\n \"prefix\": \"SETP\",\r\n \"date\": \"2025-11-07\",\r\n \"time\": \"04:07:12\",\r\n \"sendmail\": false,\r\n \"customer\": {\r\n \"identification_number\": \"222222222222\",\r\n \"name\": \"CONSUMIDOR FINAL \",\r\n \"merchant_registration\": \"0000000-00\"\r\n },\r\n \"payment_form\": [\r\n {\r\n \"payment_form_id\": 1,\r\n \"payment_method_id\": \"10\",\r\n \"payment_due_date\": \"2025-11-07\",\r\n \"duration_measure\": \"0\"\r\n }\r\n ],\r\n \"allowance_charges\": [\r\n {\r\n \"discount_id\": 10,\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL \",\r\n \"allowance_charge_reason_code\": \"09\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": 11663.87\r\n }\r\n ],\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": 11663.87,\r\n \"tax_exclusive_amount\": 11663.87,\r\n \"tax_inclusive_amount\": 15000,\r\n \"allowance_total_amount\": \"0.00\",\r\n \"charge_total_amount\": \"0.00\",\r\n \"payable_amount\": 15000\r\n },\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"percent\": \"19\",\r\n \"tax_amount\": 2216.13,\r\n \"taxable_amount\": 11663.87\r\n },\r\n {\r\n \"tax_id\": 21,\r\n \"unit_measure_id\": 852,\r\n \"tax_amount\": 840,\r\n \"taxable_amount\": 7697.48,\r\n \"percent\": \"0.00\",\r\n \"per_unit_amount\": 28,\r\n \"base_unit_measure\": 3000\r\n },\r\n {\r\n \"tax_id\": 21,\r\n \"unit_measure_id\": 852,\r\n \"tax_amount\": 280,\r\n \"taxable_amount\": 3966.39,\r\n \"percent\": \"0.00\",\r\n \"per_unit_amount\": 28,\r\n \"base_unit_measure\": 1000\r\n }\r\n ],\r\n \"invoice_lines\": [\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": 7697.48,\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO PRODUCTO\",\r\n \"amount\": 0,\r\n \"base_amount\": 7697.48\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": 1462.52,\r\n \"taxable_amount\": 7697.48,\r\n \"percent\": \"19\"\r\n },\r\n {\r\n \"tax_id\": 21,\r\n \"unit_measure_id\": 852,\r\n \"tax_amount\": 840,\r\n \"taxable_amount\": 7697.48,\r\n \"percent\": \"0.00\",\r\n \"per_unit_amount\": 28,\r\n \"base_unit_measure\": 3000\r\n }\r\n ],\r\n \"description\": \"GASEOSA FANTA\",\r\n \"code\": \"PRO000006\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": 10000,\r\n \"base_quantity\": \"1\"\r\n },\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": 3966.39,\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO PRODUCTO\",\r\n \"amount\": 0,\r\n \"base_amount\": 3966.39\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": 753.61,\r\n \"taxable_amount\": 3966.39,\r\n \"percent\": \"19\"\r\n },\r\n {\r\n \"tax_id\": 21,\r\n \"unit_measure_id\": 852,\r\n \"tax_amount\": 280,\r\n \"taxable_amount\": 3966.39,\r\n \"percent\": \"0.00\",\r\n \"per_unit_amount\": 28,\r\n \"base_unit_measure\": 1000\r\n }\r\n ],\r\n \"description\": \"GASEOSA COCA COLA PERSONAL\",\r\n \"code\": \"PRO000001\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": 5000,\r\n \"base_quantity\": \"1\"\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "# 🌿 FACTURA - DOS IMPUESTOS (IVA + IMPUESTO CANNABIS)\n\nEndpoint para productos de cannabis con IVA e Impuesto al Consumo (tax_id=1 y tax_id=4). Tarifa: IVA 19% + Consumo Cannabis 16%. Ambos sobre misma base. Cálculo: Base $100,000 + IVA $19,000 + Imp.Cannabis $16,000 = $135,000. Requiere licencia especial. Ley 1787/2016 cannabis medicinal. Aplica: cannabis medicinal, derivados psicoactivos." }, "response": [] }, { "name": "SendInvoice-TestSetId Productos Gratis Nro 1", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": 990000229,\r\n \"type_document_id\": 1,\r\n \"date\": \"2025-11-07\",\r\n \"time\": \"22:09:34\",\r\n \"resolution_number\": \"18760000001\",\r\n \"prefix\": \"SETP\",\r\n \"sendmail\": false,\r\n \"customer\": {\r\n \"identification_number\": 1053005500,\r\n \"dv\": 8,\r\n \"name\": \"DANIEL JOSÉ ACOSTA RODRIGUEZ\",\r\n \"phone\": \"0000000\",\r\n \"address\": \"Sin definir\",\r\n \"email\": \"sin_informacion@sin_informacion.com\",\r\n \"merchant_registration\": \"0000000-00\",\r\n \"type_document_identification_id\": 3,\r\n \"type_organization_id\": 2,\r\n \"municipality_id\": 150,\r\n \"type_regime_id\": 2\r\n },\r\n \"payment_form\": {\r\n \"payment_form_id\": 1,\r\n \"payment_method_id\": 30,\r\n \"payment_due_date\": \"2025-12-07\",\r\n \"duration_measure\": 30\r\n },\r\n \"allowance_charges\": [\r\n {\r\n \"discount_id\": 12,\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"BECA ESPECIAL \",\r\n \"amount\": 438901.0,\r\n \"base_amount\": 438901.0\r\n }\r\n ],\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": 463992.0,\r\n \"tax_exclusive_amount\": 463992.0,\r\n \"tax_inclusive_amount\": 463992.0,\r\n \"allowance_total_amount\": 438901.0,\r\n \"charge_total_amount\": 0.0,\r\n \"payable_amount\": 25091.0\r\n },\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": 0.0,\r\n \"percent\": 0.0,\r\n \"taxable_amount\": 0.0\r\n }\r\n ],\r\n \"invoice_lines\": [\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": 1,\r\n \"line_extension_amount\": 4389.0,\r\n \"free_of_charge_indicator\": false,\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": 0.0,\r\n \"percent\": 0.0,\r\n \"taxable_amount\": 4389.0\r\n }\r\n ],\r\n \"description\": \"ESTAMPILLA PREGRADO\",\r\n \"code\": \"000883\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": 4389.0,\r\n \"base_quantity\": 1\r\n },\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": 1,\r\n \"line_extension_amount\": 20702.0,\r\n \"free_of_charge_indicator\": false,\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": 0.0,\r\n \"percent\": 0.0,\r\n \"taxable_amount\": 20702.0\r\n }\r\n ],\r\n \"description\": \"DERECHOS ESPERIALES PREGRADO\",\r\n \"code\": \"000882\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": 20702.0,\r\n \"base_quantity\": 1\r\n },\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": 1,\r\n \"line_extension_amount\": 438901.0,\r\n \"allowance_charges\": [\r\n {\r\n \"discount_id\": 12,\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"BECA ESPECIAL \",\r\n \"amount\": 438901.0,\r\n \"base_amount\": 438901.0\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": 0.0,\r\n \"percent\": 0.0,\r\n \"taxable_amount\": 438901.0\r\n }\r\n ],\r\n \"description\": \"MATRICULA PREGRADO\",\r\n \"code\": \"000880\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": 438901.0,\r\n \"base_quantity\": 1,\r\n \"reference_price_id\": 1,\r\n \"free_of_charge_indicator\": true\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "# 🎁 FACTURA - CON PRODUCTOS GRATIS (FREE OF CHARGE)\n\nEndpoint para facturas con productos gratuitos/obsequios usando free_of_charge_indicator. Campo: invoice_lines[].free_of_charge_indicator = true. Productos sin costo aparecen en factura con price_amount = 0 y line_extension_amount = 0. Útil para: muestras gratis, promociones 2×1, obsequios. Cálculo: productos gratuitos NO incrementan payable_amount. Trazabilidad completa de items entregados sin costo. XML incluye FreeOfChargeIndicator en InvoiceLine." }, "response": [] }, { "name": "SendInvoice-TestSetId Productos Gratis Nro 2", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"prefix\": \"SETP\",\r\n \"number\": 990000230,\r\n \"type_document_id\": 1,\r\n \"resolution_number\": \"18760000001\",\r\n \"date\": \"2025-11-07\",\r\n \"time\": \"10:07:58\",\r\n \"sendmail\": false,\r\n \"foot_note\": \"Modalidad de Emision de Facturas Electronicas: SOFTWARE PROPIO - Fabricante de Software: Distribuidora hbeu eu Nit: 830021621 \",\r\n \"customer\": {\r\n \"identification_number\": \"52490927\",\r\n \"dv\": \"2\",\r\n \"name\": \"TIENDA\",\r\n \"phone\": \"3227220545\",\r\n \"address\": \"TV 20D 61 - 41 \",\r\n \"email\": \"deissyfuentes3@gmail.com\",\r\n \"merchant_registration\": \"0000-00\",\r\n \"type_document_identification_id\": \"6\",\r\n \"type_organization_id\": \"2\",\r\n \"municipality_id\": \"149\",\r\n \"type_regime_id\": \"2\"\r\n },\r\n \"order_reference\": null,\r\n \"payment_form\": {\r\n \"payment_form_id\": 1,\r\n \"payment_method_id\": 1,\r\n \"payment_due_date\": \"2025-11-07\",\r\n \"duration_measure\": 0\r\n },\r\n \"allowance_charges\": [\r\n {\r\n \"discount_id\": \"12\",\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"13928.00\",\r\n \"base_amount\": \"51238.94\"\r\n }\r\n ],\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"51238.94\",\r\n \"tax_exclusive_amount\": \"51238.94\",\r\n \"tax_inclusive_amount\": \"58328.02\",\r\n \"allowance_total_amount\": \"13928.00\",\r\n \"charge_total_amount\": \"0.00\",\r\n \"payable_amount\": \"44400.02\"\r\n },\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": 7089.08,\r\n \"percent\": \"19.00\",\r\n \"taxable_amount\": 37310.94\r\n },\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": 0,\r\n \"taxable_amount\": \"13928.00\",\r\n \"percent\": 0\r\n }\r\n ],\r\n \"invoice_lines\": [\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"4\",\r\n \"line_extension_amount\": \"13928.00\",\r\n \"free_of_charge_indicator\": true,\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": 0,\r\n \"taxable_amount\": \"13928.00\",\r\n \"percent\": 0\r\n }\r\n ],\r\n \"description\": \"1 UNIDAD OREO ORIGINALX54GR\",\r\n \"code\": \"361111\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"4143.58\",\r\n \"base_quantity\": \"1\",\r\n \"reference_price_id\": \"1\",\r\n \"allowance_charges\": [\r\n {\r\n \"discount_id\": \"12\",\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"13928.00\",\r\n \"base_amount\": \"13928.00\"\r\n }\r\n ]\r\n },\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"6\",\r\n \"line_extension_amount\": \"37310.94\",\r\n \"free_of_charge_indicator\": false,\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"7089.08\",\r\n \"taxable_amount\": \"37310.94\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"GALLETA OREO VAINILLA ORIGINALX54GR CJX18X6X6\",\r\n \"code\": \"332110\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"7400.0031\",\r\n \"base_quantity\": \"1\"\r\n }\r\n ],\r\n \"with_holding_tax_total\": []\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "# 🎁 FACTURA - CON PRODUCTOS GRATIS (FREE OF CHARGE) Nro 2\n\nEndpoint para facturas con productos gratuitos/obsequios. Campo: invoice_lines[].free_of_charge_indicator = true marca items sin costo. price_amount = 0, line_extension_amount = 0. Casos: muestras gratis, promociones 3×2, regalos corporativos. Productos gratuitos no afectan payable_amount. Aparecen en PDF para trazabilidad. XML: FreeOfChargeIndicator en InvoiceLine UBL 2.1." }, "response": [] }, { "name": "SendInvoice-TestSetId Dos Tarifas Impuestos y Retenciones", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": 990000231,\r\n \"type_document_id\": 1,\r\n \"date\": \"2025-11-07\",\r\n \"time\": \"08:32:31\",\r\n \"resolution_number\": \"18760000001\",\r\n \"prefix\": \"SETP\",\r\n \"customer\": {\r\n \"identification_number\": 89008003,\r\n \"dv\": 2,\r\n \"name\": \"ALEXANDER OBANDO LONDONO\",\r\n \"phone\": \"3103891693\",\r\n \"address\": \"BRR LIMONAR MZ 6 CS 3 ET 1\",\r\n \"email\": \"alexander_obando@hotmail.com\",\r\n \"merchant_registration\": \"0000-00\",\r\n \"type_document_identification_id\": 3,\r\n \"type_organization_id\": 2,\r\n \"municipality_id\": 149,\r\n \"type_regime_id\": 2\r\n },\r\n \"payment_form\": {\r\n \"payment_form_id\": 1,\r\n \"payment_method_id\": 10,\r\n \"payment_due_date\": \"2025-11-07\",\r\n \"duration_measure\": \"0\"\r\n },\r\n \"allowance_charges\": [\r\n {\r\n \"discount_id\": 1,\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"1140336.13\"\r\n }\r\n ],\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"1140336.13\",\r\n \"tax_exclusive_amount\": \"1140336.13\",\r\n \"tax_inclusive_amount\": \"1300000.00\",\r\n \"allowance_total_amount\": \"0.00\",\r\n \"charge_total_amount\": \"0.00\",\r\n \"payable_amount\": \"1300000.00\"\r\n },\r\n \"with_holding_tax_total\": [\r\n {\r\n \"tax_id\": 5,\r\n \"tax_amount\": \"126050.042\",\r\n \"percent\": \"15\",\r\n \"taxable_amount\": \"840336.13\"\r\n },\r\n {\r\n \"tax_id\": 6,\r\n \"tax_amount\": \"29411.76\",\r\n \"percent\": \"3.50\",\r\n \"taxable_amount\": \"840336.13\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"0.00\",\r\n \"percent\": \"0\",\r\n \"taxable_amount\": \"300000.00\"\r\n },\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"159663.86\",\r\n \"percent\": \"19\",\r\n \"taxable_amount\": \"840336.13\"\r\n }\r\n ],\r\n \"invoice_lines\": [\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"300000.00\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"300000.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"0.00\",\r\n \"taxable_amount\": \"300000.00\",\r\n \"percent\": \"0.00\"\r\n }\r\n ],\r\n \"description\": \"CESANTIA MERCANTIL\",\r\n \"code\": \"CESANTIA\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"300000.00\",\r\n \"base_quantity\": \"1\"\r\n },\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"840336.13\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"1000000.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"159663.86\",\r\n \"taxable_amount\": \"840336.13\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"COMISION POR SERVICIOS\",\r\n \"code\": \"COMISION\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"840336.13\",\r\n \"base_quantity\": \"1\"\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "# 💼 FACTURA - CON RETENCIONES (WITH_HOLDING_TAX_TOTAL)\n\nEndpoint para facturas con retenciones en la fuente. Campo: with_holding_tax_total[] incluye retenciones aplicadas. Tipos: Renta, IVA, ICA. Retenciones REDUCEN el payable_amount. Cálculo: Total - Retenciones = Saldo a Pagar. Campos: tax_id (tipo retención), percent (tarifa), tax_amount (valor retenido). Aplica: agentes de retención, compras B2B. XML: WithholdingTaxTotal en UBL 2.1. Útil: autoretenedores, grandes contribuyentes." }, "response": [] } ], "description": "Se incluyen estos request para ejemplificar el envio de documentos con varias casuisticas, varios invoice\r\nlines, varias tarifas de impuestos, incluyendo cargos, incluyendo descuentos, etc.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "7692a20fec92af0aa5729d796b019d27c83c9955407994630a0cdd7702ca2329", "type": "string" } ] } }, { "name": "05 - Consumidor Final", "item": [ { "name": "SendInvoice-TestSetId Consumidor Final", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "name": "Content-Type", "type": "text", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\r\n \"number\": 990000232,\r\n \"type_document_id\": 1,\r\n \"resolution_number\": \"18760000001\",\r\n \"prefix\": \"SETP\",\r\n \"date\": \"2025-11-07\",\r\n \"time\": \"06:08:12\",\r\n \"sendmail\": true,\r\n \"email_pos_customer\": \"alexander_obando@hotmail.com\",\r\n \"customer\": {\r\n \"identification_number\": \"222222222222\",\r\n \"name\": \"CONSUMIDOR FINAL\",\r\n \"merchant_registration\": \"0000000-00\"\r\n },\r\n \"payment_form\": {\r\n \"payment_form_id\": 1,\r\n \"payment_method_id\": 10,\r\n \"payment_due_date\": \"2025-11-07\",\r\n \"duration_measure\": \"0\"\r\n },\r\n \"allowance_charges\": [\r\n {\r\n \"discount_id\": 1,\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"840336.13\"\r\n }\r\n ],\r\n \"legal_monetary_totals\": {\r\n \"line_extension_amount\": \"840336.13\",\r\n \"tax_exclusive_amount\": \"840336.13\",\r\n \"tax_inclusive_amount\": \"1000000.00\",\r\n \"allowance_total_amount\": \"0.00\",\r\n \"charge_total_amount\": \"0.00\",\r\n \"payable_amount\": \"1000000.00\"\r\n },\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"159663.86\",\r\n \"percent\": \"19\",\r\n \"taxable_amount\": \"840336.13\"\r\n }\r\n ],\r\n \"invoice_lines\": [\r\n {\r\n \"unit_measure_id\": 70,\r\n \"invoiced_quantity\": \"1\",\r\n \"line_extension_amount\": \"840336.13\",\r\n \"free_of_charge_indicator\": false,\r\n \"allowance_charges\": [\r\n {\r\n \"charge_indicator\": false,\r\n \"allowance_charge_reason\": \"DESCUENTO GENERAL\",\r\n \"amount\": \"0.00\",\r\n \"base_amount\": \"1000000.00\"\r\n }\r\n ],\r\n \"tax_totals\": [\r\n {\r\n \"tax_id\": 1,\r\n \"tax_amount\": \"159663.86\",\r\n \"taxable_amount\": \"840336.13\",\r\n \"percent\": \"19.00\"\r\n }\r\n ],\r\n \"description\": \"COMISION POR SERVICIOS\",\r\n \"code\": \"COMISION\",\r\n \"type_item_identification_id\": 4,\r\n \"price_amount\": \"840336.13\",\r\n \"base_quantity\": \"1\"\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/invoice", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "invoice" ] }, "description": "# 👤 FACTURA - CONSUMIDOR FINAL (222222222222)\n\nEndpoint para facturas sin datos completos del cliente usando identificación genérica 222222222222. Simplifica ventas al público sin identificar comprador. Campos: customer.identification_number = \"222222222222\", customer.name = \"CONSUMIDOR FINAL\". Aplica: retail, ventas mostrador, no requiere datos fiscales completos. type_document_identification_id = 22 (consumidor final). Útil: alto volumen de ventas, clientes no identificados. XML válido con cliente genérico según normativa DIAN." }, "response": [] } ], "description": "Este request permite enviar documento electronico sin tener que llenar los datos del cliente" }, { "name": "06 - Utilidades", "item": [ { "name": "Register-Update Customer", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "type": "text", "value": "application/json" }, { "key": "cache-control", "type": "text", "value": "no-cache" }, { "key": "Connection", "type": "text", "value": "keep-alive" }, { "key": "Accept-Encoding", "type": "text", "value": "gzip, deflate" }, { "key": "Host", "type": "text", "value": "localhost", "disabled": true }, { "key": "accept", "type": "text", "value": "application/json" }, { "key": "X-CSRF-TOKEN", "type": "text", "value": "" } ], "body": { "mode": "raw", "raw": "{\r\n \"identification_number\": 89008003,\r\n\t\"dv\": null,\r\n\t\"name\": \"ALEXANDER OBANDO LONDOÑO.\",\r\n\t\"phone\": 3103891693,\r\n\t\"address\": \"LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\r\n\t\"email\": \"alexander_obando@hotmail.com\",\r\n \"sendnotification\": true\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/register-update-customer", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "register-update-customer" ] }, "description": "# 👥 REGISTRAR/ACTUALIZAR DATOS DE CLIENTE\n\n## 📄 Descripción General\n\nEndpoint para **registrar nuevos clientes** o **actualizar información existente** en la base de datos de la API. Permite mantener actualizados los datos de contacto de clientes para facturación electrónica, como email, teléfono, dirección, etc. Identifica al cliente por `identification_number` y actualiza o crea el registro.\n\n**Características clave:**\n- **Operación:** Upsert (insert/update automático)\n- **Identificador:** identification_number\n- **Campos actualizables:** name, email, phone, address\n- **Notificación:** Envío opcional de email al cliente\n- **Sin parámetros URL:** Toda la información en el body\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPUT {{url}}/api/ubl2.1/register-update-customer\n```\n\n**Características:**\n- **Método:** PUT (actualización/creación)\n- **Autenticación:** Bearer token (obligatorio)\n- **Body:** JSON con datos del cliente\n- **Respuesta:** Confirmación de registro/actualización\n\n---\n\n## 🔑 Campos del Body\n\n| Campo | Tipo | Requerido | Descripción |\n|-------|------|-----------|-------------|\n| **identification_number** | integer | **Sí** | **NIT/Cédula del cliente** |\n| **dv** | integer/null | No | Dígito de verificación |\n| **name** | string | **Sí** | Nombre o razón social |\n| **phone** | integer | No | Teléfono de contacto |\n| **address** | string | No | Dirección física |\n| **email** | string | **Sí** | Email para envío de facturas |\n| **sendnotification** | boolean | No | Enviar email de confirmación |\n\n### Body Ejemplo\n\n```json\n{\n \"identification_number\": 89008003,\n \"dv\": null,\n \"name\": \"ALEXANDER OBANDO LONDOÑO\",\n \"phone\": 3103891693,\n \"address\": \"LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\n \"email\": \"alexander_obando@hotmail.com\",\n \"sendnotification\": true\n}\n```\n\n---\n\n## 📝 Notas Críticas sobre Gestión de Clientes\n\n### 📌 1. Operación Upsert (Insert/Update)\n\n**Funcionamiento:**\n\n```javascript\nconst registerUpdateCustomer = async (data) => {\n // Buscar cliente por identification_number\n const existing = await db.customers\n .where('identification_number', data.identification_number)\n .first();\n \n if (existing) {\n // Cliente existe: ACTUALIZAR\n await db.customers\n .where('id', existing.id)\n .update({\n name: data.name,\n email: data.email,\n phone: data.phone,\n address: data.address,\n updated_at: new Date()\n });\n return { action: 'updated', customer_id: existing.id };\n } else {\n // Cliente NO existe: CREAR\n const newCustomer = await db.customers.insert({\n identification_number: data.identification_number,\n dv: data.dv,\n name: data.name,\n email: data.email,\n phone: data.phone,\n address: data.address,\n created_at: new Date()\n });\n return { action: 'created', customer_id: newCustomer.id };\n }\n};\n```\n\n**Crítico:** No necesitas verificar si existe antes de llamar al endpoint.\n\n### 📌 2. Identificador Único (identification_number)\n\n```json\n{\n \"identification_number\": 89008003 // Cédula o NIT\n}\n```\n\n**Comportamiento:**\n- Es el **campo clave** para identificar al cliente\n- Si existe: actualiza el registro\n- Si NO existe: crea nuevo registro\n- Debe ser único en la base de datos\n\n**Ejemplos:**\n```json\n// Persona natural\n{\"identification_number\": 12345678}\n\n// Empresa\n{\"identification_number\": 900123456}\n\n// Extranjero (pasaporte)\n{\"identification_number\": \"AB1234567\"} // Como string si tiene letras\n```\n\n### 📌 3. Dígito de Verificación (dv)\n\n```json\n{\n \"identification_number\": 900123456,\n \"dv\": 7 // Dígito verificación para NIT empresas\n}\n```\n\n**Cuándo usar:**\n- **Empresas (NIT):** Incluir dv calculado\n- **Personas naturales:** dv = null\n- **Extranjeros:** dv = null\n\n**Cálculo DV (algoritmo DIAN):**\n```javascript\nconst calculateDV = (nit) => {\n const primes = [3, 7, 13, 17, 19, 23, 29, 37, 41, 43, 47, 53, 59, 67, 71];\n let sum = 0;\n const nitArray = nit.toString().split('').reverse();\n \n nitArray.forEach((digit, index) => {\n sum += parseInt(digit) * primes[index];\n });\n \n const remainder = sum % 11;\n return remainder > 1 ? 11 - remainder : remainder;\n};\n\n// Ejemplo\nconst nit = 900123456;\nconst dv = calculateDV(nit); // dv = 7\n```\n\n### 📌 4. Email: Campo Crítico\n\n```json\n{\n \"email\": \"alexander_obando@hotmail.com\" // Obligatorio\n}\n```\n\n**Importancia:**\n- Usado para envío de facturas electrónicas\n- Obligatorio según normativa DIAN\n- Debe ser email válido y activo\n- Sistema valida formato\n\n**Validación:**\n```javascript\nconst isValidEmail = (email) => {\n const regex = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/;\n return regex.test(email);\n};\n\nif (!isValidEmail(data.email)) {\n throw new Error('Email inválido');\n}\n```\n\n**Múltiples emails:**\nSi necesitas enviar a varios emails, usa el campo `email_cc_list` en el envío de factura (NO en este endpoint).\n\n### 📌 5. Notificación al Cliente (sendnotification)\n\n```json\n{\n \"sendnotification\": true // Enviar email al cliente\n}\n```\n\n**Comportamiento:**\n- `true`: Envía email informando registro/actualización\n- `false` o ausente: No envía notificación\n- Email incluye datos actualizados\n\n**Contenido email notificación:**\n```\nAsunto: Actualización de Datos - [Empresa]\n\nEstimado [nombre_cliente],\n\nSus datos han sido actualizados en nuestro sistema:\n\nIdentificación: 89008003\nNombre: ALEXANDER OBANDO LONDOÑO\nEmail: alexander_obando@hotmail.com\nTeléfono: 3103891693\n\nEste email se usará para envío de facturas electrónicas.\n\nSaludos,\n[Empresa Emisora]\n```\n\n### 📌 6. Actualización Parcial de Campos\n\n**Escenario:** Solo actualizar email\n\n```json\n// Mínimo requerido\n{\n \"identification_number\": 89008003,\n \"name\": \"ALEXANDER OBANDO LONDOÑO\", // Obligatorio\n \"email\": \"nuevo_email@ejemplo.com\" // Nuevo email\n // phone, address, dv pueden omitirse (mantienen valor actual)\n}\n```\n\n**Comportamiento:**\n- Campos enviados: se actualizan\n- Campos omitidos: mantienen valor existente\n- Campos obligatorios: `identification_number`, `name`, `email`\n\n### 📌 7. Casos de Uso Comunes\n\n**A. Actualizar Email de Cliente Existente**\n```json\nPUT /api/ubl2.1/register-update-customer\n{\n \"identification_number\": 12345678,\n \"name\": \"JUAN PÉREZ\",\n \"email\": \"juan.nuevo@email.com\", // Email actualizado\n \"sendnotification\": true\n}\n```\n\n**B. Registrar Nuevo Cliente**\n```json\nPUT /api/ubl2.1/register-update-customer\n{\n \"identification_number\": 87654321, // Nuevo\n \"name\": \"MARÍA LÓPEZ\",\n \"email\": \"maria@email.com\",\n \"phone\": 3001234567,\n \"address\": \"Calle 123 # 45-67\",\n \"sendnotification\": true\n}\n```\n\n**C. Actualizar Teléfono y Dirección**\n```json\nPUT /api/ubl2.1/register-update-customer\n{\n \"identification_number\": 89008003,\n \"name\": \"ALEXANDER OBANDO LONDOÑO\",\n \"email\": \"alexander_obando@hotmail.com\",\n \"phone\": 3209876543, // Nuevo teléfono\n \"address\": \"Nueva dirección MZ 10 CS 5\" // Nueva dirección\n}\n```\n\n### 📌 8. Respuesta Exitosa\n\n**Cliente actualizado:**\n```json\n{\n \"success\": true,\n \"message\": \"Cliente actualizado exitosamente\",\n \"action\": \"updated\",\n \"customer\": {\n \"id\": 12345,\n \"identification_number\": 89008003,\n \"name\": \"ALEXANDER OBANDO LONDOÑO\",\n \"email\": \"alexander_obando@hotmail.com\",\n \"phone\": 3103891693,\n \"address\": \"LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\n \"updated_at\": \"2025-11-21T10:30:00Z\"\n },\n \"notification_sent\": true\n}\n```\n\n**Cliente creado:**\n```json\n{\n \"success\": true,\n \"message\": \"Cliente registrado exitosamente\",\n \"action\": \"created\",\n \"customer\": {\n \"id\": 12346,\n \"identification_number\": 87654321,\n \"name\": \"MARÍA LÓPEZ\",\n \"email\": \"maria@email.com\",\n \"created_at\": \"2025-11-21T10:31:00Z\"\n },\n \"notification_sent\": true\n}\n```\n\n### 📌 9. Validaciones del Sistema\n\n**Al recibir request, sistema valida:**\n\n✓ `identification_number` presente y no vacío \n✓ `name` presente y no vacío \n✓ `email` presente y formato válido \n✓ `email` no está en blacklist \n✓ `phone` formato numérico (si presente) \n✓ Token de autenticación válido \n✓ Longitud name < 255 caracteres \n✓ Longitud address < 500 caracteres \n\n```javascript\nconst validateCustomer = (data) => {\n if (!data.identification_number) {\n throw new Error('identification_number requerido');\n }\n if (!data.name || data.name.trim() === '') {\n throw new Error('name requerido');\n }\n if (!data.email || !isValidEmail(data.email)) {\n throw new Error('email inválido');\n }\n if (data.name.length > 255) {\n throw new Error('name muy largo (máx 255 caracteres)');\n }\n return true;\n};\n```\n\n### 📌 10. Errores Comunes\n\n| Error | Causa | Solución |\n|-------|-------|----------|\n| \"identification_number required\" | Campo faltante | Incluir identification_number |\n| \"Invalid email format\" | Email malformado | Verificar formato email |\n| \"Email in blacklist\" | Email bloqueado | Usar otro email o remover de blacklist |\n| \"name required\" | Campo vacío | Incluir nombre/razón social |\n| \"Unauthorized\" | Token inválido | Verificar Bearer token |\n| \"Duplicate identification_number\" | Conflicto (raro) | Verificar si ya existe |\n\n### 📌 11. Integración con Facturación\n\n**Flujo recomendado:**\n\n```javascript\n// 1. Registrar/actualizar cliente\nconst customerData = {\n identification_number: 89008003,\n name: \"ALEXANDER OBANDO LONDOÑO\",\n email: \"alexander_obando@hotmail.com\",\n phone: 3103891693,\n address: \"LIMONAR MZ 6 CS 3 ET 1 PISO 2\"\n};\n\nawait api.put('/api/ubl2.1/register-update-customer', customerData);\n\n// 2. Usar datos en factura\nconst invoiceData = {\n number: 990000123,\n customer: {\n identification_number: 89008003,\n name: \"ALEXANDER OBANDO LONDOÑO\",\n email: \"alexander_obando@hotmail.com\",\n phone: 3103891693,\n address: \"LIMONAR MZ 6 CS 3 ET 1 PISO 2\",\n // ... demás campos customer\n },\n invoice_lines: [...]\n};\n\nawait api.post('/api/ubl2.1/invoice', invoiceData);\n```\n\n**Beneficio:** Datos de cliente siempre actualizados para futuras facturas.\n\n### 📌 12. Consulta de Clientes\n\n**Para verificar si cliente existe:**\n\n```bash\n# Buscar por NIT/Cédula\nGET /api/ubl2.1/customers?identification_number=89008003\n\n# O consultar tabla directamente (SQL)\nSELECT * FROM customers \nWHERE identification_number = 89008003;\n```\n\n### 📌 13. Campos Adicionales (Opcionales)\n\nEste endpoint acepta campos básicos. Para datos completos de cliente en facturas, incluir en el objeto `customer` del invoice:\n\n```json\n\"customer\": {\n \"identification_number\": 89008003,\n \"name\": \"...\",\n \"email\": \"...\",\n \"phone\": \"...\",\n \"address\": \"...\",\n // Campos adicionales solo en invoice:\n \"type_document_identification_id\": 3,\n \"type_organization_id\": 2,\n \"municipality_id\": 149,\n \"type_regime_id\": 2,\n \"type_liability_id\": 49,\n \"merchant_registration\": \"0000-00\"\n}\n```\n\n### 📌 14. Masivo: Actualizar Múltiples Clientes\n\n**Para actualizar varios clientes:**\n\n```javascript\nconst customers = [\n {identification_number: 12345678, name: \"Cliente 1\", email: \"c1@mail.com\"},\n {identification_number: 87654321, name: \"Cliente 2\", email: \"c2@mail.com\"},\n {identification_number: 11223344, name: \"Cliente 3\", email: \"c3@mail.com\"}\n];\n\n// Procesar en lote\nfor (const customer of customers) {\n await api.put('/api/ubl2.1/register-update-customer', customer);\n await sleep(100); // Delay para evitar rate limiting\n}\n```\n\n**Mejor práctica:** Implementar queue/jobs para lotes grandes (>100 clientes).\n\n### 📌 15. Resumen: Gestión de Clientes\n\n- **Propósito:** Mantener datos de clientes actualizados\n- **Operación:** Upsert (crea o actualiza automáticamente)\n- **Identificador:** identification_number (único)\n- **Campos clave:** name, email (obligatorios)\n- **Notificación:** Opcional con sendnotification\n- **Uso:** Antes de facturar o cuando cambien datos\n- **Validación:** Email formato válido y no en blacklist\n- **Respuesta:** Incluye action (created/updated)\n- **Integración:** Datos disponibles para futuras facturas\n- **Endpoint:** PUT /api/ubl2.1/register-update-customer" }, "response": [] }, { "name": "Certificate End Date", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "type": "text", "value": "application/json" }, { "key": "cache-control", "type": "text", "value": "no-cache" }, { "key": "Connection", "type": "text", "value": "keep-alive" }, { "key": "Accept-Encoding", "type": "text", "value": "gzip, deflate" }, { "key": "Host", "type": "text", "value": "apidian2026-8.oo", "disabled": true }, { "key": "accept", "type": "text", "value": "application/json" }, { "key": "X-CSRF-TOKEN", "type": "text", "value": "" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/certificate-end-date", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "certificate-end-date" ] }, "description": "# 📜 CONSULTAR FECHA DE VENCIMIENTO DEL CERTIFICADO DIGITAL\n\n## 📄 Descripción General\n\nEndpoint para **consultar la fecha de expiración** del certificado digital (.pfx o .p12) configurado en la API. Este certificado se usa para **firmar digitalmente** todos los documentos electrónicos (facturas, notas crédito, notas débito, etc.) enviados a la DIAN.\n\n**Características clave:**\n- **Operación:** Consulta (solo lectura)\n- **Body:** Vacío (no requiere parámetros)\n- **Respuesta:** Fecha de vencimiento del certificado\n- **Uso:** Monitoreo y alertas de vencimiento\n- **Certificado:** El configurado en Paso 1 - Config Company\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPUT {{url}}/api/ubl2.1/certificate-end-date\n```\n\n**Características:**\n- **Método:** PUT (aunque es consulta, usa PUT por convención de la API)\n- **Autenticación:** Bearer token (obligatorio)\n- **Body:** Vacío (empty string)\n- **Respuesta:** JSON con fecha de expiración\n\n---\n\n## 🔑 Parámetros de la Petición\n\n**Body:** Vacío\n\n```json\n// Body debe ir vacío\n\"\"\n```\n\n**Headers requeridos:**\n\n| Header | Valor | Descripción |\n|--------|-------|-------------|\n| **Authorization** | Bearer {{token}} | Token de autenticación |\n| **Accept** | application/json | Formato de respuesta |\n\n---\n\n## 📝 Notas Críticas sobre Certificados Digitales\n\n### 📌 1. Certificado Digital: ¿Qué es?\n\n**Definición:** \nArchivo .pfx o .p12 emitido por **entidad certificadora autorizada** (Certicámara, GSE, etc.) que contiene:\n- **Clave privada:** Para firmar documentos\n- **Certificado público:** Para verificar firmas\n- **Cadena de certificación:** Validación de autoridad\n\n**Uso en facturación electrónica:**\n```javascript\n// Cada documento se firma con el certificado\nconst signDocument = async (xmlDocument, certificate) => {\n const signature = crypto.sign(\n 'RSA-SHA256',\n Buffer.from(xmlDocument),\n {\n key: certificate.privateKey,\n passphrase: certificate.password\n }\n );\n \n // Firma se incluye en XML enviado a DIAN\n return xmlDocument + signature;\n};\n```\n\n**Sin certificado válido:** No se pueden enviar documentos a DIAN.\n\n### 📌 2. Respuesta del Endpoint\n\n**Respuesta exitosa:**\n\n```json\n{\n \"success\": true,\n \"message\": \"Certificado consultado exitosamente\",\n \"certificate\": {\n \"subject\": \"CN=EMPRESA EJEMPLO SAS, OID.2.5.4.5=900123456-7, L=BOGOTÁ, C=CO\",\n \"issuer\": \"CN=AC CERTICÁMARA S.A., C=CO\",\n \"serial_number\": \"1A2B3C4D5E6F7890\",\n \"valid_from\": \"2024-01-15T00:00:00Z\",\n \"valid_to\": \"2026-01-15T23:59:59Z\",\n \"days_remaining\": 420,\n \"status\": \"valid\"\n },\n \"alerts\": {\n \"critical\": false,\n \"warning\": false,\n \"message\": \"Certificado válido por 420 días\"\n }\n}\n```\n\n**Campos de la respuesta:**\n\n| Campo | Tipo | Descripción |\n|-------|------|-------------|\n| **valid_to** | datetime | Fecha exacta de vencimiento |\n| **valid_from** | datetime | Fecha inicio de validez |\n| **days_remaining** | integer | Días hasta vencimiento |\n| **status** | string | Estado: valid, expiring, expired |\n| **subject** | string | Datos del titular (empresa) |\n| **issuer** | string | Entidad certificadora |\n| **serial_number** | string | Número de serie único |\n\n### 📌 3. Estados del Certificado\n\n**Estado: VALID (Válido)**\n\n```json\n{\n \"status\": \"valid\",\n \"days_remaining\": 420,\n \"alerts\": {\n \"critical\": false,\n \"warning\": false\n }\n}\n```\n\n**Condición:** `days_remaining > 90` \n**Acción:** Ninguna (sistema operando normalmente)\n\n---\n\n**Estado: EXPIRING (Por vencer)**\n\n```json\n{\n \"status\": \"expiring\",\n \"days_remaining\": 45,\n \"alerts\": {\n \"critical\": false,\n \"warning\": true,\n \"message\": \"⚠️ Certificado vence en 45 días. Renovar pronto.\"\n }\n}\n```\n\n**Condición:** `days_remaining <= 90 && days_remaining > 30` \n**Acción:** Planificar renovación\n\n---\n\n**Estado: CRITICAL (Crítico)**\n\n```json\n{\n \"status\": \"expiring\",\n \"days_remaining\": 15,\n \"alerts\": {\n \"critical\": true,\n \"warning\": true,\n \"message\": \"🚨 URGENTE: Certificado vence en 15 días. Renovar INMEDIATAMENTE.\"\n }\n}\n```\n\n**Condición:** `days_remaining <= 30 && days_remaining > 0` \n**Acción:** Renovar urgente\n\n---\n\n**Estado: EXPIRED (Vencido)**\n\n```json\n{\n \"status\": \"expired\",\n \"days_remaining\": -10,\n \"alerts\": {\n \"critical\": true,\n \"warning\": true,\n \"message\": \"❌ Certificado VENCIDO hace 10 días. NO se pueden firmar documentos.\"\n },\n \"error\": \"Certificate expired\"\n}\n```\n\n**Condición:** `days_remaining <= 0` \n**Acción:** Sistema bloqueado para envío DIAN hasta renovar certificado\n\n### 📌 4. Cálculo de Días Restantes\n\n```javascript\nconst calculateDaysRemaining = (validToDate) => {\n const now = new Date();\n const expirationDate = new Date(validToDate);\n \n const diffTime = expirationDate.getTime() - now.getTime();\n const diffDays = Math.ceil(diffTime / (1000 * 60 * 60 * 24));\n \n return diffDays;\n};\n\n// Ejemplo\nconst validTo = \"2026-01-15T23:59:59Z\";\nconst daysRemaining = calculateDaysRemaining(validTo);\n// daysRemaining = 420\n\nconst status = daysRemaining > 90 ? 'valid' :\n daysRemaining > 30 ? 'expiring' :\n daysRemaining > 0 ? 'critical' : 'expired';\n```\n\n### 📌 5. Sistema de Alertas Automáticas\n\n**Monitoreo recomendado:**\n\n```javascript\n// Cron job diario para monitorear certificado\nconst monitorCertificate = async () => {\n const response = await api.put('/api/ubl2.1/certificate-end-date');\n const { days_remaining, status } = response.certificate;\n \n // Alerta 90 días antes\n if (days_remaining === 90) {\n sendEmail({\n to: 'admin@empresa.com',\n subject: '⚠️ Certificado vence en 90 días',\n body: `Iniciar proceso de renovación.`\n });\n }\n \n // Alerta 30 días antes (crítica)\n if (days_remaining === 30) {\n sendEmail({\n to: 'admin@empresa.com, ceo@empresa.com',\n subject: '🚨 URGENTE: Certificado vence en 30 días',\n body: `Renovar certificado INMEDIATAMENTE.`\n });\n sendSMS('+573001234567', 'Certificado vence en 30 días');\n }\n \n // Alerta certificado vencido\n if (status === 'expired') {\n sendEmail({\n to: 'admin@empresa.com',\n subject: '❌ Certificado VENCIDO - Sistema bloqueado',\n body: `No se pueden enviar documentos a DIAN. Renovar urgente.`\n });\n // Desactivar envíos automáticos\n await disableAutomaticInvoicing();\n }\n};\n\n// Ejecutar diariamente a las 8:00 AM\ncron.schedule('0 8 * * *', monitorCertificate);\n```\n\n### 📌 6. Renovación de Certificado\n\n**Proceso de renovación:**\n\n```bash\n# 1. Solicitar nuevo certificado a entidad certificadora\n# (Certicámara, GSE, Andes SCD, etc.)\n\n# 2. Descargar nuevo archivo .pfx o .p12\n\n# 3. Actualizar en API usando Paso 1 - Config Company\nPUT /api/ubl2.1/config/software\n{\n \"certificate\": \"\",\n \"certificate_password\": \"nueva_contraseña\"\n}\n\n# 4. Verificar nueva fecha de vencimiento\nPUT /api/ubl2.1/certificate-end-date\n\n# 5. Confirmar que sistema está operativo\n```\n\n**Tiempo de procesamiento:** 1-2 semanas (solicitud a entidad certificadora)\n\n**Recomendación:** Renovar con **90 días de anticipación**\n\n### 📌 7. Errores Comunes\n\n| Error | Causa | Solución |\n|-------|-------|----------|\n| \"Certificate not found\" | No hay certificado configurado | Ejecutar Paso 1 - Config Company |\n| \"Certificate expired\" | Certificado vencido | Renovar certificado urgente |\n| \"Invalid certificate\" | Certificado corrupto/inválido | Recargar certificado válido |\n| \"Unauthorized\" | Token inválido | Verificar Bearer token |\n| \"Cannot read certificate\" | Error lectura archivo .pfx | Verificar password certificado |\n\n### 📌 8. Uso en Dashboard Administrativo\n\n**Componente React para monitoreo:**\n\n```javascript\nimport React, { useState, useEffect } from 'react';\n\nconst CertificateMonitor = () => {\n const [cert, setCert] = useState(null);\n \n useEffect(() => {\n const fetchCertificate = async () => {\n const response = await fetch(\n 'http://api.example.com/api/ubl2.1/certificate-end-date',\n {\n method: 'PUT',\n headers: {\n 'Authorization': `Bearer ${token}`,\n 'Accept': 'application/json'\n }\n }\n );\n const data = await response.json();\n setCert(data.certificate);\n };\n \n fetchCertificate();\n // Actualizar cada hora\n const interval = setInterval(fetchCertificate, 3600000);\n return () => clearInterval(interval);\n }, []);\n \n if (!cert) return
Cargando...
;\n \n const getStatusColor = () => {\n if (cert.status === 'expired') return 'red';\n if (cert.days_remaining <= 30) return 'red';\n if (cert.days_remaining <= 90) return 'orange';\n return 'green';\n };\n \n return (\n
\n

📜 Certificado Digital

\n
\n

Estado: {cert.status.toUpperCase()}

\n

Vence: {new Date(cert.valid_to).toLocaleDateString()}

\n

Días restantes: {cert.days_remaining}

\n
\n {cert.alerts?.warning && (\n
{cert.alerts.message}
\n )}\n
\n );\n};\n```\n\n### 📌 9. Integración con Sistema de Logs\n\n**Registrar consultas:**\n\n```javascript\nconst logCertificateCheck = async (response) => {\n await db.logs.insert({\n action: 'certificate_check',\n timestamp: new Date(),\n days_remaining: response.certificate.days_remaining,\n status: response.certificate.status,\n valid_to: response.certificate.valid_to,\n user_id: currentUser.id\n });\n};\n\n// Al consultar certificado\nconst response = await checkCertificate();\nlogCertificateCheck(response);\n```\n\n**Consulta histórica:**\n```sql\nSELECT \n DATE(timestamp) as date,\n days_remaining,\n status\nFROM logs\nWHERE action = 'certificate_check'\nORDER BY timestamp DESC\nLIMIT 30;\n```\n\n### 📌 10. Validación Antes de Enviar Documentos\n\n**Verificar certificado antes de facturar:**\n\n```javascript\nconst sendInvoiceWithValidation = async (invoiceData) => {\n // 1. Verificar estado del certificado\n const certResponse = await api.put('/api/ubl2.1/certificate-end-date');\n \n if (certResponse.certificate.status === 'expired') {\n throw new Error(\n '❌ No se puede enviar factura: Certificado vencido. ' +\n 'Contacte al administrador para renovar el certificado.'\n );\n }\n \n if (certResponse.certificate.days_remaining <= 0) {\n throw new Error('Certificado vencido');\n }\n \n // 2. Alertar si está por vencer\n if (certResponse.certificate.days_remaining <= 30) {\n console.warn(\n `⚠️ ADVERTENCIA: Certificado vence en ${certResponse.certificate.days_remaining} días`\n );\n }\n \n // 3. Proceder con envío de factura\n const invoiceResponse = await api.post('/api/ubl2.1/invoice', invoiceData);\n return invoiceResponse;\n};\n```\n\n### 📌 11. Certificado en Ambiente de Pruebas vs Producción\n\n**Ambiente de Pruebas (Habilitación DIAN):**\n- Certificado de **prueba** emitido por DIAN\n- Válido solo para ambiente test\n- Gratis, se descarga del portal DIAN\n\n**Ambiente de Producción:**\n- Certificado **real** emitido por entidad certificadora\n- Costo: $300,000 - $500,000 COP/año\n- Obligatorio para facturación real\n\n```javascript\nconst getEnvironment = () => {\n // Detectar ambiente por URL o configuración\n const isDev = process.env.DIAN_ENVIRONMENT === 'test';\n return isDev ? 'PRUEBAS' : 'PRODUCCIÓN';\n};\n```\n\n### 📌 12. Información del Titular (Subject)\n\n**Campo `subject` contiene:**\n\n```\nCN=EMPRESA EJEMPLO SAS, OID.2.5.4.5=900123456-7, L=BOGOTÁ, C=CO\n```\n\n**Desglose:**\n- **CN:** Common Name (nombre empresa)\n- **OID.2.5.4.5:** NIT con dígito de verificación\n- **L:** Locality (ciudad)\n- **C:** Country (país)\n\n**Validación:**\n```javascript\nconst validateCertificateSubject = (subject) => {\n // Verificar que NIT en certificado coincida con empresa\n const nitMatch = subject.match(/OID\\.2\\.5\\.4\\.5=([0-9-]+)/);\n const certNIT = nitMatch ? nitMatch[1] : null;\n \n if (certNIT !== company.nit) {\n throw new Error(\n `NIT en certificado (${certNIT}) no coincide con empresa (${company.nit})`\n );\n }\n};\n```\n\n### 📌 13. Backup del Certificado\n\n**Recomendaciones de seguridad:**\n\n```bash\n# 1. Guardar certificado en múltiples ubicaciones\n/secure/certificates/empresa.pfx # Servidor producción\n/backup/certificates/empresa.pfx # Servidor backup\n/offline/certificates/empresa.pfx # USB/disco externo\n\n# 2. Cifrar certificado en backups\nopenssl enc -aes-256-cbc -salt \\\n -in empresa.pfx \\\n -out empresa.pfx.encrypted\n\n# 3. Documentar password en lugar seguro\n# (Administrador de contraseñas empresarial)\n```\n\n**Nunca:** Subir certificado a repositorio Git público\n\n### 📌 14. Notificaciones por Email/SMS\n\n**Template email de alerta:**\n\n```html\n\n\n\n

⚠️ Alerta: Certificado Digital Por Vencer

\n

El certificado digital de su empresa está próximo a vencer:

\n \n
    \n
  • Empresa: {{company_name}}
    • \n
  • NIT: {{nit}}
    • \n
  • Fecha vencimiento: {{valid_to}}
    • \n
  • Días restantes: {{days_remaining}} días
    • \n
\n \n

\n Acción requerida: Renovar certificado con entidad certificadora.\n

\n \n

Sin certificado válido NO podrá emitir facturas electrónicas.

\n \n

Saludos,
Sistema de Facturación Electrónica

\n\n\n```\n\n### 📌 15. Resumen: Gestión de Certificados\n\n- **Propósito:** Consultar vencimiento del certificado digital\n- **Certificado:** El configurado en Paso 1 - Config Company\n- **Body:** Vacío (sin parámetros)\n- **Respuesta:** Fecha vencimiento y días restantes\n- **Estados:** valid (>90 días), expiring (30-90 días), critical (<30 días), expired\n- **Renovación:** Con 90 días de anticipación\n- **Monitoreo:** Cron job diario recomendado\n- **Alertas:** Email/SMS en hitos críticos (90, 30, 0 días)\n- **Impacto:** Sin certificado válido, no se pueden firmar documentos\n- **Entidades:** Certicámara, GSE, Andes SCD\n- **Costo:** $300,000-$500,000 COP/año\n- **Endpoint:** PUT /api/ubl2.1/certificate-end-date" }, "response": [] }, { "name": "Next Consecutive", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "type": "text", "value": "application/json" }, { "key": "cache-control", "type": "text", "value": "no-cache" }, { "key": "Connection", "type": "text", "value": "keep-alive" }, { "key": "Accept-Encoding", "type": "text", "value": "gzip, deflate" }, { "key": "Host", "type": "text", "value": "apidian2026-8.oo", "disabled": true }, { "key": "accept", "type": "text", "value": "application/json" }, { "key": "X-CSRF-TOKEN", "type": "text", "value": "" } ], "body": { "mode": "raw", "raw": "{\r\n \"type_document_id\": 9,\r\n \"prefix\": \"NI\"\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/next-consecutive", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "next-consecutive" ] }, "description": "# 🔢 CONSULTAR SIGUIENTE CONSECUTIVO DISPONIBLE\n\n## 📄 Descripción General\n\nEndpoint para **consultar el próximo número consecutivo disponible** para un tipo de documento específico. Permite conocer cuál será el siguiente número de factura, nota crédito, nota débito, etc., antes de crear el documento, evitando duplicados y garantizando la secuencia numérica correcta.\n\n**Características clave:**\n- **Operación:** Consulta (solo lectura)\n- **Parámetros:** type_document_id + prefix (opcional)\n- **Respuesta:** Próximo número consecutivo disponible\n- **Uso:** Validación y preview antes de crear documentos\n- **Secuencia:** Incrementa automáticamente al emitir documentos\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/next-consecutive\n```\n\n**Características:**\n- **Método:** POST (aunque es consulta, usa POST para enviar body)\n- **Autenticación:** Bearer token (obligatorio)\n- **Body:** JSON con type_document_id y prefix\n- **Respuesta:** Número consecutivo disponible\n\n---\n\n## 🔑 Campos del Body\n\n| Campo | Tipo | Requerido | Descripción |\n|-------|------|-----------|-------------|\n| **type_document_id** | integer | **Sí** | ID del tipo de documento |\n| **prefix** | string | No | Prefijo de numeración (si aplica) |\n\n### Body Ejemplo\n\n```json\n{\n \"type_document_id\": 9,\n \"prefix\": \"NI\"\n}\n```\n\n---\n\n## 📝 Notas Críticas sobre Consecutivos\n\n### 📌 1. Tipos de Documento (type_document_id)\n\n**Tabla de tipos de documento:**\n\n| ID | Tipo | Descripción | Ejemplo Consecutivo |\n|----|------|-------------|---------------------|\n| **1** | Factura Electrónica | Factura de venta | FV-990001234 |\n| **4** | Nota Crédito | Anulación/devolución | NC-10 |\n| **5** | Nota Débito | Cargo adicional | ND-25 |\n| **9** | Nota de Ajuste | Documento soporte | NI-5678 |\n| **11** | Documento Soporte | Adquisiciones | DS-10001 |\n| **13** | NC Documento Soporte | NC para doc. soporte | NCDS-50 |\n| **15** | ND Documento Soporte | ND para doc. soporte | NDDS-12 |\n\n**Ejemplo de consulta por tipo:**\n\n```javascript\n// Consultar siguiente factura electrónica\nconst getNextInvoice = async () => {\n const response = await api.post('/api/ubl2.1/next-consecutive', {\n type_document_id: 1,\n prefix: 'FV'\n });\n return response.next_consecutive; // 990001234\n};\n\n// Consultar siguiente nota crédito\nconst getNextCreditNote = async () => {\n const response = await api.post('/api/ubl2.1/next-consecutive', {\n type_document_id: 4,\n prefix: 'NC'\n });\n return response.next_consecutive; // 11\n};\n```\n\n### 📌 2. Prefijos de Numeración\n\n**¿Qué es un prefijo?**\n\nCadena de texto que antecede al número consecutivo:\n\n```\nFV-990001234\n^^ ^^^^^^^^\n| └─ Número consecutivo\n└─ Prefijo\n```\n\n**Ejemplos de prefijos:**\n\n```json\n// Factura con prefijo \"FV\"\n{\n \"type_document_id\": 1,\n \"prefix\": \"FV\" // Resultado: FV-990001234\n}\n\n// Factura con prefijo \"SETP\"\n{\n \"type_document_id\": 1,\n \"prefix\": \"SETP\" // Resultado: SETP-100\n}\n\n// Sin prefijo (null o vacío)\n{\n \"type_document_id\": 1,\n \"prefix\": null // Resultado: 990001234\n}\n```\n\n**Múltiples prefijos:**\n\nUna empresa puede tener varios prefijos para el mismo tipo de documento:\n\n```javascript\n// Prefijo por sucursal\nconst bogota = { type_document_id: 1, prefix: 'BOG' }; // BOG-1000\nconst medellin = { type_document_id: 1, prefix: 'MED' }; // MED-500\nconst cali = { type_document_id: 1, prefix: 'CALI' }; // CALI-300\n\n// Prefijo por tipo de venta\nconst contado = { type_document_id: 1, prefix: 'CONT' }; // CONT-5000\nconst credito = { type_document_id: 1, prefix: 'CRED' }; // CRED-2000\n```\n\n### 📌 3. Respuesta del Endpoint\n\n**Respuesta exitosa:**\n\n```json\n{\n \"success\": true,\n \"message\": \"Consecutivo consultado exitosamente\",\n \"data\": {\n \"type_document_id\": 9,\n \"prefix\": \"NI\",\n \"next_consecutive\": 5679,\n \"full_number\": \"NI-5679\",\n \"resolution\": {\n \"resolution_number\": \"18760000001\",\n \"from\": 5000,\n \"to\": 10000,\n \"remaining\": 4321\n }\n }\n}\n```\n\n**Campos de la respuesta:**\n\n| Campo | Tipo | Descripción |\n|-------|------|-------------|\n| **next_consecutive** | integer | Próximo número disponible |\n| **full_number** | string | Número completo (prefix + consecutivo) |\n| **prefix** | string | Prefijo usado |\n| **type_document_id** | integer | Tipo de documento consultado |\n| **resolution.from** | integer | Inicio rango autorizado DIAN |\n| **resolution.to** | integer | Fin rango autorizado DIAN |\n| **resolution.remaining** | integer | Consecutivos restantes |\n\n### 📌 4. Uso Antes de Crear Documento\n\n**Flujo recomendado:**\n\n```javascript\nconst createInvoiceWithValidation = async (invoiceData) => {\n // 1. Consultar siguiente consecutivo\n const consecutiveResponse = await api.post(\n '/api/ubl2.1/next-consecutive',\n {\n type_document_id: 1,\n prefix: 'FV'\n }\n );\n \n const nextNumber = consecutiveResponse.data.next_consecutive;\n console.log(`Próxima factura: FV-${nextNumber}`);\n \n // 2. Validar que no exceda el rango autorizado\n const { resolution } = consecutiveResponse.data;\n if (nextNumber > resolution.to) {\n throw new Error(\n `❌ Consecutivo ${nextNumber} excede rango autorizado ` +\n `(${resolution.from} - ${resolution.to}). ` +\n `Solicitar nueva resolución DIAN.`\n );\n }\n \n // 3. Alerta si quedan pocos consecutivos\n if (resolution.remaining < 100) {\n console.warn(\n `⚠️ ADVERTENCIA: Solo quedan ${resolution.remaining} consecutivos. ` +\n `Solicitar nueva resolución pronto.`\n );\n }\n \n // 4. Crear factura con el consecutivo\n const invoice = {\n ...invoiceData,\n number: nextNumber,\n prefix: 'FV',\n type_document_id: 1\n };\n \n const response = await api.post('/api/ubl2.1/invoice', invoice);\n return response;\n};\n```\n\n### 📌 5. Secuencia Automática de Consecutivos\n\n**Comportamiento del sistema:**\n\n```javascript\n// Estado inicial\nconst state = {\n last_used: 5678,\n next_consecutive: 5679\n};\n\n// Consulta 1\nawait api.post('/api/ubl2.1/next-consecutive', {...});\n// Respuesta: 5679\n\n// Se crea documento con número 5679\nawait api.post('/api/ubl2.1/invoice', { number: 5679, ... });\n\n// Consulta 2 (después de crear documento)\nawait api.post('/api/ubl2.1/next-consecutive', {...});\n// Respuesta: 5680 (incrementó automáticamente)\n\n// Consulta 3 (sin crear documento)\nawait api.post('/api/ubl2.1/next-consecutive', {...});\n// Respuesta: 5680 (mantiene el mismo mientras no se use)\n```\n\n**Importante:** El consecutivo NO se reserva al consultarlo, solo se incrementa al crear el documento.\n\n### 📌 6. Validación de Rango DIAN\n\n**Resolución de numeración:**\n\nLa DIAN autoriza rangos de consecutivos mediante resoluciones:\n\n```json\n{\n \"resolution_number\": \"18760000001\",\n \"resolution_date\": \"2024-01-15\",\n \"prefix\": \"FV\",\n \"from\": 990000001,\n \"to\": 995000000,\n \"technical_key\": \"fc8eac422eba16e22ffd8c6f94b3f40a6e38162c\"\n}\n```\n\n**Validación de rango:**\n\n```javascript\nconst validateConsecutiveInRange = (consecutive, resolution) => {\n if (consecutive < resolution.from) {\n throw new Error(\n `Consecutivo ${consecutive} inferior al rango ` +\n `(${resolution.from} - ${resolution.to})`\n );\n }\n \n if (consecutive > resolution.to) {\n throw new Error(\n `❌ RANGO AGOTADO: Consecutivo ${consecutive} excede ` +\n `el límite ${resolution.to}. Solicitar nueva resolución DIAN.`\n );\n }\n \n return true;\n};\n```\n\n### 📌 7. Alertas de Consecutivos Agotándose\n\n**Sistema de monitoreo:**\n\n```javascript\nconst checkConsecutiveStatus = async () => {\n const response = await api.post('/api/ubl2.1/next-consecutive', {\n type_document_id: 1,\n prefix: 'FV'\n });\n \n const { remaining, to, next_consecutive } = response.data.resolution;\n const percentageUsed = ((to - remaining) / to) * 100;\n \n // Alerta 90% usado\n if (percentageUsed >= 90) {\n sendEmail({\n to: 'admin@empresa.com',\n subject: '🚨 URGENTE: Consecutivos agotándose',\n body: `Solo quedan ${remaining} consecutivos de ${to}. ` +\n `Solicitar nueva resolución INMEDIATAMENTE.`\n });\n }\n \n // Alerta 95% usado\n if (percentageUsed >= 95) {\n sendSMS('+573001234567', \n `CRÍTICO: ${remaining} consecutivos restantes`);\n // Bloquear nuevas facturas hasta obtener resolución\n await disableInvoicing();\n }\n};\n\n// Ejecutar diariamente\ncron.schedule('0 9 * * *', checkConsecutiveStatus);\n```\n\n### 📌 8. Múltiples Resoluciones (Prefijos)\n\n**Escenario:** Empresa con 3 sucursales\n\n```javascript\nconst sucursales = [\n {\n name: 'Bogotá',\n prefix: 'BOG',\n resolution: {\n from: 1000,\n to: 5000,\n next: 1234\n }\n },\n {\n name: 'Medellín',\n prefix: 'MED',\n resolution: {\n from: 1000,\n to: 3000,\n next: 1567\n }\n },\n {\n name: 'Cali',\n prefix: 'CALI',\n resolution: {\n from: 1000,\n to: 2000,\n next: 1890\n }\n }\n];\n\n// Consultar consecutivo por sucursal\nconst getConsecutiveBySucursal = async (sucursalPrefix) => {\n const response = await api.post('/api/ubl2.1/next-consecutive', {\n type_document_id: 1,\n prefix: sucursalPrefix\n });\n return response.data.next_consecutive;\n};\n\n// Uso\nconst nextBogota = await getConsecutiveBySucursal('BOG'); // 1234\nconst nextMedellin = await getConsecutiveBySucursal('MED'); // 1567\n```\n\n### 📌 9. Errores Comunes\n\n| Error | Causa | Solución |\n|-------|-------|----------|\n| \"type_document_id required\" | Campo faltante | Incluir type_document_id |\n| \"Invalid type_document_id\" | ID no válido | Usar ID válido (1, 4, 5, 9, 11, 13, 15) |\n| \"Resolution not found\" | Sin resolución para prefix | Verificar prefix configurado |\n| \"Consecutive range exhausted\" | Rango agotado | Solicitar nueva resolución DIAN |\n| \"Unauthorized\" | Token inválido | Verificar Bearer token |\n\n### 📌 10. Consulta Sin Prefijo\n\n**Si la empresa NO usa prefijos:**\n\n```json\n{\n \"type_document_id\": 1,\n \"prefix\": null\n}\n\n// O simplemente omitir el campo\n{\n \"type_document_id\": 1\n}\n```\n\n**Respuesta:**\n\n```json\n{\n \"next_consecutive\": 990001234,\n \"full_number\": \"990001234\",\n \"prefix\": null\n}\n```\n\n### 📌 11. Preview en UI/Formularios\n\n**Mostrar próximo consecutivo en formulario:**\n\n```javascript\nimport React, { useState, useEffect } from 'react';\n\nconst InvoiceForm = () => {\n const [nextNumber, setNextNumber] = useState(null);\n \n useEffect(() => {\n const fetchNextConsecutive = async () => {\n const response = await api.post(\n '/api/ubl2.1/next-consecutive',\n {\n type_document_id: 1,\n prefix: 'FV'\n }\n );\n setNextNumber(response.data.full_number);\n };\n \n fetchNextConsecutive();\n }, []);\n \n return (\n
\n
\n \n \n Este número se asignará automáticamente\n
\n {/* Demás campos del formulario */}\n
\n );\n};\n```\n\n### 📌 12. Auditoría de Consecutivos\n\n**Registrar consultas:**\n\n```javascript\nconst logConsecutiveQuery = async (type_document_id, prefix, result) => {\n await db.logs.insert({\n action: 'consecutive_query',\n type_document_id,\n prefix,\n next_consecutive: result.next_consecutive,\n remaining: result.resolution?.remaining,\n timestamp: new Date(),\n user_id: currentUser.id\n });\n};\n```\n\n**Reporte de uso:**\n\n```sql\nSELECT \n DATE(timestamp) as fecha,\n type_document_id,\n prefix,\n COUNT(*) as consultas,\n MAX(next_consecutive) as ultimo_consecutivo\nFROM logs\nWHERE action = 'consecutive_query'\nGROUP BY DATE(timestamp), type_document_id, prefix\nORDER BY fecha DESC\nLIMIT 30;\n```\n\n### 📌 13. Sincronización Multi-Usuario\n\n**Problema:** Dos usuarios consultan al mismo tiempo\n\n```javascript\n// Usuario A consulta (10:00:00)\nconst responseA = await api.post('/api/ubl2.1/next-consecutive', {...});\n// Respuesta: 5679\n\n// Usuario B consulta (10:00:01) antes que A cree factura\nconst responseB = await api.post('/api/ubl2.1/next-consecutive', {...});\n// Respuesta: 5679 (MISMO número)\n\n// Usuario A crea factura 5679 (10:00:05)\nawait api.post('/api/ubl2.1/invoice', { number: 5679, ... });\n// ✅ Éxito\n\n// Usuario B intenta crear factura 5679 (10:00:10)\nawait api.post('/api/ubl2.1/invoice', { number: 5679, ... });\n// ❌ Error: \"Duplicate consecutive number\"\n```\n\n**Solución:** No enviar el número, dejar que la API lo asigne automáticamente:\n\n```javascript\n// NO enviar \"number\" en el body\nconst invoice = {\n // number: 5679, ❌ NO incluir\n type_document_id: 1,\n prefix: 'FV',\n customer: {...},\n invoice_lines: [...]\n};\n\n// La API asigna el consecutivo automáticamente\nconst response = await api.post('/api/ubl2.1/invoice', invoice);\nconsole.log(`Factura creada: ${response.data.number}`);\n```\n\n### 📌 14. Tipos de Documento Especiales\n\n**Documento Soporte (type_document_id: 11):**\n\n```json\n{\n \"type_document_id\": 11,\n \"prefix\": \"DS\"\n}\n```\n\n**Uso:** Facturas de compra a proveedores sin factura electrónica\n\n---\n\n**Nota de Ajuste (type_document_id: 9):**\n\n```json\n{\n \"type_document_id\": 9,\n \"prefix\": \"NI\"\n}\n```\n\n**Uso:** Ajustes internos, notas de ingreso\n\n### 📌 15. Resumen: Gestión de Consecutivos\n\n- **Propósito:** Consultar próximo número consecutivo disponible\n- **Parámetros:** type_document_id (obligatorio) + prefix (opcional)\n- **Respuesta:** Número consecutivo y datos de resolución\n- **Secuencia:** Incrementa automáticamente al crear documentos\n- **Prefijos:** Permiten múltiples numeraciones por tipo\n- **Validación:** Verifica rango autorizado por DIAN\n- **Alertas:** Monitorear cuando quedan <10% de consecutivos\n- **Multi-usuario:** No reserva número, solo consulta\n- **Best practice:** Dejar que API asigne número automáticamente\n- **Resolución:** Rango (from-to) autorizado por DIAN\n- **Endpoint:** POST /api/ubl2.1/next-consecutive" }, "response": [] }, { "name": "Verify DIAN State", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Content-Type", "type": "text", "value": "application/json" }, { "key": "cache-control", "type": "text", "value": "no-cache" }, { "key": "Connection", "type": "text", "value": "keep-alive" }, { "key": "Accept-Encoding", "type": "text", "value": "gzip, deflate" }, { "key": "Host", "type": "text", "value": "apidian2026-8.oo", "disabled": true }, { "key": "accept", "type": "text", "value": "application/json" }, { "key": "X-CSRF-TOKEN", "type": "text", "value": "" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/verify-dian-state", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "verify-dian-state" ] }, "description": "# 🔍 VERIFICAR ESTADO DEL SERVICIO DIAN\n\n## 📄 Descripción General\n\nEndpoint para **verificar la disponibilidad y estado operativo** de los servicios web de la DIAN. Permite comprobar si los servidores de la DIAN están en línea y disponibles para recibir documentos electrónicos antes de intentar enviar facturas, notas crédito, o cualquier otro documento.\n\n**Características clave:**\n- **Operación:** Consulta de estado (health check)\n- **Body:** Vacío (no requiere parámetros)\n- **Respuesta:** Estado de servicios DIAN (online/offline)\n- **Uso:** Validación antes de enviar documentos\n- **Timeout:** Consulta rápida (<5 segundos)\n\n---\n\n## 📋 URL del Endpoint\n\n```\nGET {{url}}/api/ubl2.1/verify-dian-state\n```\n\n**Características:**\n- **Método:** GET (consulta simple)\n- **Autenticación:** Bearer token (obligatorio)\n- **Body:** Vacío (sin parámetros)\n- **Respuesta:** JSON con estado de servicios DIAN\n\n---\n\n## 🔑 Parámetros de la Petición\n\n**Body:** Vacío\n\n```json\n// Body vacío (método GET)\n```\n\n**Headers requeridos:**\n\n| Header | Valor | Descripción |\n|--------|-------|-------------|\n| **Authorization** | Bearer {{token}} | Token de autenticación |\n| **Accept** | application/json | Formato de respuesta |\n\n---\n\n## 📝 Notas Críticas sobre Verificación DIAN\n\n### 📌 1. Respuesta del Endpoint\n\n**DIAN en línea (servicios disponibles):**\n\n```json\n{\n \"success\": true,\n \"message\": \"Servicios DIAN operativos\",\n \"dian_state\": {\n \"status\": \"online\",\n \"environment\": \"production\",\n \"services\": {\n \"document_reception\": {\n \"available\": true,\n \"url\": \"https://vpfe.dian.gov.co/WcfDianCustomerServices.svc\",\n \"response_time_ms\": 245\n },\n \"document_validation\": {\n \"available\": true,\n \"url\": \"https://catalogo-vpfe.dian.gov.co/\",\n \"response_time_ms\": 180\n },\n \"document_query\": {\n \"available\": true,\n \"url\": \"https://vpfe.dian.gov.co/WcfDianCustomerServices.svc\",\n \"response_time_ms\": 320\n }\n },\n \"last_check\": \"2025-11-21T10:30:45Z\",\n \"uptime_percentage\": 99.87\n }\n}\n```\n\n**DIAN fuera de línea (servicios no disponibles):**\n\n```json\n{\n \"success\": false,\n \"message\": \"Servicios DIAN no disponibles\",\n \"dian_state\": {\n \"status\": \"offline\",\n \"environment\": \"production\",\n \"services\": {\n \"document_reception\": {\n \"available\": false,\n \"url\": \"https://vpfe.dian.gov.co/WcfDianCustomerServices.svc\",\n \"error\": \"Connection timeout\",\n \"response_time_ms\": null\n },\n \"document_validation\": {\n \"available\": false,\n \"url\": \"https://catalogo-vpfe.dian.gov.co/\",\n \"error\": \"Service unavailable\",\n \"response_time_ms\": null\n },\n \"document_query\": {\n \"available\": false,\n \"url\": \"https://vpfe.dian.gov.co/WcfDianCustomerServices.svc\",\n \"error\": \"Connection refused\",\n \"response_time_ms\": null\n }\n },\n \"last_check\": \"2025-11-21T10:30:45Z\",\n \"downtime_since\": \"2025-11-21T09:15:00Z\"\n },\n \"recommendation\": \"Esperar a que servicios DIAN estén disponibles antes de enviar documentos\"\n}\n```\n\n### 📌 2. Estados de Servicio\n\n**Estado: ONLINE (Operativo)**\n\n```json\n{\n \"status\": \"online\",\n \"services\": {\n \"document_reception\": {\"available\": true}\n }\n}\n```\n\n**Significado:**\n- ✅ Servicios DIAN disponibles\n- ✅ Se pueden enviar documentos\n- ✅ Respuestas rápidas (<5 segundos)\n\n---\n\n**Estado: OFFLINE (Fuera de línea)**\n\n```json\n{\n \"status\": \"offline\",\n \"services\": {\n \"document_reception\": {\n \"available\": false,\n \"error\": \"Connection timeout\"\n }\n }\n}\n```\n\n**Significado:**\n- ❌ Servicios DIAN no disponibles\n- ❌ No enviar documentos (fallarán)\n- ⏸️ Activar modo cola/contingencia\n\n---\n\n**Estado: DEGRADED (Degradado)**\n\n```json\n{\n \"status\": \"degraded\",\n \"services\": {\n \"document_reception\": {\n \"available\": true,\n \"response_time_ms\": 8500 // Lento\n }\n }\n}\n```\n\n**Significado:**\n- ⚠️ Servicios lentos pero funcionales\n- ⚠️ Envíos tomarán más tiempo\n- ⚠️ Posibles timeouts en lotes grandes\n\n### 📌 3. Uso Antes de Enviar Documentos\n\n**Validación recomendada:**\n\n```javascript\nconst sendInvoiceWithDianCheck = async (invoiceData) => {\n // 1. Verificar estado DIAN\n const dianState = await api.get('/api/ubl2.1/verify-dian-state');\n \n if (dianState.dian_state.status === 'offline') {\n // DIAN offline: No enviar, guardar en cola\n console.error('❌ DIAN fuera de línea. Documento guardado en cola.');\n \n await queueDocument({\n type: 'invoice',\n data: invoiceData,\n queued_at: new Date(),\n reason: 'dian_offline'\n });\n \n return {\n success: false,\n message: 'Documento en cola. Se enviará cuando DIAN esté disponible.',\n queued: true\n };\n }\n \n if (dianState.dian_state.status === 'degraded') {\n // DIAN lenta: Advertir pero permitir envío\n console.warn('⚠️ ADVERTENCIA: Servicios DIAN lentos. Envío puede tardar.');\n }\n \n // 2. DIAN online: Proceder con envío\n const response = await api.post('/api/ubl2.1/invoice', invoiceData);\n return response;\n};\n```\n\n### 📌 4. Sistema de Cola para DIAN Offline\n\n**Implementación de cola:**\n\n```javascript\nconst queueDocument = async (document) => {\n // Guardar en tabla queue_documents\n await db.queue_documents.insert({\n type: document.type,\n data: JSON.stringify(document.data),\n status: 'pending',\n queued_at: new Date(),\n reason: document.reason,\n retry_count: 0\n });\n};\n\nconst processQueue = async () => {\n // 1. Verificar estado DIAN\n const dianState = await api.get('/api/ubl2.1/verify-dian-state');\n \n if (dianState.dian_state.status !== 'online') {\n console.log('DIAN aún offline. Cola no procesada.');\n return;\n }\n \n // 2. DIAN online: Procesar documentos en cola\n const pending = await db.queue_documents\n .where('status', 'pending')\n .orderBy('queued_at', 'asc')\n .limit(10);\n \n for (const doc of pending) {\n try {\n const data = JSON.parse(doc.data);\n \n // Enviar documento\n await api.post(`/api/ubl2.1/${doc.type}`, data);\n \n // Marcar como procesado\n await db.queue_documents\n .where('id', doc.id)\n .update({\n status: 'sent',\n sent_at: new Date()\n });\n \n console.log(`✅ Documento ${doc.id} enviado desde cola`);\n \n } catch (error) {\n // Incrementar retry count\n await db.queue_documents\n .where('id', doc.id)\n .update({\n retry_count: doc.retry_count + 1,\n last_error: error.message\n });\n \n console.error(`❌ Error enviando documento ${doc.id}:`, error);\n }\n }\n};\n\n// Ejecutar cada 5 minutos\ncron.schedule('*/5 * * * *', processQueue);\n```\n\n### 📌 5. Monitoreo Continuo del Estado DIAN\n\n**Dashboard en tiempo real:**\n\n```javascript\nimport React, { useState, useEffect } from 'react';\n\nconst DianStatusMonitor = () => {\n const [dianState, setDianState] = useState(null);\n const [history, setHistory] = useState([]);\n \n useEffect(() => {\n const checkDianState = async () => {\n const response = await api.get('/api/ubl2.1/verify-dian-state');\n setDianState(response.dian_state);\n \n // Agregar a histórico\n setHistory(prev => [\n { status: response.dian_state.status, timestamp: new Date() },\n ...prev.slice(0, 19) // Últimos 20 checks\n ]);\n };\n \n // Check inicial\n checkDianState();\n \n // Actualizar cada 2 minutos\n const interval = setInterval(checkDianState, 120000);\n return () => clearInterval(interval);\n }, []);\n \n const getStatusColor = () => {\n if (!dianState) return 'gray';\n if (dianState.status === 'online') return 'green';\n if (dianState.status === 'degraded') return 'orange';\n return 'red';\n };\n \n return (\n
\n

🔍 Estado DIAN

\n
\n \n \n {dianState?.status.toUpperCase() || 'VERIFICANDO...'}\n \n
\n \n {dianState?.status === 'offline' && (\n
\n ❌ Servicios DIAN no disponibles.\n
Los documentos se guardarán en cola.\n
\n )}\n \n {dianState?.status === 'degraded' && (\n
\n ⚠️ Servicios DIAN lentos.\n
Los envíos pueden tardar más de lo normal.\n
\n )}\n \n
\n Uptime: {dianState?.uptime_percentage}%\n
\n \n
\n

Histórico (últimas 2 horas)

\n {history.map((item, idx) => (\n
\n {item.status} - {item.timestamp.toLocaleTimeString()}\n
\n ))}\n
\n
\n );\n};\n```\n\n### 📌 6. Alertas de DIAN Offline\n\n**Sistema de notificaciones:**\n\n```javascript\nlet lastDianStatus = 'online';\n\nconst checkAndNotifyDianState = async () => {\n const response = await api.get('/api/ubl2.1/verify-dian-state');\n const currentStatus = response.dian_state.status;\n \n // Cambió de online a offline\n if (lastDianStatus === 'online' && currentStatus === 'offline') {\n // Enviar alertas\n await sendEmail({\n to: 'admin@empresa.com',\n subject: '🚨 ALERTA: DIAN Fuera de Línea',\n body: `Los servicios DIAN están offline desde ${new Date().toLocaleString()}.\\n` +\n `Documentos se guardarán en cola hasta que servicios estén disponibles.`\n });\n \n await sendSMS(\n '+573001234567',\n 'ALERTA: DIAN offline. Documentos en cola.'\n );\n }\n \n // Cambió de offline a online (recuperación)\n if (lastDianStatus === 'offline' && currentStatus === 'online') {\n // Notificar recuperación\n await sendEmail({\n to: 'admin@empresa.com',\n subject: '✅ DIAN Recuperada: Servicios Online',\n body: `Los servicios DIAN están nuevamente disponibles.\\n` +\n `Procesando cola de documentos pendientes...`\n });\n \n // Iniciar procesamiento de cola\n await processQueue();\n }\n \n lastDianStatus = currentStatus;\n};\n\n// Ejecutar cada 3 minutos\ncron.schedule('*/3 * * * *', checkAndNotifyDianState);\n```\n\n### 📌 7. Tiempos de Respuesta (Performance)\n\n**Interpretación de response_time_ms:**\n\n| Tiempo | Estado | Acción |\n|--------|--------|--------|\n| **< 500ms** | Excelente | Enviar normalmente |\n| **500-2000ms** | Bueno | Enviar normalmente |\n| **2000-5000ms** | Lento | Advertir, enviar |\n| **> 5000ms** | Muy lento | Considerar cola |\n| **null** | Offline | Activar cola |\n\n```javascript\nconst evaluatePerformance = (responseTime) => {\n if (!responseTime) return 'offline';\n if (responseTime < 500) return 'excellent';\n if (responseTime < 2000) return 'good';\n if (responseTime < 5000) return 'slow';\n return 'very_slow';\n};\n```\n\n### 📌 8. Ambientes: Producción vs Habilitación\n\n**Ambiente de Producción:**\n\n```json\n{\n \"environment\": \"production\",\n \"services\": {\n \"document_reception\": {\n \"url\": \"https://vpfe.dian.gov.co/WcfDianCustomerServices.svc\"\n }\n }\n}\n```\n\n---\n\n**Ambiente de Habilitación (Pruebas):**\n\n```json\n{\n \"environment\": \"test\",\n \"services\": {\n \"document_reception\": {\n \"url\": \"https://vpfe-hab.dian.gov.co/WcfDianCustomerServices.svc\"\n }\n }\n}\n```\n\n**Importante:** Cada ambiente tiene sus propios servidores y disponibilidad independiente.\n\n### 📌 9. Errores Comunes\n\n| Error | Causa | Solución |\n|-------|-------|----------|\n| \"Connection timeout\" | DIAN no responde | Activar cola, reintentar después |\n| \"Service unavailable\" | DIAN en mantenimiento | Esperar 30-60 minutos |\n| \"SSL certificate error\" | Problema certificados | Verificar configuración SSL |\n| \"Unauthorized\" | Token inválido | Verificar Bearer token |\n| \"DNS resolution failed\" | Problema red/DNS | Verificar conexión internet |\n\n### 📌 10. Registro de Disponibilidad (Logs)\n\n**Guardar histórico:**\n\n```javascript\nconst logDianState = async (state) => {\n await db.dian_availability_logs.insert({\n status: state.status,\n environment: state.environment,\n document_reception_available: state.services.document_reception.available,\n response_time_ms: state.services.document_reception.response_time_ms,\n timestamp: new Date(),\n uptime_percentage: state.uptime_percentage\n });\n};\n\n// Al verificar estado\nconst dianState = await api.get('/api/ubl2.1/verify-dian-state');\nlogDianState(dianState.dian_state);\n```\n\n**Reporte de disponibilidad:**\n\n```sql\nSELECT \n DATE(timestamp) as fecha,\n COUNT(*) as total_checks,\n SUM(CASE WHEN status = 'online' THEN 1 ELSE 0 END) as online_count,\n SUM(CASE WHEN status = 'offline' THEN 1 ELSE 0 END) as offline_count,\n AVG(response_time_ms) as avg_response_time,\n (SUM(CASE WHEN status = 'online' THEN 1 ELSE 0 END) * 100.0 / COUNT(*)) as availability_percentage\nFROM dian_availability_logs\nWHERE timestamp >= DATE_SUB(NOW(), INTERVAL 30 DAY)\nGROUP BY DATE(timestamp)\nORDER BY fecha DESC;\n```\n\n### 📌 11. Integración con Contingencia Tipo 4\n\n**Activar contingencia si DIAN offline:**\n\n```javascript\nconst handleDianUnavailable = async () => {\n const dianState = await api.get('/api/ubl2.1/verify-dian-state');\n \n if (dianState.dian_state.status === 'offline') {\n // Verificar si contingencia está configurada\n const hasContingency = await checkContingencyResolution();\n \n if (hasContingency) {\n console.log('🔄 Activando Contingencia Tipo 4');\n \n // Cambiar modo a contingencia\n await db.config.update({\n invoicing_mode: 'contingency_type_4',\n activated_at: new Date()\n });\n \n // Notificar usuarios\n await notifyContingencyActivated();\n \n return 'contingency_active';\n } else {\n // Sin contingencia: Solo cola\n console.log('⏸️ Modo cola activado (sin contingencia configurada)');\n return 'queue_only';\n }\n }\n \n return 'normal';\n};\n```\n\n### 📌 12. Validación Masiva Antes de Lotes\n\n**Verificar antes de enviar 100+ facturas:**\n\n```javascript\nconst sendBatchInvoices = async (invoices) => {\n // 1. Verificar DIAN antes de iniciar lote\n const dianState = await api.get('/api/ubl2.1/verify-dian-state');\n \n if (dianState.dian_state.status !== 'online') {\n throw new Error(\n '❌ No se puede procesar lote: DIAN no disponible. ' +\n `Estado: ${dianState.dian_state.status}`\n );\n }\n \n // 2. Validar performance\n const avgResponseTime = dianState.dian_state.services.document_reception.response_time_ms;\n if (avgResponseTime > 3000) {\n console.warn(\n `⚠️ ADVERTENCIA: DIAN lenta (${avgResponseTime}ms). ` +\n `Lote de ${invoices.length} documentos puede tardar mucho.`\n );\n }\n \n // 3. Procesar lote con re-verificación periódica\n const results = [];\n for (let i = 0; i < invoices.length; i++) {\n // Re-verificar cada 50 documentos\n if (i % 50 === 0 && i > 0) {\n const recheck = await api.get('/api/ubl2.1/verify-dian-state');\n if (recheck.dian_state.status !== 'online') {\n console.error('DIAN cayó durante lote. Pausando...');\n break;\n }\n }\n \n const result = await api.post('/api/ubl2.1/invoice', invoices[i]);\n results.push(result);\n }\n \n return results;\n};\n```\n\n### 📌 13. Servicio de Terceros (Status Page)\n\n**Consultar estado DIAN desde fuentes externas:**\n\n```javascript\n// Algunas empresas tienen status pages públicos\nconst checkExternalDianStatus = async () => {\n // Ejemplo: Consultar si hay reportes en Twitter/X\n // O servicios de monitoreo de terceros\n \n // Combinar con verificación propia\n const ownCheck = await api.get('/api/ubl2.1/verify-dian-state');\n const externalCheck = await fetch('https://status.external-service.com/dian');\n \n return {\n own: ownCheck.dian_state.status,\n external: externalCheck.status\n };\n};\n```\n\n### 📌 14. Health Check en Infraestructura\n\n**Usar para health checks de la API:**\n\n```javascript\n// Endpoint de salud general\napp.get('/health', async (req, res) => {\n const checks = {\n database: await checkDatabase(),\n redis: await checkRedis(),\n dian: await checkDian(),\n certificate: await checkCertificate()\n };\n \n const allHealthy = Object.values(checks).every(c => c.status === 'ok');\n \n res.status(allHealthy ? 200 : 503).json({\n status: allHealthy ? 'healthy' : 'unhealthy',\n checks,\n timestamp: new Date()\n });\n});\n\nconst checkDian = async () => {\n try {\n const response = await api.get('/api/ubl2.1/verify-dian-state');\n return {\n status: response.dian_state.status === 'online' ? 'ok' : 'degraded',\n message: `DIAN ${response.dian_state.status}`\n };\n } catch (error) {\n return {\n status: 'error',\n message: error.message\n };\n }\n};\n```\n\n### 📌 15. Resumen: Verificación Estado DIAN\n\n- **Propósito:** Verificar disponibilidad de servicios DIAN\n- **Método:** GET (sin body)\n- **Respuesta:** Estado (online/offline/degraded) y tiempos\n- **Estados:** online (operativo), offline (no disponible), degraded (lento)\n- **Uso:** Validar antes de enviar documentos\n- **Cola:** Activar cuando DIAN offline\n- **Monitoreo:** Cron job cada 2-5 minutos\n- **Alertas:** Email/SMS cuando cambia estado\n- **Performance:** <500ms excelente, >5000ms muy lento\n- **Contingencia:** Activar Tipo 4 si DIAN prolongadamente offline\n- **Ambientes:** Producción y habilitación independientes\n- **Endpoint:** GET /api/ubl2.1/verify-dian-state" }, "response": [] }, { "name": "Change State Allow Seller Login", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "type": "text", "value": "application/json" }, { "key": "cache-control", "type": "text", "value": "no-cache" }, { "key": "Connection", "type": "text", "value": "keep-alive" }, { "key": "Accept-Encoding", "type": "text", "value": "gzip, deflate" }, { "key": "Host", "type": "text", "value": "apidian2026-8.oo", "disabled": true }, { "key": "accept", "type": "text", "value": "application/json" }, { "key": "X-CSRF-TOKEN", "type": "text", "value": "" } ], "body": { "mode": "raw", "raw": "{\r\n \"state\": true\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/change-allow-seller-login", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "change-allow-seller-login" ] }, "description": "# 🔐 CAMBIAR ESTADO DE ACCESO AL PORTAL DE VENDEDORES\n\n## 📄 Descripción General\n\nEndpoint para **habilitar o deshabilitar el acceso** al portal web de vendedores. Permite al administrador controlar si los vendedores (usuarios con rol \"seller\") pueden iniciar sesión en el portal de facturación. Útil para mantenimiento, auditorías, o bloquear acceso temporalmente sin eliminar cuentas.\n\n**Características clave:**\n- **Operación:** Cambio de configuración global\n- **Parámetro:** state (true/false)\n- **Alcance:** Afecta a TODOS los vendedores\n- **Efecto:** Inmediato (sin reinicio)\n- **Reversible:** Puede activarse/desactivarse en cualquier momento\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/change-allow-seller-login\n```\n\n**Características:**\n- **Método:** POST\n- **Autenticación:** Bearer token (obligatorio - solo admin)\n- **Body:** JSON con campo state\n- **Respuesta:** Confirmación del nuevo estado\n\n---\n\n## 🔑 Campos del Body\n\n| Campo | Tipo | Requerido | Descripción |\n|-------|------|-----------|-------------|\n| **state** | boolean | **Sí** | true = permitir login, false = bloquear login |\n\n### Body Ejemplos\n\n**Habilitar acceso de vendedores:**\n\n```json\n{\n \"state\": true\n}\n```\n\n**Deshabilitar acceso de vendedores:**\n\n```json\n{\n \"state\": false\n}\n```\n\n---\n\n## 📝 Notas Críticas sobre Control de Acceso\n\n### 📌 1. ¿Qué hace este endpoint?\n\n**Comportamiento:**\n\n```javascript\n// state: true (PERMITIR acceso)\nconst enableSellerLogin = async () => {\n await api.post('/api/ubl2.1/change-allow-seller-login', {\n state: true\n });\n \n // Ahora los vendedores PUEDEN iniciar sesión\n // Resultado: Login exitoso\n};\n\n// state: false (BLOQUEAR acceso)\nconst disableSellerLogin = async () => {\n await api.post('/api/ubl2.1/change-allow-seller-login', {\n state: false\n });\n \n // Ahora los vendedores NO PUEDEN iniciar sesión\n // Resultado: Error \"Seller login disabled by administrator\"\n};\n```\n\n**Tabla de configuración afectada:**\n\n```sql\n-- Se actualiza en tabla system_configuration\nUPDATE system_configuration \nSET allow_seller_login = true/false\nWHERE company_id = {current_company};\n```\n\n### 📌 2. Respuesta del Endpoint\n\n**Acceso habilitado (state: true):**\n\n```json\n{\n \"success\": true,\n \"message\": \"Acceso de vendedores habilitado exitosamente\",\n \"config\": {\n \"allow_seller_login\": true,\n \"updated_at\": \"2025-11-21T10:30:45Z\",\n \"updated_by\": \"admin@empresa.com\"\n }\n}\n```\n\n**Acceso deshabilitado (state: false):**\n\n```json\n{\n \"success\": true,\n \"message\": \"Acceso de vendedores deshabilitado. Portal bloqueado para sellers.\",\n \"config\": {\n \"allow_seller_login\": false,\n \"updated_at\": \"2025-11-21T10:30:45Z\",\n \"updated_by\": \"admin@empresa.com\",\n \"reason\": \"Blocked by administrator\"\n },\n \"affected_users\": 15,\n \"note\": \"15 vendedores activos fueron bloqueados\"\n}\n```\n\n### 📌 3. Efecto en el Login de Vendedores\n\n**Con acceso HABILITADO (state: true):**\n\n```javascript\n// Vendedor intenta login\nPOST /api/login\n{\n \"email\": \"vendedor1@empresa.com\",\n \"password\": \"password123\"\n}\n\n// Respuesta: ✅ Login exitoso\n{\n \"success\": true,\n \"token\": \"abc123xyz...\",\n \"user\": {\n \"id\": 45,\n \"name\": \"Juan Vendedor\",\n \"email\": \"vendedor1@empresa.com\",\n \"role\": \"seller\"\n }\n}\n```\n\n---\n\n**Con acceso DESHABILITADO (state: false):**\n\n```javascript\n// Vendedor intenta login\nPOST /api/login\n{\n \"email\": \"vendedor1@empresa.com\",\n \"password\": \"password123\"\n}\n\n// Respuesta: ❌ Login rechazado\n{\n \"success\": false,\n \"error\": \"Login temporalmente deshabilitado\",\n \"message\": \"El acceso al portal de vendedores está bloqueado por el administrador. Contacte al departamento de TI.\",\n \"code\": \"SELLER_LOGIN_DISABLED\",\n \"contact\": \"admin@empresa.com\"\n}\n```\n\n**Código HTTP:** 403 Forbidden\n\n### 📌 4. ¿A quiénes afecta?\n\n**Afectados cuando state = false:**\n\n✅ **Bloqueados:**\n- Usuarios con rol `seller` (vendedores)\n- Solo el LOGIN está bloqueado\n- Sesiones activas NO se cierran automáticamente\n\n❌ **NO afectados:**\n- Usuarios con rol `admin` (administradores)\n- Usuarios con rol `accountant` (contadores)\n- API calls con token (si ya tienen sesión)\n\n```javascript\nconst isLoginAllowed = (user, config) => {\n // Admin siempre puede entrar\n if (user.role === 'admin') return true;\n \n // Accountant siempre puede entrar\n if (user.role === 'accountant') return true;\n \n // Seller: depende de configuración\n if (user.role === 'seller') {\n return config.allow_seller_login === true;\n }\n \n return false;\n};\n```\n\n### 📌 5. Casos de Uso Comunes\n\n**A. Mantenimiento del Sistema**\n\n```javascript\n// Antes de mantenimiento\nconst startMaintenance = async () => {\n // 1. Deshabilitar acceso vendedores\n await api.post('/api/ubl2.1/change-allow-seller-login', {\n state: false\n });\n \n // 2. Notificar vendedores activos\n await notifyActiveSellers(\n 'Sistema en mantenimiento. Acceso bloqueado por 2 horas.'\n );\n \n // 3. Realizar mantenimiento\n await performSystemMaintenance();\n \n // 4. Reactivar acceso\n await api.post('/api/ubl2.1/change-allow-seller-login', {\n state: true\n });\n \n console.log('✅ Mantenimiento completado. Acceso restaurado.');\n};\n```\n\n---\n\n**B. Auditoría o Investigación**\n\n```javascript\n// Bloquear durante auditoría\nconst lockForAudit = async () => {\n await api.post('/api/ubl2.1/change-allow-seller-login', {\n state: false\n });\n \n console.log('🔒 Sistema bloqueado para auditoría interna');\n \n // Realizar auditoría sin interferencia de vendedores\n await performAudit();\n \n // Desbloquear después\n await api.post('/api/ubl2.1/change-allow-seller-login', {\n state: true\n });\n};\n```\n\n---\n\n**C. Cierre de Mes (Bloqueo Temporal)**\n\n```javascript\n// Bloquear durante cierre contable\nconst monthEndClose = async () => {\n // Último día del mes\n await api.post('/api/ubl2.1/change-allow-seller-login', {\n state: false\n });\n \n // Contador genera reportes sin nuevas facturas\n await generateMonthlyReports();\n await reconcileAccounts();\n \n // Desbloquear primer día del mes\n await api.post('/api/ubl2.1/change-allow-seller-login', {\n state: true\n });\n};\n```\n\n---\n\n**D. Incidente de Seguridad**\n\n```javascript\n// Bloqueo de emergencia\nconst emergencyLockdown = async () => {\n // Detectar actividad sospechosa\n if (suspiciousActivityDetected) {\n // Bloquear inmediatamente\n await api.post('/api/ubl2.1/change-allow-seller-login', {\n state: false\n });\n \n // Alertar administradores\n await sendAlert({\n to: 'security@empresa.com',\n subject: '🚨 SEGURIDAD: Portal bloqueado',\n body: 'Actividad sospechosa detectada. Portal sellers bloqueado.'\n });\n \n // Cerrar sesiones activas\n await terminateAllSellerSessions();\n \n console.log('🚨 Bloqueo de emergencia activado');\n }\n};\n```\n\n### 📌 6. Sesiones Activas vs Nuevos Logins\n\n**Comportamiento importante:**\n\n```javascript\n// Estado inicial: allow_seller_login = true\n// Vendedor1 inicia sesión\nconst session1 = await login('vendedor1@empresa.com', 'pass');\n// ✅ Login exitoso, token: abc123\n\n// Admin deshabilita acceso\nawait api.post('/api/ubl2.1/change-allow-seller-login', {\n state: false\n});\n\n// Vendedor1 con sesión activa puede seguir usando la API\nawait api.post('/api/ubl2.1/invoice', {...}, {\n headers: { Authorization: 'Bearer abc123' }\n});\n// ✅ Funciona (token válido)\n\n// Vendedor2 intenta nuevo login\nconst session2 = await login('vendedor2@empresa.com', 'pass');\n// ❌ Error: \"Seller login disabled\"\n```\n\n**Para cerrar sesiones activas:**\n\n```javascript\nconst terminateAllSellerSessions = async () => {\n // Invalidar todos los tokens de sellers\n await db.tokens\n .where('user_role', 'seller')\n .update({\n revoked: true,\n revoked_at: new Date()\n });\n \n console.log('🔒 Todas las sesiones de vendedores cerradas');\n};\n```\n\n### 📌 7. Notificación a Vendedores\n\n**Mensaje en pantalla de login:**\n\n```javascript\nimport React, { useState, useEffect } from 'react';\n\nconst LoginPage = () => {\n const [sellerLoginAllowed, setSellerLoginAllowed] = useState(true);\n \n useEffect(() => {\n // Verificar estado de configuración\n const checkConfig = async () => {\n const config = await api.get('/api/system/config');\n setSellerLoginAllowed(config.allow_seller_login);\n };\n checkConfig();\n }, []);\n \n return (\n
\n

Iniciar Sesión

\n \n {!sellerLoginAllowed && (\n
\n ⚠️ Aviso: El acceso para vendedores está temporalmente deshabilitado.\n
Por favor contacte al administrador.\n
Email: admin@empresa.com\n
\n )}\n \n
\n \n \n \n
\n
\n );\n};\n```\n\n### 📌 8. Registro de Cambios (Auditoría)\n\n**Guardar histórico:**\n\n```javascript\nconst logAccessChange = async (state, adminUser) => {\n await db.audit_logs.insert({\n action: 'change_seller_login_access',\n new_state: state,\n admin_user_id: adminUser.id,\n admin_email: adminUser.email,\n timestamp: new Date(),\n ip_address: adminUser.ip,\n reason: adminUser.reason || 'Not specified'\n });\n};\n\n// Al cambiar estado\nawait api.post('/api/ubl2.1/change-allow-seller-login', { state: false });\nlogAccessChange(false, currentAdmin);\n```\n\n**Consultar histórico:**\n\n```sql\nSELECT \n timestamp,\n new_state,\n admin_email,\n reason\nFROM audit_logs\nWHERE action = 'change_seller_login_access'\nORDER BY timestamp DESC\nLIMIT 50;\n```\n\n**Resultado:**\n\n```\n2025-11-21 10:30:00 | false | admin@empresa.com | Mantenimiento sistema\n2025-11-21 08:00:00 | true | admin@empresa.com | Fin mantenimiento\n2025-11-20 23:00:00 | false | admin@empresa.com | Cierre de mes\n```\n\n### 📌 9. Dashboard de Control\n\n**Panel de administrador:**\n\n```javascript\nimport React, { useState, useEffect } from 'react';\n\nconst SellerAccessControl = () => {\n const [isEnabled, setIsEnabled] = useState(true);\n const [activeSellerCount, setActiveSellerCount] = useState(0);\n \n useEffect(() => {\n fetchAccessState();\n }, []);\n \n const fetchAccessState = async () => {\n const config = await api.get('/api/system/config');\n setIsEnabled(config.allow_seller_login);\n \n const stats = await api.get('/api/users/sellers/active');\n setActiveSellerCount(stats.count);\n };\n \n const toggleAccess = async () => {\n const newState = !isEnabled;\n \n const confirmed = confirm(\n newState \n ? '¿Habilitar acceso de vendedores?'\n : `¿Bloquear acceso? ${activeSellerCount} vendedores activos serán afectados.`\n );\n \n if (!confirmed) return;\n \n await api.post('/api/ubl2.1/change-allow-seller-login', {\n state: newState\n });\n \n setIsEnabled(newState);\n \n alert(\n newState \n ? '✅ Acceso de vendedores HABILITADO'\n : '🔒 Acceso de vendedores BLOQUEADO'\n );\n };\n \n return (\n
\n

🔐 Control de Acceso - Vendedores

\n \n
\n Estado actual: \n {isEnabled ? 'HABILITADO' : 'BLOQUEADO'}\n
\n \n
\n

Vendedores activos: {activeSellerCount}

\n

Total vendedores: {activeSellerCount + 5}

\n
\n \n \n \n {!isEnabled && (\n
\n ⚠️ Portal bloqueado. Los vendedores no pueden iniciar sesión.\n
\n )}\n
\n );\n};\n```\n\n### 📌 10. Automatización con Cron\n\n**Bloqueo automático fuera de horario:**\n\n```javascript\nconst cron = require('node-cron');\n\n// Bloquear a las 6:00 PM\ncron.schedule('0 18 * * *', async () => {\n await api.post('/api/ubl2.1/change-allow-seller-login', {\n state: false\n });\n console.log('🔒 Portal bloqueado fuera de horario (6:00 PM)');\n});\n\n// Habilitar a las 8:00 AM\ncron.schedule('0 8 * * 1-5', async () => { // Lunes a viernes\n await api.post('/api/ubl2.1/change-allow-seller-login', {\n state: true\n });\n console.log('✅ Portal habilitado horario laboral (8:00 AM)');\n});\n\n// Bloquear fines de semana\ncron.schedule('0 0 * * 6', async () => { // Sábado medianoche\n await api.post('/api/ubl2.1/change-allow-seller-login', {\n state: false\n });\n console.log('🔒 Portal bloqueado fin de semana');\n});\n```\n\n### 📌 11. Permisos de Administrador\n\n**Solo admins pueden usar este endpoint:**\n\n```javascript\n// Middleware de autorización\nconst requireAdmin = async (req, res, next) => {\n const user = await getUserFromToken(req.headers.authorization);\n \n if (user.role !== 'admin') {\n return res.status(403).json({\n success: false,\n error: 'Forbidden',\n message: 'Solo administradores pueden cambiar esta configuración'\n });\n }\n \n next();\n};\n\n// Aplicar middleware\napp.post('/api/ubl2.1/change-allow-seller-login', requireAdmin, handleChangeAccess);\n```\n\n### 📌 12. Errores Comunes\n\n| Error | Causa | Solución |\n|-------|-------|----------|\n| \"state required\" | Campo faltante | Incluir {\"state\": true/false} |\n| \"Invalid state value\" | state no es boolean | Usar true o false |\n| \"Forbidden\" | Usuario no es admin | Solo admins pueden usar endpoint |\n| \"Unauthorized\" | Token inválido | Verificar Bearer token |\n\n### 📌 13. Consultar Estado Actual\n\n**Verificar configuración:**\n\n```javascript\nconst getCurrentAccessState = async () => {\n const config = await api.get('/api/system/config');\n \n console.log(`Acceso vendedores: ${config.allow_seller_login ? 'HABILITADO' : 'BLOQUEADO'}`);\n \n return config.allow_seller_login;\n};\n\n// Uso\nconst isAllowed = await getCurrentAccessState();\nif (!isAllowed) {\n console.warn('⚠️ Portal bloqueado para vendedores');\n}\n```\n\n### 📌 14. Notificaciones Email\n\n**Notificar cambio de estado:**\n\n```javascript\nconst notifyAccessChange = async (newState) => {\n const sellers = await db.users\n .where('role', 'seller')\n .where('active', true)\n .select('email', 'name');\n \n const subject = newState \n ? '✅ Portal habilitado - Acceso restaurado'\n : '🔒 Portal bloqueado temporalmente';\n \n const body = newState \n ? 'El acceso al portal de vendedores ha sido restaurado. Ya puede iniciar sesión normalmente.'\n : 'El acceso al portal está temporalmente bloqueado por mantenimiento. Le notificaremos cuando esté disponible.';\n \n for (const seller of sellers) {\n await sendEmail({\n to: seller.email,\n subject,\n body: `Estimado ${seller.name},\\n\\n${body}\\n\\nSaludos,\\nEquipo TI`\n });\n }\n};\n\n// Al cambiar estado\nawait api.post('/api/ubl2.1/change-allow-seller-login', { state: false });\nawait notifyAccessChange(false);\n```\n\n### 📌 15. Resumen: Control de Acceso Vendedores\n\n- **Propósito:** Habilitar/deshabilitar login de vendedores\n- **Parámetro:** state (true = permitir, false = bloquear)\n- **Alcance:** TODOS los vendedores (rol \"seller\")\n- **Efecto:** Inmediato en nuevos logins\n- **Sesiones activas:** NO se cierran automáticamente\n- **Admins:** NO afectados (siempre pueden entrar)\n- **Casos de uso:** Mantenimiento, auditoría, cierre de mes\n- **Reversible:** Puede cambiar estado en cualquier momento\n- **Auditoría:** Registrar cambios con usuario y timestamp\n- **Notificación:** Informar vendedores por email\n- **Automatización:** Cron jobs para horarios laborales\n- **Endpoint:** POST /api/ubl2.1/change-allow-seller-login" }, "response": [] }, { "name": "Add To Blacklist", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "type": "text", "value": "application/json" }, { "key": "cache-control", "type": "text", "value": "no-cache" }, { "key": "Connection", "type": "text", "value": "keep-alive" }, { "key": "Accept-Encoding", "type": "text", "value": "gzip, deflate" }, { "key": "Host", "type": "text", "value": "apidian2026-8.oo", "disabled": true }, { "key": "accept", "type": "text", "value": "application/json" }, { "key": "X-CSRF-TOKEN", "type": "text", "value": "" } ], "body": { "mode": "raw", "raw": "{\r\n \"emails\": [\r\n {\r\n \"email\": \"mail1@mail.com\",\r\n \"banned\": true\r\n },\r\n {\r\n \"email\": \"mail2@mail.com\",\r\n \"banned\": false\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/emailblacklist/add", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "emailblacklist", "add" ] }, "description": "# 🚫 AGREGAR EMAILS A LA LISTA DE BLOQUEO (BLACKLIST)\n\n## 📄 Descripción General\n\nEndpoint para **agregar o actualizar emails en la lista de bloqueo**. Permite al administrador bloquear direcciones de email específicas para que NO reciban facturas electrónicas ni ninguna notificación del sistema. Útil para manejar devoluciones (bounces), emails inválidos, solicitudes de clientes, o cumplimiento de RGPD/privacidad.\n\n**Características clave:**\n- **Operación:** Agregar/actualizar emails en blacklist\n- **Parámetros:** Array de emails con estado banned\n- **Efecto:** Emails bloqueados no reciben facturas\n- **Masivo:** Permite agregar múltiples emails simultáneamente\n- **Reversible:** Puede desbloquearse posteriormente\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/emailblacklist/add\n```\n\n**Características:**\n- **Método:** POST\n- **Autenticación:** Bearer token (obligatorio)\n- **Body:** JSON con array de emails\n- **Respuesta:** Confirmación de emails bloqueados\n\n---\n\n## 🔑 Campos del Body\n\n| Campo | Tipo | Requerido | Descripción |\n|-------|------|-----------|-------------|\n| **emails** | array | **Sí** | Array de objetos email |\n| **emails[].email** | string | **Sí** | Dirección de email |\n| **emails[].banned** | boolean | **Sí** | true = bloquear, false = desbloquear |\n\n### Body Ejemplo\n\n**Bloquear múltiples emails:**\n\n```json\n{\n \"emails\": [\n {\n \"email\": \"mail1@mail.com\",\n \"banned\": true\n },\n {\n \"email\": \"mail2@mail.com\",\n \"banned\": false\n }\n ]\n}\n```\n\n---\n\n## 📝 Notas Críticas sobre Lista de Bloqueo\n\n### 📌 1. ¿Qué hace la Blacklist?\n\n**Funcionamiento:**\n\n```javascript\n// Email NO bloqueado (normal)\nconst sendInvoice = async (invoice) => {\n await sendEmail({\n to: 'cliente@mail.com', // Email normal\n subject: 'Factura electrónica',\n pdf: invoice.pdf,\n xml: invoice.xml\n });\n // ✅ Email enviado exitosamente\n};\n\n// Email bloqueado (en blacklist)\nconst sendInvoice = async (invoice) => {\n // Sistema verifica blacklist\n const isBlocked = await checkBlacklist('cliente_bloqueado@mail.com');\n \n if (isBlocked) {\n console.log('❌ Email bloqueado. NO se envía factura.');\n // Se guarda factura en DIAN pero NO se envía email\n return {\n invoice_sent_to_dian: true,\n email_sent: false,\n reason: 'Email in blacklist'\n };\n }\n};\n```\n\n**Tabla de blacklist:**\n\n```sql\n-- Estructura tabla email_blacklist\nCREATE TABLE email_blacklist (\n id INT PRIMARY KEY,\n email VARCHAR(255) UNIQUE,\n banned BOOLEAN DEFAULT true,\n reason VARCHAR(500),\n added_at TIMESTAMP,\n added_by INT, -- admin user id\n last_attempt TIMESTAMP -- último intento de envío bloqueado\n);\n```\n\n### 📌 2. Respuesta del Endpoint\n\n**Emails bloqueados exitosamente:**\n\n```json\n{\n \"success\": true,\n \"message\": \"2 emails procesados en blacklist\",\n \"results\": [\n {\n \"email\": \"mail1@mail.com\",\n \"banned\": true,\n \"action\": \"added\",\n \"message\": \"Email agregado a blacklist\"\n },\n {\n \"email\": \"mail2@mail.com\",\n \"banned\": false,\n \"action\": \"removed\",\n \"message\": \"Email removido de blacklist\"\n }\n ],\n \"summary\": {\n \"added\": 1,\n \"removed\": 1,\n \"total_blacklisted\": 25\n }\n}\n```\n\n### 📌 3. Campo banned: true vs false\n\n**banned: true (Bloquear email)**\n\n```json\n{\n \"emails\": [\n {\n \"email\": \"spam@mail.com\",\n \"banned\": true // ❌ NO recibirá facturas\n }\n ]\n}\n```\n\n**Efecto:**\n- Email agregado a blacklist\n- NO recibirá facturas electrónicas\n- NO recibirá notificaciones del sistema\n- Factura se envía a DIAN normalmente (solo no se envía email)\n\n---\n\n**banned: false (Desbloquear email)**\n\n```json\n{\n \"emails\": [\n {\n \"email\": \"cliente_corregido@mail.com\",\n \"banned\": false // ✅ Volverá a recibir facturas\n }\n ]\n}\n```\n\n**Efecto:**\n- Email removido de blacklist\n- Volverá a recibir facturas normalmente\n- Futuras facturas se enviarán\n\n### 📌 4. Casos de Uso Comunes\n\n**A. Email con Bounces (Devoluciones)**\n\n```javascript\n// Detectar bounce automático\nconst handleEmailBounce = async (bouncedEmail) => {\n console.log(`❌ Email devuelto: ${bouncedEmail}`);\n \n // Agregar a blacklist automáticamente\n await api.post('/api/ubl2.1/emailblacklist/add', {\n emails: [\n {\n email: bouncedEmail,\n banned: true\n }\n ]\n });\n \n // Notificar admin\n await sendAlert({\n to: 'admin@empresa.com',\n subject: '⚠️ Email bloqueado por bounce',\n body: `Email ${bouncedEmail} agregado a blacklist (rebote).`\n });\n};\n\n// Webhook de proveedor email (SendGrid, SES, etc.)\napp.post('/webhook/email/bounce', async (req, res) => {\n const { email, bounce_type } = req.body;\n \n if (bounce_type === 'hard') {\n // Hard bounce: Email no existe o dominio inválido\n await handleEmailBounce(email);\n }\n \n res.sendStatus(200);\n});\n```\n\n---\n\n**B. Solicitud de Cliente (RGPD/Privacidad)**\n\n```javascript\n// Cliente solicita no recibir emails\nconst handleOptOut = async (customerEmail, reason) => {\n await api.post('/api/ubl2.1/emailblacklist/add', {\n emails: [\n {\n email: customerEmail,\n banned: true\n }\n ]\n });\n \n // Guardar razón en logs\n await db.blacklist_logs.insert({\n email: customerEmail,\n action: 'opt_out',\n reason: reason || 'Customer request',\n timestamp: new Date()\n });\n \n // Confirmar al cliente\n await sendEmail({\n to: customerEmail,\n subject: 'Confirmación: No recibirá más emails',\n body: 'Su email ha sido removido de nuestra lista. ' +\n 'No recibirá más facturas por email (seguirá recibiendo documentos físicos).'\n });\n};\n```\n\n---\n\n**C. Email Inválido o Typo Detectado**\n\n```javascript\n// Detectar emails inválidos\nconst processInvalidEmails = async () => {\n const invalidEmails = [\n 'cliente@gmial.com', // Typo: gmial vs gmail\n 'test@test', // Sin TLD\n 'admin@localhost', // Email local\n 'noreply@example.com' // Email genérico\n ];\n \n const emailsToBlock = invalidEmails.map(email => ({\n email,\n banned: true\n }));\n \n await api.post('/api/ubl2.1/emailblacklist/add', {\n emails: emailsToBlock\n });\n \n console.log(`🚫 ${invalidEmails.length} emails inválidos bloqueados`);\n};\n```\n\n---\n\n**D. Limpieza Masiva (Importar Lista)**\n\n```javascript\n// Importar blacklist desde CSV\nconst importBlacklist = async (csvFile) => {\n const emails = await parseCSV(csvFile);\n \n // Dividir en lotes de 100\n const batches = chunk(emails, 100);\n \n for (const batch of batches) {\n const emailsToBlock = batch.map(email => ({\n email: email.trim().toLowerCase(),\n banned: true\n }));\n \n await api.post('/api/ubl2.1/emailblacklist/add', {\n emails: emailsToBlock\n });\n \n await sleep(1000); // Esperar 1 seg entre lotes\n }\n \n console.log(`✅ ${emails.length} emails importados a blacklist`);\n};\n```\n\n### 📌 5. Validación al Enviar Facturas\n\n**Verificación automática:**\n\n```javascript\nconst sendInvoiceWithBlacklistCheck = async (invoiceData) => {\n const customerEmail = invoiceData.customer.email;\n \n // 1. Verificar si email está en blacklist\n const isBlocked = await checkEmailBlacklist(customerEmail);\n \n if (isBlocked) {\n console.warn(`⚠️ Email ${customerEmail} en blacklist`);\n \n // 2. Enviar factura a DIAN sin enviar email\n const response = await api.post('/api/ubl2.1/invoice', {\n ...invoiceData,\n send_email: false // Desactivar envío de email\n });\n \n // 3. Registrar intento bloqueado\n await db.email_blacklist\n .where('email', customerEmail)\n .update({\n last_attempt: new Date(),\n attempt_count: db.raw('attempt_count + 1')\n });\n \n return {\n ...response,\n email_sent: false,\n email_blocked: true,\n reason: 'Email in blacklist'\n };\n }\n \n // Email OK: enviar normalmente\n return await api.post('/api/ubl2.1/invoice', invoiceData);\n};\n\nconst checkEmailBlacklist = async (email) => {\n const blocked = await db.email_blacklist\n .where('email', email.toLowerCase())\n .where('banned', true)\n .first();\n \n return !!blocked;\n};\n```\n\n### 📌 6. Desbloquear Email (banned: false)\n\n**Remover de blacklist:**\n\n```javascript\n// Cliente corrigió su email\nconst unblockEmail = async (email) => {\n await api.post('/api/ubl2.1/emailblacklist/add', {\n emails: [\n {\n email: email,\n banned: false // Desbloquear\n }\n ]\n });\n \n console.log(`✅ Email ${email} desbloqueado`);\n \n // Notificar al cliente\n await sendEmail({\n to: email,\n subject: 'Email restaurado - Recibirá facturas',\n body: 'Su email ha sido restaurado. Volverá a recibir facturas electrónicas.'\n });\n};\n```\n\n### 📌 7. Dashboard de Blacklist\n\n**Panel de administración:**\n\n```javascript\nimport React, { useState, useEffect } from 'react';\n\nconst BlacklistManager = () => {\n const [blacklist, setBlacklist] = useState([]);\n const [newEmail, setNewEmail] = useState('');\n \n useEffect(() => {\n fetchBlacklist();\n }, []);\n \n const fetchBlacklist = async () => {\n const response = await api.get('/api/ubl2.1/emailblacklist');\n setBlacklist(response.data);\n };\n \n const addToBlacklist = async () => {\n if (!newEmail) return;\n \n await api.post('/api/ubl2.1/emailblacklist/add', {\n emails: [{ email: newEmail, banned: true }]\n });\n \n setNewEmail('');\n fetchBlacklist();\n };\n \n const removeFromBlacklist = async (email) => {\n await api.post('/api/ubl2.1/emailblacklist/add', {\n emails: [{ email: email, banned: false }]\n });\n \n fetchBlacklist();\n };\n \n return (\n
\n

🚫 Lista de Emails Bloqueados

\n \n
\n setNewEmail(e.target.value)}\n placeholder=\"email@ejemplo.com\"\n />\n \n
\n \n \n \n \n \n \n \n \n \n \n \n {blacklist.map(item => (\n \n \n \n \n \n \n ))}\n \n
EmailBloqueado desdeIntentos bloqueadosAcción
{item.email}{new Date(item.added_at).toLocaleDateString()}{item.attempt_count || 0}\n \n
\n \n
\n Total emails bloqueados: {blacklist.length}\n
\n
\n );\n};\n```\n\n### 📌 8. Logs de Intentos Bloqueados\n\n**Registrar cada intento:**\n\n```javascript\nconst logBlockedAttempt = async (email, invoiceNumber) => {\n await db.blocked_email_logs.insert({\n email: email,\n invoice_number: invoiceNumber,\n attempted_at: new Date(),\n reason: 'Email in blacklist'\n });\n};\n\n// Al intentar enviar a email bloqueado\nif (isBlocked) {\n logBlockedAttempt(customerEmail, invoice.number);\n}\n```\n\n**Reporte de intentos:**\n\n```sql\nSELECT \n email,\n COUNT(*) as blocked_attempts,\n MAX(attempted_at) as last_attempt\nFROM blocked_email_logs\nWHERE attempted_at >= DATE_SUB(NOW(), INTERVAL 30 DAY)\nGROUP BY email\nORDER BY blocked_attempts DESC\nLIMIT 50;\n```\n\n### 📌 9. Validación de Emails\n\n**Verificar formato antes de bloquear:**\n\n```javascript\nconst addToBlacklistWithValidation = async (emails) => {\n const validEmails = [];\n const invalidEmails = [];\n \n for (const item of emails) {\n const email = item.email.trim().toLowerCase();\n \n // Validar formato\n const emailRegex = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/;\n if (!emailRegex.test(email)) {\n invalidEmails.push(email);\n continue;\n }\n \n validEmails.push({ email, banned: item.banned });\n }\n \n if (invalidEmails.length > 0) {\n console.warn(`⚠️ ${invalidEmails.length} emails inválidos ignorados:`, invalidEmails);\n }\n \n if (validEmails.length > 0) {\n await api.post('/api/ubl2.1/emailblacklist/add', {\n emails: validEmails\n });\n }\n \n return {\n valid: validEmails.length,\n invalid: invalidEmails.length\n };\n};\n```\n\n### 📌 10. Normalización de Emails\n\n**Consistencia en blacklist:**\n\n```javascript\nconst normalizeEmail = (email) => {\n return email.trim().toLowerCase();\n};\n\nconst addToBlacklist = async (emails) => {\n // Normalizar antes de agregar\n const normalized = emails.map(item => ({\n email: normalizeEmail(item.email),\n banned: item.banned\n }));\n \n await api.post('/api/ubl2.1/emailblacklist/add', {\n emails: normalized\n });\n};\n\n// Ejemplo\nawait addToBlacklist([\n { email: 'CLIENTE@MAIL.COM', banned: true }, // → cliente@mail.com\n { email: ' admin@test.com ', banned: true } // → admin@test.com\n]);\n```\n\n### 📌 11. Notificar Admin de Bounces\n\n**Alerta automática:**\n\n```javascript\nconst monitorBounces = async () => {\n // Obtener bounces recientes\n const recentBounces = await db.email_blacklist\n .where('added_at', '>', db.raw('NOW() - INTERVAL 24 HOUR'))\n .where('banned', true);\n \n if (recentBounces.length > 10) {\n // Muchos bounces: alertar\n await sendEmail({\n to: 'admin@empresa.com',\n subject: '⚠️ ALERTA: Muchos emails bloqueados (24h)',\n body: `${recentBounces.length} emails agregados a blacklist en últimas 24 horas.\\n\\n` +\n `Emails bloqueados:\\n${recentBounces.map(b => b.email).join('\\n')}`\n });\n }\n};\n\n// Ejecutar diariamente\ncron.schedule('0 9 * * *', monitorBounces);\n```\n\n### 📌 12. Exportar Blacklist\n\n**Generar CSV de blacklist:**\n\n```javascript\nconst exportBlacklist = async () => {\n const blacklist = await db.email_blacklist\n .where('banned', true)\n .orderBy('added_at', 'desc');\n \n const csv = blacklist.map(item => \n `${item.email},${item.added_at},${item.reason || 'N/A'}`\n ).join('\\n');\n \n const header = 'Email,Fecha bloqueado,Razón\\n';\n const fullCSV = header + csv;\n \n // Guardar archivo\n fs.writeFileSync('blacklist_export.csv', fullCSV);\n \n console.log('✅ Blacklist exportada a blacklist_export.csv');\n};\n```\n\n### 📌 13. Errores Comunes\n\n| Error | Causa | Solución |\n|-------|-------|----------|\n| \"emails required\" | Campo faltante | Incluir array emails |\n| \"Invalid email format\" | Email malformado | Verificar formato email |\n| \"Duplicate email\" | Email ya existe | OK si banned diferente (actualiza) |\n| \"Unauthorized\" | Token inválido | Verificar Bearer token |\n| \"Empty emails array\" | Array vacío | Incluir al menos 1 email |\n\n### 📌 14. Limpiar Blacklist Periódicamente\n\n**Remover emails antiguos:**\n\n```javascript\n// Limpiar emails bloqueados hace >1 año sin intentos\nconst cleanupOldBlacklist = async () => {\n const removed = await db.email_blacklist\n .where('added_at', '<', db.raw('NOW() - INTERVAL 1 YEAR'))\n .where('attempt_count', 0)\n .delete();\n \n console.log(`🧹 ${removed} emails antiguos removidos de blacklist`);\n};\n\n// Ejecutar mensualmente\ncron.schedule('0 0 1 * *', cleanupOldBlacklist);\n```\n\n### 📌 15. Resumen: Gestión de Email Blacklist\n\n- **Propósito:** Bloquear emails para no enviar facturas\n- **Parámetros:** Array de {email, banned}\n- **banned: true:** Bloquear email (agregar a blacklist)\n- **banned: false:** Desbloquear email (remover de blacklist)\n- **Masivo:** Procesar múltiples emails simultáneamente\n- **Casos de uso:** Bounces, opt-out, emails inválidos\n- **Efecto:** Email no recibe facturas (DIAN recibe normal)\n- **Validación:** Normalizar y validar formato\n- **Logs:** Registrar intentos bloqueados\n- **Dashboard:** Panel de administración\n- **RGPD:** Cumplir solicitudes de privacidad\n- **Automatización:** Detectar bounces automáticamente\n- **Limpieza:** Remover emails antiguos sin uso\n- **Endpoint:** POST /api/ubl2.1/emailblacklist/add" }, "response": [] }, { "name": "Register-Update Email Black List", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "type": "text", "value": "application/json" }, { "key": "cache-control", "type": "text", "value": "no-cache" }, { "key": "Connection", "type": "text", "value": "keep-alive" }, { "key": "Accept-Encoding", "type": "text", "value": "gzip, deflate" }, { "key": "Host", "type": "text", "value": "apidian2026-8.oo", "disabled": true }, { "key": "accept", "type": "text", "value": "application/json" }, { "key": "X-CSRF-TOKEN", "type": "text", "value": "" } ], "body": { "mode": "raw", "raw": "{\r\n \"emails\": [\r\n {\r\n \"email\": \"alexanderobandolondono@gmail.com\",\r\n \"banned\": true\r\n },\r\n {\r\n \"email\": \"alexander_obando@hotmail.com\",\r\n \"banned\": false \r\n },\r\n {\r\n \"email\": \"gerencia@torresoftware.com\"\r\n }\r\n ]\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/emailblacklist/add", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "emailblacklist", "add" ] }, "description": "# 🔄 REGISTRAR/ACTUALIZAR EMAIL EN BLACKLIST (VARIANTE)\n\n## 📄 Descripción General\n\nVariante del endpoint de blacklist que permite **agregar emails con sintaxis simplificada**. Acepta el campo `banned` como opcional, asumiendo `true` por defecto cuando se omite. Útil para agregar emails rápidamente sin Especificar el estado banned explícitamente.\n\n**Diferencia con ejemplo anterior:**\n- **Ejemplo anterior:** `banned` obligatorio (true/false explícito)\n- **Este ejemplo:** `banned` opcional (omitido = true por defecto)\n\n**Características clave:**\n- **Sintaxis flexible:** banned opcional\n- **Default:** banned = true si se omite\n- **Masivo:** Múltiples emails con estados mixtos\n- **Mismo endpoint:** /api/ubl2.1/emailblacklist/add\n\n---\n\n## 📋 URL del Endpoint\n\n```\nPOST {{url}}/api/ubl2.1/emailblacklist/add\n```\n\n**Características:**\n- **Método:** POST\n- **Autenticación:** Bearer token (obligatorio)\n- **Body:** JSON con array emails (banned opcional)\n- **Respuesta:** Confirmación de operaciones\n\n---\n\n## 🔑 Campos del Body\n\n| Campo | Tipo | Requerido | Descripción |\n|-------|------|-----------|-------------|\n| **emails** | array | **Sí** | Array de objetos email |\n| **emails[].email** | string | **Sí** | Dirección de email |\n| **emails[].banned** | boolean | No | true/false (default: true si omitido) |\n\n### Body Ejemplo (Sintaxis Mixta)\n\n```json\n{\n \"emails\": [\n {\n \"email\": \"alexanderobandolondono@gmail.com\",\n \"banned\": true\n },\n {\n \"email\": \"alexander_obando@hotmail.com\",\n \"banned\": false\n },\n {\n \"email\": \"gerencia@torresoftware.com\"\n // banned omitido = true (bloqueado)\n }\n ]\n}\n```\n\n---\n\n## 📝 Notas Críticas sobre Sintaxis Flexible\n\n### 📌 1. Campo banned Opcional\n\n**Comportamiento por defecto:**\n\n```javascript\n// Con banned explícito\n{\n \"email\": \"mail1@mail.com\",\n \"banned\": true // ❌ Bloqueado (explícito)\n}\n\n// Sin banned (omitido)\n{\n \"email\": \"mail2@mail.com\"\n // banned = true (implícito) ❌ Bloqueado\n}\n\n// Desbloquear (debe ser explícito)\n{\n \"email\": \"mail3@mail.com\",\n \"banned\": false // ✅ Desbloqueado (DEBE ser explícito)\n}\n```\n\n**Importante:** Para desbloquear, `banned: false` DEBE Especificarse explícitamente.\n\n### 📌 2. Procesamiento del Servidor\n\n**Lógica del backend:**\n\n```javascript\nconst processEmailBlacklist = (emails) => {\n return emails.map(item => {\n // Si banned no está definido, usar true\n const banned = item.banned !== undefined ? item.banned : true;\n \n return {\n email: item.email.toLowerCase().trim(),\n banned: banned\n };\n });\n};\n\n// Ejemplos de procesamiento\nconst input = [\n { email: 'test1@mail.com', banned: true }, // → banned: true\n { email: 'test2@mail.com', banned: false }, // → banned: false\n { email: 'test3@mail.com' } // → banned: true (default)\n];\n\nconst processed = processEmailBlacklist(input);\n// Resultado:\n// [\n// { email: 'test1@mail.com', banned: true },\n// { email: 'test2@mail.com', banned: false },\n// { email: 'test3@mail.com', banned: true } // ← default aplicado\n// ]\n```\n\n### 📌 3. Respuesta del Endpoint\n\n**Procesamiento mixto exitoso:**\n\n```json\n{\n \"success\": true,\n \"message\": \"3 emails procesados en blacklist\",\n \"results\": [\n {\n \"email\": \"alexanderobandolondono@gmail.com\",\n \"banned\": true,\n \"action\": \"added\",\n \"message\": \"Email bloqueado (banned: true explícito)\"\n },\n {\n \"email\": \"alexander_obando@hotmail.com\",\n \"banned\": false,\n \"action\": \"removed\",\n \"message\": \"Email desbloqueado (banned: false explícito)\"\n },\n {\n \"email\": \"gerencia@torresoftware.com\",\n \"banned\": true,\n \"action\": \"added\",\n \"message\": \"Email bloqueado (banned omitido, default: true)\"\n }\n ],\n \"summary\": {\n \"added\": 2,\n \"removed\": 1,\n \"total_blacklisted\": 127\n }\n}\n```\n\n### 📌 4. Casos de Uso: Sintaxis Simplificada\n\n**A. Bloqueo Rápido (Sin Especificar banned)**\n\n```javascript\n// Bloquear emails rápidamente\nconst quickBlock = async (emailsToBlock) => {\n await api.post('/api/ubl2.1/emailblacklist/add', {\n emails: emailsToBlock.map(email => ({ email }))\n // banned omitido = true automático\n });\n};\n\n// Uso\nawait quickBlock([\n 'spam1@mail.com',\n 'spam2@mail.com',\n 'spam3@mail.com'\n]);\n\n// Equivalente a:\n// {\n// emails: [\n// { email: 'spam1@mail.com', banned: true },\n// { email: 'spam2@mail.com', banned: true },\n// { email: 'spam3@mail.com', banned: true }\n// ]\n// }\n```\n\n---\n\n**B. Operaciones Mixtas (Bloquear y Desbloquear)**\n\n```javascript\n// Procesar lote con acciones mixtas\nconst processMixedBatch = async () => {\n await api.post('/api/ubl2.1/emailblacklist/add', {\n emails: [\n // Bloquear (banned omitido)\n { email: 'bad_email1@mail.com' },\n { email: 'bad_email2@mail.com' },\n \n // Desbloquear (banned: false explícito)\n { email: 'corrected_email@mail.com', banned: false },\n \n // Bloquear (banned: true explícito)\n { email: 'another_bad@mail.com', banned: true }\n ]\n });\n};\n```\n\n---\n\n**C. Importar Lista con Defaults**\n\n```javascript\n// Importar lista simple (solo emails)\nconst importSimpleList = async (emailList) => {\n // emailList = ['email1@mail.com', 'email2@mail.com', ...]\n \n const emails = emailList.map(email => ({\n email: email\n // banned omitido = bloqueado por default\n }));\n \n await api.post('/api/ubl2.1/emailblacklist/add', { emails });\n \n console.log(`✅ ${emailList.length} emails bloqueados`);\n};\n\n// Uso\nconst bouncedEmails = [\n 'bounce1@invalid.com',\n 'bounce2@invalid.com',\n 'bounce3@invalid.com'\n];\n\nawait importSimpleList(bouncedEmails);\n```\n\n### 📌 5. Validación de Entrada\n\n**Verificar datos antes de enviar:**\n\n```javascript\nconst validateAndProcess = (emails) => {\n const validated = [];\n const errors = [];\n \n for (const item of emails) {\n // Validar que email existe\n if (!item.email) {\n errors.push({ error: 'Email required', item });\n continue;\n }\n \n // Validar formato email\n const emailRegex = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/;\n if (!emailRegex.test(item.email)) {\n errors.push({ error: 'Invalid email format', email: item.email });\n continue;\n }\n \n // Procesar banned (default true si omitido)\n const banned = item.banned !== undefined ? item.banned : true;\n \n validated.push({\n email: item.email.toLowerCase().trim(),\n banned: banned\n });\n }\n \n return { validated, errors };\n};\n\n// Uso\nconst input = [\n { email: 'valid@mail.com' },\n { email: 'invalid-email' }, // Formato inválido\n { email: 'another@mail.com', banned: false },\n { email: '' } // Email vacío\n];\n\nconst { validated, errors } = validateAndProcess(input);\n\nif (errors.length > 0) {\n console.warn('⚠️ Errores encontrados:', errors);\n}\n\nif (validated.length > 0) {\n await api.post('/api/ubl2.1/emailblacklist/add', {\n emails: validated\n });\n}\n```\n\n### 📌 6. Comparación: Explícito vs Implícito\n\n**Tabla comparativa:**\n\n| Sintaxis | banned | Resultado | Uso recomendado |\n|----------|--------|-----------|------------------|\n| `{email: \"test@mail.com\"}` | omitido | ❌ Bloqueado (true) | Bloqueo rápido |\n| `{email: \"test@mail.com\", banned: true}` | true | ❌ Bloqueado | Claridad código |\n| `{email: \"test@mail.com\", banned: false}` | false | ✅ Desbloqueado | Desbloquear |\n\n**Recomendación:** Usar siempre `banned` explícito para mayor claridad.\n\n### 📌 7. Wrapper Helper Function\n\n**Funciones auxiliares para simplicidad:**\n\n```javascript\n// Bloquear emails (sintaxis simple)\nconst blockEmails = async (emails) => {\n const payload = emails.map(email => ({\n email: typeof email === 'string' ? email : email.email,\n banned: true\n }));\n \n return await api.post('/api/ubl2.1/emailblacklist/add', {\n emails: payload\n });\n};\n\n// Desbloquear emails (sintaxis simple)\nconst unblockEmails = async (emails) => {\n const payload = emails.map(email => ({\n email: typeof email === 'string' ? email : email.email,\n banned: false\n }));\n \n return await api.post('/api/ubl2.1/emailblacklist/add', {\n emails: payload\n });\n};\n\n// Uso simplificado\nawait blockEmails(['spam@mail.com', 'bad@mail.com']);\nawait unblockEmails(['corrected@mail.com']);\n```\n\n### 📌 8. Manejo de Arrays Grandes\n\n**Dividir en lotes:**\n\n```javascript\nconst chunk = (arr, size) => {\n return Array.from({ length: Math.ceil(arr.length / size) }, (v, i) =>\n arr.slice(i * size, i * size + size)\n );\n};\n\nconst bulkBlockEmails = async (emails) => {\n // Dividir en lotes de 100\n const batches = chunk(emails, 100);\n const results = [];\n \n for (const batch of batches) {\n const payload = batch.map(email => ({ email }));\n // banned omitido = bloqueado\n \n const response = await api.post('/api/ubl2.1/emailblacklist/add', {\n emails: payload\n });\n \n results.push(response);\n await sleep(500); // Delay entre lotes\n }\n \n const totalProcessed = results.reduce(\n (sum, r) => sum + r.summary.added,\n 0\n );\n \n console.log(`✅ ${totalProcessed} emails bloqueados en ${batches.length} lotes`);\n return results;\n};\n```\n\n### 📌 9. TypeScript: Tipos Opcionales\n\n**Definición de tipos:**\n\n```typescript\ninterface EmailBlacklistItem {\n email: string;\n banned?: boolean; // Opcional\n}\n\ninterface BlacklistRequest {\n emails: EmailBlacklistItem[];\n}\n\ninterface BlacklistResponse {\n success: boolean;\n message: string;\n results: Array<{\n email: string;\n banned: boolean;\n action: 'added' | 'removed';\n message: string;\n }>;\n summary: {\n added: number;\n removed: number;\n total_blacklisted: number;\n };\n}\n\n// Uso con tipos\nconst addToBlacklist = async (\n items: EmailBlacklistItem[]\n): Promise => {\n return await api.post('/api/ubl2.1/emailblacklist/add', {\n emails: items\n });\n};\n\n// Ejemplos tipados\nawait addToBlacklist([\n { email: 'test@mail.com' }, // banned omitido (OK)\n { email: 'test2@mail.com', banned: true }, // banned explícito\n { email: 'test3@mail.com', banned: false } // desbloquear\n]);\n```\n\n### 📌 10. Logging y Auditoría\n\n**Registrar operaciones con default:**\n\n```javascript\nconst logBlacklistOperation = async (emails) => {\n for (const item of emails) {\n const banned = item.banned !== undefined ? item.banned : true;\n const source = item.banned !== undefined ? 'explicit' : 'default';\n \n await db.blacklist_logs.insert({\n email: item.email,\n banned: banned,\n banned_source: source, // 'explicit' o 'default'\n timestamp: new Date(),\n user_id: currentUser.id\n });\n }\n};\n```\n\n### 📌 11. Testing: Casos de Prueba\n\n**Unit tests:**\n\n```javascript\ndescribe('Email Blacklist - Optional banned field', () => {\n it('should block email when banned is omitted', async () => {\n const response = await api.post('/api/ubl2.1/emailblacklist/add', {\n emails: [{ email: 'test@mail.com' }]\n });\n \n expect(response.results[0].banned).toBe(true);\n expect(response.results[0].action).toBe('added');\n });\n \n it('should unblock email when banned is false', async () => {\n const response = await api.post('/api/ubl2.1/emailblacklist/add', {\n emails: [{ email: 'test@mail.com', banned: false }]\n });\n \n expect(response.results[0].banned).toBe(false);\n expect(response.results[0].action).toBe('removed');\n });\n \n it('should handle mixed operations', async () => {\n const response = await api.post('/api/ubl2.1/emailblacklist/add', {\n emails: [\n { email: 'block1@mail.com' }, // banned omitido\n { email: 'block2@mail.com', banned: true }, // banned explícito\n { email: 'unblock@mail.com', banned: false } // desbloquear\n ]\n });\n \n expect(response.summary.added).toBe(2);\n expect(response.summary.removed).toBe(1);\n });\n});\n```\n\n### 📌 12. Documentación de API\n\n**Swagger/OpenAPI:**\n\n```yaml\n/api/ubl2.1/emailblacklist/add:\n post:\n summary: Agregar emails a blacklist\n description: Campo 'banned' es opcional (default: true si omitido)\n requestBody:\n required: true\n content:\n application/json:\n schema:\n type: object\n properties:\n emails:\n type: array\n items:\n type: object\n properties:\n email:\n type: string\n format: email\n required: true\n banned:\n type: boolean\n default: true\n description: Omitir = true (bloqueado)\n examples:\n with_banned:\n value:\n emails:\n - email: test@mail.com\n banned: true\n without_banned:\n value:\n emails:\n - email: test@mail.com\n # banned omitido = true\n```\n\n### 📌 13. Errores y Advertencias\n\n**Validación del servidor:**\n\n```javascript\nconst validateBlacklistRequest = (emails) => {\n const errors = [];\n \n for (let i = 0; i < emails.length; i++) {\n const item = emails[i];\n \n if (!item.email) {\n errors.push({\n index: i,\n error: 'email is required'\n });\n }\n \n if (item.banned !== undefined && typeof item.banned !== 'boolean') {\n errors.push({\n index: i,\n email: item.email,\n error: 'banned must be boolean or omitted'\n });\n }\n }\n \n return errors;\n};\n```\n\n### 📌 14. Best Practices\n\n**Recomendaciones:**\n\n✅ **Hacer:**\n- Usar `banned: false` explícito para desbloquear\n- Normalizar emails (lowercase, trim)\n- Validar formato antes de enviar\n- Dividir lotes grandes (>100 emails)\n- Registrar operaciones en logs\n\n❌ **Evitar:**\n- Asumir que omitir banned = desbloquear (es bloquear)\n- Enviar emails sin validar formato\n- Procesar miles de emails en una sola petición\n- Olvidar manejar errores de validación\n\n### 📌 15. Resumen: Sintaxis Flexible\n\n- **banned opcional:** Si se omite, default = true (bloqueado)\n- **Desbloquear:** Debe usar `banned: false` explícito\n- **Sintaxis mixta:** Permite combinar explícito e implícito\n- **Mismo endpoint:** /api/ubl2.1/emailblacklist/add\n- **Uso recomendado:** Bloqueo rápido de múltiples emails\n- **Validación:** Siempre verificar formato email\n- **Lotes grandes:** Dividir en chunks de 100\n- **Claridad:** Preferir `banned` explícito en código\n- **TypeScript:** Usar `banned?: boolean` opcional\n- **Testing:** Cubrir casos con banned omitido\n- **Logging:** Registrar si banned fue explícito o default" }, "response": [] }, { "name": "Delete From Email Black List", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "type": "text", "value": "application/json" }, { "key": "cache-control", "type": "text", "value": "no-cache" }, { "key": "Connection", "type": "text", "value": "keep-alive" }, { "key": "Accept-Encoding", "type": "text", "value": "gzip, deflate" }, { "key": "Host", "type": "text", "value": "apidian2026-8.oo", "disabled": true }, { "key": "accept", "type": "text", "value": "application/json" }, { "key": "X-CSRF-TOKEN", "type": "text", "value": "" } ], "body": { "mode": "raw", "raw": "{\r\n \"emails\": [\r\n {\r\n \"email\": \"alexander_obando@hotmail.com\"\r\n },\r\n {\r\n \"email\": \"gerencia@torresoftware.com\"\r\n }\r\n ]\r\n}\r\n" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/emailblacklist/delete", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "emailblacklist", "delete" ] }, "description": "## **DELETE FROM EMAIL BLACK LIST**\n\n**Endpoint:** `POST /api/ubl2.1/emailblacklist/delete`\n\n**Propósito:** Elimina definitivamente correos electrónicos de la lista negra del sistema APIDIAN, permitiendo que vuelvan a recibir facturas electrónicas. Esta operación es permanente y requiere confirmación en interfaces de usuario.\n\n---\n\n### **📌 NOTAS CRÍTICAS**\n\n**📌 1. ELIMINACIÓN PERMANENTE VS DESBLOQUEO TEMPORAL**\n- `POST /emailblacklist/delete` → Elimina permanentemente de la base de datos\n- `POST /emailblacklist/add` con `banned: false` → Desbloquea temporalmente (registro permanece)\n- La eliminación es **irreversible**, si se eliminó por error se debe volver a agregar\n- El desbloqueo preserva el historial de bloqueos previos\n\n**📌 2. CASOS DE USO PARA ELIMINACIÓN PERMANENTE**\n- Cliente corrigió su correo electrónico y el anterior ya no existe\n- Solicitud explícita del titular del correo (RGPD - derecho al olvido)\n- Limpieza de registros históricos obsoletos (más de 2 años sin actividad)\n- Correos agregados por error durante importaciones masivas\n- Consolidación de bases de datos tras fusiones empresariales\n\n**📌 3. VALIDACIÓN PREVIA A LA ELIMINACIÓN**\n```javascript\n// Validar que los correos existan en la blacklist antes de eliminar\nconst emailsToDelete = ['correo1@example.com', 'correo2@example.com'];\nconst existingEmails = await EmailBlacklist.whereIn('email', emailsToDelete).pluck('email');\nconst notFound = emailsToDelete.filter(e => !existingEmails.includes(e));\n\nif (notFound.length > 0) {\n console.warn(`Correos no encontrados en blacklist: ${notFound.join(', ')}`);\n}\n```\n\n**📌 4. OPERACIONES MASIVAS Y PERFORMANCE**\n- El endpoint acepta arrays con múltiples correos (hasta 500 por request)\n- Para más de 500 correos, dividir en lotes secuenciales\n- Cada operación se ejecuta en una transacción de base de datos\n- Rollback automático si falla cualquier eliminación del lote\n\n**📌 5. ESTRUCTURA DEL BODY (SIMPLIFICADO)**\n```json\n{\n \"emails\": [\n { \"email\": \"correo1@example.com\" },\n { \"email\": \"correo2@example.com\" }\n ]\n}\n```\n- **NO requiere campo `banned`** (a diferencia del endpoint `/add`)\n- Solo se necesita el campo `email` por cada elemento\n- Validación de formato de email antes de procesar\n\n**📌 6. RESPUESTA DEL ENDPOINT**\n```json\n{\n \"success\": true,\n \"message\": \"2 correos eliminados de la lista negra\",\n \"deleted\": [\n \"correo1@example.com\",\n \"correo2@example.com\"\n ],\n \"not_found\": [],\n \"errors\": []\n}\n```\n\n**📌 7. MANEJO DE CORREOS NO ENCONTRADOS**\n```json\n{\n \"success\": true,\n \"message\": \"1 correo eliminado, 1 no encontrado\",\n \"deleted\": [\"correo1@example.com\"],\n \"not_found\": [\"correo_inexistente@example.com\"],\n \"errors\": []\n}\n```\n- El endpoint **NO falla** si un correo no está en la blacklist\n- Se reportan los correos no encontrados en el array `not_found`\n- Permite operaciones idempotentes (llamar múltiples veces sin error)\n\n**📌 8. CONFIRMACIÓN EN INTERFACES DE USUARIO**\n```javascript\n// Modal de confirmación antes de eliminar\nconst confirmDelete = async (emails) => {\n const confirmed = await showConfirmDialog({\n title: '⚠️ Eliminar de Lista Negra',\n message: `¿Está seguro de eliminar permanentemente ${emails.length} correo(s)?\\n\\nEsta acción NO se puede deshacer.`,\n buttons: ['Cancelar', 'Eliminar'],\n dangerButton: 'Eliminar'\n });\n \n if (confirmed) {\n await deleteFromBlacklist(emails);\n }\n};\n```\n\n**📌 9. REGISTRO DE AUDITORÍA (LOG)**\n```sql\n-- Registrar en tabla de auditoría antes de eliminar\nINSERT INTO email_blacklist_audit_log \n (email, action, performed_by, performed_at, ip_address, reason)\nVALUES \n ('correo@example.com', 'DELETE', 'admin_user', NOW(), '192.168.1.100', 'Solicitud del titular');\n\n-- Luego eliminar de blacklist\nDELETE FROM email_blacklist WHERE email = 'correo@example.com';\n```\n\n**📌 10. ESTRATEGIA DE UNDO (DESHACER)**\n```javascript\n// Guardar copia de seguridad antes de eliminar\nconst backupBeforeDelete = async (emails) => {\n const records = await EmailBlacklist.whereIn('email', emails).get();\n \n // Guardar en tabla temporal por 30 días\n await EmailBlacklistBackup.insert(\n records.map(r => ({\n ...r,\n deleted_at: new Date(),\n recoverable_until: new Date(Date.now() + 30*24*60*60*1000)\n }))\n );\n \n return records;\n};\n\n// Función de recuperación\nconst undoDelete = async (email) => {\n const backup = await EmailBlacklistBackup\n .where('email', email)\n .where('recoverable_until', '>', new Date())\n .first();\n \n if (backup) {\n await EmailBlacklist.insert({ email: backup.email, banned: true });\n await EmailBlacklistBackup.where('email', email).delete();\n return true;\n }\n return false;\n};\n```\n\n**📌 11. INTEGRACIÓN CON ENDPOINT ADD**\n```javascript\n// Workflow: Eliminar y luego re-agregar con nuevo estado\nconst resetEmailStatus = async (email) => {\n // 1. Eliminar registro antiguo\n await axios.post('/api/ubl2.1/emailblacklist/delete', {\n emails: [{ email }]\n });\n \n // 2. Agregar con estado desbloqueado\n await axios.post('/api/ubl2.1/emailblacklist/add', {\n emails: [{ email, banned: false }]\n });\n};\n```\n\n**📌 12. MANEJO DE ERRORES Y VALIDACIONES**\n```javascript\ntry {\n const response = await axios.post('/api/ubl2.1/emailblacklist/delete', {\n emails: [\n { email: 'correo@example.com' }\n ]\n }, {\n headers: {\n 'Authorization': `Bearer ${apiToken}`,\n 'Content-Type': 'application/json'\n }\n });\n \n if (response.data.not_found.length > 0) {\n console.warn('Correos no encontrados:', response.data.not_found);\n }\n \n console.log('Eliminados:', response.data.deleted);\n \n} catch (error) {\n if (error.response?.status === 422) {\n console.error('Error de validación:', error.response.data.errors);\n } else if (error.response?.status === 401) {\n console.error('Token de autorización inválido');\n } else {\n console.error('Error al eliminar correos:', error.message);\n }\n}\n```\n\n**📌 13. CUMPLIMIENTO RGPD (DERECHO AL OLVIDO)**\n```javascript\n// Endpoint para solicitud RGPD\nconst processRGPDRequest = async (email, requestId) => {\n // 1. Validar solicitud del titular\n const verified = await verifyEmailOwnership(email, requestId);\n if (!verified) throw new Error('No se pudo verificar la propiedad del correo');\n \n // 2. Eliminar de blacklist\n await axios.post('/api/ubl2.1/emailblacklist/delete', {\n emails: [{ email }]\n });\n \n // 3. Registrar cumplimiento RGPD\n await RGPDLog.insert({\n email,\n request_id: requestId,\n action: 'RIGHT_TO_BE_FORGOTTEN',\n completed_at: new Date()\n });\n};\n```\n\n**📌 14. SCRIPT DE LIMPIEZA MASIVA**\n```javascript\n// Eliminar correos inactivos hace más de 2 años\nconst cleanupOldBlacklist = async () => {\n const twoYearsAgo = new Date();\n twoYearsAgo.setFullYear(twoYearsAgo.getFullYear() - 2);\n \n const oldEmails = await EmailBlacklist\n .where('created_at', '<', twoYearsAgo)\n .where('last_bounce_at', '<', twoYearsAgo)\n .pluck('email');\n \n console.log(`Eliminando ${oldEmails.length} correos obsoletos...`);\n \n // Dividir en lotes de 500\n const batches = [];\n for (let i = 0; i < oldEmails.length; i += 500) {\n batches.push(oldEmails.slice(i, i + 500));\n }\n \n for (const batch of batches) {\n await axios.post('/api/ubl2.1/emailblacklist/delete', {\n emails: batch.map(email => ({ email }))\n });\n await sleep(1000); // Pausa entre lotes\n }\n};\n```\n\n**📌 15. INTEGRACIÓN CON DASHBOARD ADMINISTRATIVO**\n```jsx\n// Componente React para eliminar correos\nconst BlacklistDeleteButton = ({ email }) => {\n const [loading, setLoading] = useState(false);\n \n const handleDelete = async () => {\n const confirmed = window.confirm(\n `¿Eliminar \"${email}\" de la lista negra?\\n\\nEsta acción es permanente.`\n );\n \n if (!confirmed) return;\n \n setLoading(true);\n try {\n const response = await fetch('/api/ubl2.1/emailblacklist/delete', {\n method: 'POST',\n headers: {\n 'Authorization': `Bearer ${localStorage.getItem('apiToken')}`,\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify({\n emails: [{ email }]\n })\n });\n \n const data = await response.json();\n \n if (data.success) {\n alert(`✅ Correo eliminado: ${email}`);\n window.location.reload();\n } else {\n alert(`❌ Error: ${data.message}`);\n }\n } catch (error) {\n alert(`❌ Error de conexión: ${error.message}`);\n } finally {\n setLoading(false);\n }\n };\n \n return (\n \n );\n};\n```\n\n---\n\n### **📊 TABLA DE PARÁMETROS**\n\n| Campo | Tipo | Requerido | Descripción |\n|-------|------|-----------|-------------|\n| `emails` | Array | ✅ Sí | Array de objetos con correos a eliminar |\n| `emails[].email` | String | ✅ Sí | Dirección de correo electrónico válida |\n\n---\n\n### **📊 TABLA DE RESPUESTAS**\n\n| Código | Descripción | Body |\n|--------|-------------|------|\n| **200** | Eliminación exitosa | `{ success: true, deleted: [...], not_found: [...] }` |\n| **422** | Error de validación | `{ success: false, errors: { emails: [...] } }` |\n| **401** | Token inválido | `{ message: \"Unauthenticated.\" }` |\n| **500** | Error interno | `{ success: false, message: \"Database error\" }` |\n\n---\n\n### **📊 COMPARACIÓN: DELETE VS ADD (BANNED: FALSE)**\n\n| Aspecto | `POST /emailblacklist/delete` | `POST /emailblacklist/add` (banned: false) |\n|---------|-------------------------------|--------------------------------------------|\n| **Operación** | Elimina registro de BD | Actualiza registro (banned = false) |\n| **Reversible** | ❌ No (requiere re-agregar) | ✅ Sí (cambiar banned = true) |\n| **Historial** | 🗑️ Se pierde completamente | ✅ Se preserva (fechas, contadores) |\n| **Uso recomendado** | Correos obsoletos/inexistentes | Desbloqueos temporales |\n| **RGPD** | ✅ Cumple derecho al olvido | ⚠️ Datos aún almacenados |\n| **Performance** | 🚀 Más rápido (DELETE) | 🐢 Más lento (UPDATE) |\n\n---\n\n### **🔧 EJEMPLO DE USO: JAVASCRIPT/AXIOS**\n\n```javascript\nconst axios = require('axios');\n\nconst deleteFromBlacklist = async () => {\n try {\n const response = await axios.post(\n 'http://midominio.com/api/ubl2.1/emailblacklist/delete',\n {\n emails: [\n { email: 'alexander_obando@hotmail.com' },\n { email: 'gerencia@torresoftware.com' },\n { email: 'cliente_corregido@newdomain.com' }\n ]\n },\n {\n headers: {\n 'Authorization': 'Bearer 4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa',\n 'Content-Type': 'application/json'\n }\n }\n );\n \n console.log('✅ Respuesta:', response.data);\n console.log('Correos eliminados:', response.data.deleted);\n console.log('Correos no encontrados:', response.data.not_found);\n \n } catch (error) {\n console.error('❌ Error:', error.response?.data || error.message);\n }\n};\n\ndeleteFromBlacklist();\n```\n\n---\n\n### **🔧 EJEMPLO: CURL**\n\n```bash\ncurl -X POST http://midominio.com/api/ubl2.1/emailblacklist/delete \\\n -H \"Authorization: Bearer 4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"emails\": [\n { \"email\": \"alexander_obando@hotmail.com\" },\n { \"email\": \"gerencia@torresoftware.com\" }\n ]\n }'\n```\n\n---\n\n### **📖 ESCENARIOS DE USO**\n\n**Escenario 1: Cliente Corrigió Su Correo**\n```javascript\n// Cliente tenía correo mal escrito, ahora lo corrigió\nconst updateCustomerEmail = async (oldEmail, newEmail) => {\n // 1. Eliminar correo antiguo de blacklist\n await axios.post('/api/ubl2.1/emailblacklist/delete', {\n emails: [{ email: oldEmail }]\n });\n \n // 2. Actualizar correo en base de clientes\n await axios.put('/api/ubl2.1/register-update-customer', {\n identification_number: '123456',\n email: newEmail\n });\n};\n```\n\n**Escenario 2: Limpieza Anual de Registros Obsoletos**\n```javascript\nconst annualCleanup = async () => {\n // Correos sin bounces en los últimos 2 años\n const obsoleteEmails = await EmailBlacklist\n .where('last_bounce_at', '<', new Date('2023-01-01'))\n .pluck('email');\n \n console.log(`Limpiando ${obsoleteEmails.length} registros obsoletos...`);\n \n await axios.post('/api/ubl2.1/emailblacklist/delete', {\n emails: obsoleteEmails.map(email => ({ email }))\n });\n};\n```\n\n**Escenario 3: Solicitud RGPD del Titular**\n```javascript\nconst handleRGPDRequest = async (email, verificationToken) => {\n // Validar que el solicitante es el titular\n const isValid = await verifyToken(verificationToken);\n if (!isValid) throw new Error('Verificación fallida');\n \n // Eliminar de blacklist (derecho al olvido)\n await axios.post('/api/ubl2.1/emailblacklist/delete', {\n emails: [{ email }]\n });\n \n // Notificar al titular\n await sendEmail(email, {\n subject: 'Solicitud RGPD Completada',\n body: 'Su correo ha sido eliminado de nuestra lista negra.'\n });\n};\n```\n\n---\n\n### **✅ MEJORES PRÁCTICAS**\n\n1. **Implementar confirmación en UI** → Evitar eliminaciones accidentales\n2. **Registrar en logs de auditoría** → Cumplimiento normativo y trazabilidad\n3. **Mantener backup temporal (30 días)** → Permitir recuperación ante errores\n4. **Validar correos antes de eliminar** → Evitar requests innecesarios\n5. **Usar endpoint `/add` con `banned: false` para desbloqueos temporales** → Preservar historial\n6. **Dividir operaciones masivas en lotes** → Máximo 500 correos por request\n7. **Implementar rate limiting** → Evitar abuso del endpoint\n8. **Documentar razón de eliminación** → Facilitar auditorías futuras" }, "response": [] }, { "name": "GetXMLByUUID", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "type": "text", "value": "application/json" }, { "key": "cache-control", "type": "text", "value": "no-cache" }, { "key": "Connection", "type": "text", "value": "keep-alive" }, { "key": "Accept-Encoding", "type": "text", "value": "gzip, deflate" }, { "key": "Host", "type": "text", "value": "apidian2026-8.oo", "disabled": true }, { "key": "accept", "type": "text", "value": "application/json" }, { "key": "X-CSRF-TOKEN", "type": "text", "value": "" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/xml/document/0b074126d69ec0fb6637f25cd250907d13c23f6096229c04122189a0ed99f9320af1f276019d7044c32b71aa0c2df4ec", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "xml", "document", "0b074126d69ec0fb6637f25cd250907d13c23f6096229c04122189a0ed99f9320af1f276019d7044c32b71aa0c2df4ec" ] }, "description": "## **GET XML BY UUID**\n\n**Endpoint:** `POST /api/ubl2.1/xml/document/{uuid}`\n\n**Propósito:** Recupera el archivo XML original de un documento electrónico (factura, nota crédito, nota débito, etc.) mediante su UUID. Este endpoint retorna el XML tal como fue enviado a la DIAN, permitiendo validaciones, auditorías y almacenamiento externo.\n\n---\n\n### **📌 NOTAS CRÍTICAS**\n\n**📌 1. UUID EN LA RUTA (PATH PARAMETER)**\n- El UUID se pasa como parte de la URL, **NO en el body**\n- Formato: `/api/ubl2.1/xml/document/{uuid}`\n- Ejemplo: `/api/ubl2.1/xml/document/0b074126d69ec0fb6637f25cd250907d13c23f6096229c04122189a0ed99f9320af1f276019d7044c32b71aa0c2df4ec`\n- El UUID es un hash SHA-256 de 128 caracteres (no confundir con CUFE/CUDE que son más cortos)\n\n**📌 2. DIFERENCIA ENTRE UUID, CUFE Y CUDE**\n```javascript\n// UUID (Universal Unique IDentifier) - 128 caracteres\nconst uuid = '0b074126d69ec0fb6637f25cd250907d13c23f6096229c04122189a0ed99f9320af1f276019d7044c32b71aa0c2df4ec';\n\n// CUFE (Código Único de Factura Electrónica) - 96 caracteres\nconst cufe = 'c3d5f6a8b1e9d4c7b3a2f8e1d6c9b5a3f2e8d1c7b4a9f6e3d2c8b1a5f9e4d7c3b6a2f1e8d5c2b9a6f3e1d8c4b7a3f6e';\n\n// CUDE (Código Único de Documento Electrónico) - Usado en notas\nconst cude = 'd2e5f8b1c4a7d9e3b6f1c8a5d2e9b4f7c1a8d5e2b9f6c3a1d8e4b7f2c9a5d1e8';\n```\n- **UUID** → Identificador interno de APIDIAN (base de datos)\n- **CUFE/CUDE** → Identificador oficial de la DIAN (campo en el XML)\n- Este endpoint requiere el **UUID**, no el CUFE\n\n**📌 3. MÉTODO HTTP: POST (NO GET)**\n- Aunque es una operación de lectura, el endpoint usa **POST**\n- Razón: Los UUIDs pueden ser muy largos para URLs en algunos servidores\n- El body está vacío (`\"raw\": \"\"`), todo va en la URL\n\n**📌 4. BODY VACÍO (IMPORTANTE)**\n```json\n{\n \"mode\": \"raw\",\n \"raw\": \"\"\n}\n```\n- **NO enviar parámetros en el body**\n- El UUID va exclusivamente en la ruta de la URL\n- Body vacío evita errores 400 (Bad Request)\n\n**📌 5. OBTENER EL UUID DE UN DOCUMENTO**\n```javascript\n// Desde la tabla 'documents' en la base de datos\nconst document = await Document.where('number', 'SETP990000001').first();\nconst uuid = document.uuid;\n\n// O desde la respuesta al crear una factura\nconst response = await axios.post('/api/ubl2.1/invoice/...', invoiceData);\nconst uuid = response.data.uuid;\nconsole.log('UUID del documento:', uuid);\n```\n\n**📌 6. RESPUESTA: TEXTO XML (NO JSON)**\n```xml\n\n\n UBL 2.1\n 10\n DIAN 2.1\n SETP990000001\n c3d5f6a8b1e9d4c7b3a2f8e1d6c9b5a3...\n \n\n```\n- **Content-Type de respuesta:** `application/xml` o `text/xml`\n- **NO es JSON**, es el XML original\n- Ideal para validaciones contra XSD schemas\n\n**📌 7. CASOS DE USO PRINCIPALES**\n- **Auditorías externas** → Validar XML contra normativa DIAN\n- **Almacenamiento en servicios externos** → S3, Azure Blob, Google Cloud Storage\n- **Validación de integridad** → Comparar hash del XML con el almacenado\n- **Re-envío de documentos** → Cliente perdió el XML original\n- **Integración con sistemas contables** → Importar XML a SAP, Siigo, etc.\n- **Desarrollo/debugging** → Verificar estructura XML generada\n\n**📌 8. MANEJO DE ERRORES**\n```javascript\ntry {\n const response = await axios.post(\n `http://midominio.com/api/ubl2.1/xml/document/${uuid}`,\n {}, // Body vacío\n {\n headers: {\n 'Authorization': `Bearer ${apiToken}`,\n 'Content-Type': 'application/json'\n },\n responseType: 'text' // Importante: esperar texto, no JSON\n }\n );\n \n const xmlContent = response.data;\n console.log('XML recuperado:', xmlContent);\n \n} catch (error) {\n if (error.response?.status === 404) {\n console.error('UUID no encontrado en la base de datos');\n } else if (error.response?.status === 401) {\n console.error('Token de autorización inválido');\n } else {\n console.error('Error al obtener XML:', error.message);\n }\n}\n```\n\n**📌 9. VALIDACIÓN DE UUID ANTES DE CONSULTAR**\n```javascript\n// Validar formato de UUID (SHA-256 = 64 caracteres hexadecimales duplicados)\nconst isValidUUID = (uuid) => {\n return /^[a-f0-9]{128}$/i.test(uuid);\n};\n\n// Validar antes de hacer request\nif (!isValidUUID(uuid)) {\n throw new Error('UUID inválido: debe ser un hash SHA-256 de 128 caracteres');\n}\n```\n\n**📌 10. GUARDAR XML EN DISCO**\n```javascript\nconst fs = require('fs');\nconst path = require('path');\n\nconst saveXML = async (uuid, outputDir) => {\n const response = await axios.post(\n `http://midominio.com/api/ubl2.1/xml/document/${uuid}`,\n {},\n {\n headers: { 'Authorization': `Bearer ${apiToken}` },\n responseType: 'text'\n }\n );\n \n const xmlContent = response.data;\n const filename = `documento_${uuid.substring(0, 16)}.xml`;\n const filepath = path.join(outputDir, filename);\n \n fs.writeFileSync(filepath, xmlContent, 'utf8');\n console.log(`✅ XML guardado: ${filepath}`);\n \n return filepath;\n};\n\n// Uso\nawait saveXML('0b074126d69ec0fb...', './facturas_xml/');\n```\n\n**📌 11. SUBIR XML A ALMACENAMIENTO EN LA NUBE**\n```javascript\nconst AWS = require('aws-sdk');\nconst s3 = new AWS.S3();\n\nconst uploadXMLToS3 = async (uuid) => {\n // 1. Obtener XML de APIDIAN\n const response = await axios.post(\n `http://midominio.com/api/ubl2.1/xml/document/${uuid}`,\n {},\n { \n headers: { 'Authorization': `Bearer ${apiToken}` },\n responseType: 'text' \n }\n );\n \n // 2. Subir a S3\n const params = {\n Bucket: 'mi-bucket-facturas',\n Key: `xml/${uuid}.xml`,\n Body: response.data,\n ContentType: 'application/xml',\n Metadata: {\n 'uploaded-at': new Date().toISOString(),\n 'source': 'apidian'\n }\n };\n \n const s3Response = await s3.upload(params).promise();\n console.log('✅ XML subido a S3:', s3Response.Location);\n \n return s3Response.Location;\n};\n```\n\n**📌 12. VALIDAR XML CONTRA SCHEMA XSD**\n```javascript\nconst libxmljs = require('libxmljs');\nconst fs = require('fs');\n\nconst validateXMLAgainstSchema = async (uuid) => {\n // 1. Obtener XML\n const response = await axios.post(\n `http://midominio.com/api/ubl2.1/xml/document/${uuid}`,\n {},\n { \n headers: { 'Authorization': `Bearer ${apiToken}` },\n responseType: 'text' \n }\n );\n \n // 2. Cargar schema XSD de la DIAN\n const xsdContent = fs.readFileSync('./schemas/UBL-Invoice-2.1.xsd', 'utf8');\n const xsdDoc = libxmljs.parseXml(xsdContent);\n \n // 3. Validar XML\n const xmlDoc = libxmljs.parseXml(response.data);\n const isValid = xmlDoc.validate(xsdDoc);\n \n if (isValid) {\n console.log('✅ XML válido según schema XSD');\n } else {\n console.error('❌ Errores de validación:', xmlDoc.validationErrors);\n }\n \n return isValid;\n};\n```\n\n**📌 13. EXTRAER DATOS DEL XML RECUPERADO**\n```javascript\nconst xml2js = require('xml2js');\n\nconst parseXML = async (uuid) => {\n // 1. Obtener XML\n const response = await axios.post(\n `http://midominio.com/api/ubl2.1/xml/document/${uuid}`,\n {},\n { \n headers: { 'Authorization': `Bearer ${apiToken}` },\n responseType: 'text' \n }\n );\n \n // 2. Parsear XML a objeto JavaScript\n const parser = new xml2js.Parser({ explicitArray: false });\n const result = await parser.parseStringPromise(response.data);\n \n // 3. Extraer información\n const invoice = result.Invoice || result['fe:Invoice'];\n const invoiceNumber = invoice.ID;\n const cufe = invoice.UUID;\n const issueDate = invoice.IssueDate;\n const totalAmount = invoice.LegalMonetaryTotal?.PayableAmount?._;\n \n console.log('Número:', invoiceNumber);\n console.log('CUFE:', cufe);\n console.log('Fecha:', issueDate);\n console.log('Total:', totalAmount);\n \n return { invoiceNumber, cufe, issueDate, totalAmount };\n};\n```\n\n**📌 14. DESCARGAR MÚLTIPLES XMLs EN LOTE**\n```javascript\nconst downloadXMLBatch = async (uuids, outputDir) => {\n console.log(`Descargando ${uuids.length} XMLs...`);\n \n for (let i = 0; i < uuids.length; i++) {\n const uuid = uuids[i];\n \n try {\n const response = await axios.post(\n `http://midominio.com/api/ubl2.1/xml/document/${uuid}`,\n {},\n { \n headers: { 'Authorization': `Bearer ${apiToken}` },\n responseType: 'text' \n }\n );\n \n const filename = `${outputDir}/documento_${i + 1}_${uuid.substring(0, 12)}.xml`;\n fs.writeFileSync(filename, response.data, 'utf8');\n console.log(`✅ [${i + 1}/${uuids.length}] ${filename}`);\n \n // Pausa para evitar rate limiting\n await new Promise(resolve => setTimeout(resolve, 500));\n \n } catch (error) {\n console.error(`❌ Error con UUID ${uuid}:`, error.message);\n }\n }\n \n console.log('✅ Descarga masiva completada');\n};\n\n// Uso\nconst uuids = await Document.where('created_at', '>', '2025-01-01').pluck('uuid');\nawait downloadXMLBatch(uuids, './backup_xml/');\n```\n\n**📌 15. INTEGRACIÓN CON SISTEMA CONTABLE**\n```javascript\n// Enviar XML a sistema contable externo (SAP, Siigo, etc.)\nconst sendToAccountingSystem = async (uuid) => {\n // 1. Obtener XML de APIDIAN\n const response = await axios.post(\n `http://midominio.com/api/ubl2.1/xml/document/${uuid}`,\n {},\n { \n headers: { 'Authorization': `Bearer ${apiToken}` },\n responseType: 'text' \n }\n );\n \n // 2. Enviar a sistema contable\n const accountingResponse = await axios.post(\n 'https://sistema-contable.com/api/import-invoice',\n {\n xml_content: response.data,\n format: 'UBL2.1',\n source: 'APIDIAN'\n },\n {\n headers: {\n 'Authorization': `Bearer ${accountingApiToken}`,\n 'Content-Type': 'application/json'\n }\n }\n );\n \n console.log('✅ Factura importada a sistema contable:', accountingResponse.data);\n \n return accountingResponse.data;\n};\n```\n\n---\n\n### **📊 TABLA DE PARÁMETROS**\n\n| Parámetro | Ubicación | Tipo | Requerido | Descripción |\n|-----------|-----------|------|-----------|-------------|\n| `uuid` | Path (URL) | String | ✅ Sí | UUID del documento (128 caracteres SHA-256) |\n| `Authorization` | Header | String | ✅ Sí | Token Bearer del API |\n\n---\n\n### **📊 TABLA DE RESPUESTAS**\n\n| Código | Descripción | Content-Type | Body |\n|--------|-------------|--------------|------|\n| **200** | XML recuperado exitosamente | `application/xml` | Contenido XML completo |\n| **404** | UUID no encontrado | `application/json` | `{ message: \"Document not found\" }` |\n| **401** | Token inválido | `application/json` | `{ message: \"Unauthenticated.\" }` |\n| **500** | Error interno | `application/json` | `{ message: \"Server error\" }` |\n\n---\n\n### **🔧 EJEMPLO DE USO: JAVASCRIPT/AXIOS**\n\n```javascript\nconst axios = require('axios');\n\nconst getXMLByUUID = async (uuid) => {\n try {\n const response = await axios.post(\n `http://midominio.com/api/ubl2.1/xml/document/${uuid}`,\n {}, // Body vacío\n {\n headers: {\n 'Authorization': 'Bearer 4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa',\n 'Content-Type': 'application/json'\n },\n responseType: 'text' // Importante: esperar XML como texto\n }\n );\n \n console.log('✅ XML recuperado:');\n console.log(response.data);\n \n // Guardar en archivo\n const fs = require('fs');\n fs.writeFileSync('./factura.xml', response.data, 'utf8');\n console.log('✅ XML guardado en ./factura.xml');\n \n } catch (error) {\n console.error('❌ Error:', error.response?.data || error.message);\n }\n};\n\n// Uso\ngetXMLByUUID('0b074126d69ec0fb6637f25cd250907d13c23f6096229c04122189a0ed99f9320af1f276019d7044c32b71aa0c2df4ec');\n```\n\n---\n\n### **🔧 EJEMPLO: CURL**\n\n```bash\ncurl -X POST \"http://midominio.com/api/ubl2.1/xml/document/0b074126d69ec0fb6637f25cd250907d13c23f6096229c04122189a0ed99f9320af1f276019d7044c32b71aa0c2df4ec\" \\\n -H \"Authorization: Bearer 4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa\" \\\n -H \"Content-Type: application/json\" \\\n -d \"\" \\\n -o factura_output.xml\n\necho \"XML guardado en factura_output.xml\"\n```\n\n---\n\n### **📖 ESCENARIOS DE USO**\n\n**Escenario 1: Backup Diario de XMLs**\n```javascript\nconst dailyBackup = async () => {\n const today = new Date().toISOString().split('T')[0];\n const documents = await Document.where('created_at', '>=', today).get();\n \n for (const doc of documents) {\n await saveXML(doc.uuid, `./backups/${today}/`);\n }\n \n console.log(`✅ Backup completado: ${documents.length} XMLs`);\n};\n```\n\n**Escenario 2: Envío de XML a Cliente por Email**\n```javascript\nconst sendXMLByEmail = async (uuid, customerEmail) => {\n const xmlContent = await getXMLByUUID(uuid);\n \n await sendEmail({\n to: customerEmail,\n subject: 'Factura Electrónica - XML',\n body: 'Adjunto encontrará el XML de su factura.',\n attachments: [\n {\n filename: 'factura.xml',\n content: xmlContent,\n contentType: 'application/xml'\n }\n ]\n });\n};\n```\n\n**Escenario 3: Validación de Integridad**\n```javascript\nconst verifyIntegrity = async (uuid) => {\n const xmlContent = await getXMLByUUID(uuid);\n const crypto = require('crypto');\n \n const hash = crypto.createHash('sha256').update(xmlContent).digest('hex');\n const storedHash = await Document.where('uuid', uuid).pluck('xml_hash');\n \n if (hash === storedHash) {\n console.log('✅ XML íntegro, no ha sido modificado');\n } else {\n console.error('❌ XML corrupto o modificado');\n }\n};\n```\n\n---\n\n### **✅ MEJORES PRÁCTICAS**\n\n1. **Usar `responseType: 'text'` en Axios** → Evitar parseo automático a JSON\n2. **Validar UUID antes de consultar** → Ahorrar requests inválidos\n3. **Implementar caché para XMLs frecuentes** → Reducir carga del servidor\n4. **Guardar XMLs en almacenamiento externo** → No depender solo de la API\n5. **Validar XML contra schema XSD** → Asegurar cumplimiento normativo\n6. **Implementar rate limiting en descargas masivas** → Evitar sobrecarga\n7. **Registrar accesos en logs de auditoría** → Trazabilidad de consultas\n8. **Comprimir XMLs al almacenar** → Reducir uso de disco (gzip, zip)" }, "response": [] }, { "name": "Consultar tablas con valores", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Content-Type", "type": "text", "value": "application/json" }, { "key": "cache-control", "type": "text", "value": "no-cache" }, { "key": "Connection", "type": "text", "value": "keep-alive" }, { "key": "Accept-Encoding", "type": "text", "value": "gzip, deflate" }, { "key": "Host", "type": "text", "value": "localhost", "disabled": true }, { "key": "accept", "type": "text", "value": "application/json" }, { "key": "X-CSRF-TOKEN", "type": "text", "value": "" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "http://apidian2026-8.oo/api/table/municipalities/name/Armenia", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "table", "municipalities", "name", "Armenia" ] }, "description": "## **CONSULTAR TABLAS CON VALORES**\n\n**Endpoint:** `GET /api/table/{tableName}/{columnName}/{value}`\n\n**Propósito:** Consulta tablas de referencia del sistema APIDIAN para obtener información de municipios, departamentos, tipos de documento, métodos de pago, y otras tablas maestras utilizadas en la facturación electrónica. Útil para validaciones y autocompletado en formularios.\n\n---\n\n### **📌 NOTAS CRÍTICAS**\n\n**📌 1. ESTRUCTURA DE LA URL (3 PARÁMETROS)**\n```\nGET /api/table/{tableName}/{columnName}/{value}\n```\n- **tableName** → Nombre de la tabla a consultar (municipalities, departments, type_documents, etc.)\n- **columnName** → Columna por la cual filtrar (name, code, id, etc.)\n- **value** → Valor a buscar en la columna especificada\n\n**Ejemplo:**\n```\nGET /api/table/municipalities/name/Armenia\n```\nBusca en la tabla `municipalities` todos los registros donde la columna `name` contenga \"Armenia\".\n\n**📌 2. TABLAS DISPONIBLES EN EL SISTEMA**\n\n| Tabla | Descripción | Columnas Comunes |\n|-------|-------------|------------------|\n| `municipalities` | Municipios de Colombia | id, name, department_id, code |\n| `departments` | Departamentos de Colombia | id, name, code |\n| `countries` | Países | id, name, code |\n| `type_documents` | Tipos de documento de identidad | id, name, code |\n| `type_organizations` | Tipos de organización | id, name, code |\n| `type_regimes` | Tipos de régimen fiscal | id, name, code |\n| `type_liabilities` | Tipos de responsabilidad fiscal | id, name, code |\n| `payment_forms` | Formas de pago | id, name, code |\n| `payment_methods` | Medios de pago | id, name, code |\n| `currencies` | Monedas | id, name, code |\n| `units` | Unidades de medida | id, name, code |\n| `type_operations` | Tipos de operación | id, name, code |\n\n**📌 3. BÚSQUEDA POR DIFERENTES COLUMNAS**\n```javascript\n// Buscar municipio por NOMBRE\nGET /api/table/municipalities/name/Armenia\n\n// Buscar municipio por CÓDIGO DANE\nGET /api/table/municipalities/code/63001\n\n// Buscar municipio por ID\nGET /api/table/municipalities/id/1\n\n// Buscar departamento por NOMBRE\nGET /api/table/departments/name/Quindío\n\n// Buscar tipo documento por CÓDIGO\nGET /api/table/type_documents/code/31\n```\n\n**📌 4. RESPUESTA JSON CON ARRAY DE RESULTADOS**\n```json\n{\n \"success\": true,\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Armenia\",\n \"code\": \"63001\",\n \"department_id\": 19,\n \"created_at\": \"2024-01-01T00:00:00.000000Z\",\n \"updated_at\": \"2024-01-01T00:00:00.000000Z\"\n }\n ],\n \"count\": 1\n}\n```\n- **data** → Array de registros encontrados (puede estar vacío si no hay resultados)\n- **count** → Número de registros encontrados\n\n**📌 5. BÚSQUEDA PARCIAL (LIKE)**\n- La búsqueda es **case-insensitive** (no distingue mayúsculas/minúsculas)\n- Funciona con coincidencias parciales (LIKE '%value%')\n```javascript\n// Busca todos los municipios que contengan \"San\" en el nombre\nGET /api/table/municipalities/name/San\n// Retorna: San José, San Pedro, San Antonio, Santa Rosa, etc.\n```\n\n**📌 6. MÉTODO HTTP: GET (NO POST)**\n- Este endpoint usa **GET**, no POST\n- El body debe estar vacío\n- Todos los parámetros van en la URL\n- Ideal para cachear resultados en el cliente\n\n**📌 7. CASOS DE USO PRINCIPALES**\n- **Autocompletado de municipios** → Al usuario escribir \"Bogo\" sugerir \"Bogotá\"\n- **Validación de códigos DANE** → Verificar que un código de municipio existe\n- **Dropdowns dinámicos** → Cargar listas de departamentos, tipos de documento, etc.\n- **Validación de datos de facturas** → Asegurar que municipio/departamento son válidos\n- **Sincronización de catálogos** → Mantener actualizadas tablas maestras en sistemas externos\n\n**📌 8. OBTENER TODOS LOS REGISTROS DE UNA TABLA**\n```javascript\n// Para obtener TODOS los municipios (sin filtro específico)\n// Usar un valor genérico o consultar directamente la tabla en BD\n\n// Opción 1: Buscar con valor vacío (puede no funcionar)\nGET /api/table/municipalities/name/\n\n// Opción 2: Buscar con wildcard\nGET /api/table/municipalities/name/*\n\n// Opción 3: Consultar directamente la base de datos (recomendado)\nconst municipalities = await Municipality.all();\n```\n\n**📌 9. VALIDACIÓN DE MUNICIPIO Y DEPARTAMENTO**\n```javascript\nconst validateLocation = async (municipalityName, departmentName) => {\n // 1. Buscar municipio\n const munResponse = await axios.get(\n `http://midominio.com/api/table/municipalities/name/${municipalityName}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n if (munResponse.data.count === 0) {\n throw new Error(`Municipio \"${municipalityName}\" no encontrado`);\n }\n \n const municipality = munResponse.data.data[0];\n \n // 2. Buscar departamento\n const depResponse = await axios.get(\n `http://midominio.com/api/table/departments/id/${municipality.department_id}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n const department = depResponse.data.data[0];\n \n // 3. Validar coincidencia\n if (department.name.toLowerCase() !== departmentName.toLowerCase()) {\n throw new Error(`El municipio \"${municipalityName}\" no pertenece al departamento \"${departmentName}\"`);\n }\n \n return { municipality, department };\n};\n```\n\n**📌 10. AUTOCOMPLETADO EN FORMULARIOS**\n```javascript\n// Componente de autocompletado de municipios\nconst MunicipalityAutocomplete = ({ onChange }) => {\n const [query, setQuery] = useState('');\n const [suggestions, setSuggestions] = useState([]);\n const [loading, setLoading] = useState(false);\n \n const searchMunicipalities = async (searchTerm) => {\n if (searchTerm.length < 3) return; // Mínimo 3 caracteres\n \n setLoading(true);\n try {\n const response = await axios.get(\n `http://midominio.com/api/table/municipalities/name/${searchTerm}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n setSuggestions(response.data.data);\n } catch (error) {\n console.error('Error buscando municipios:', error);\n } finally {\n setLoading(false);\n }\n };\n \n const handleInputChange = (e) => {\n const value = e.target.value;\n setQuery(value);\n searchMunicipalities(value);\n };\n \n return (\n
\n \n {loading && Buscando...}\n
    \n {suggestions.map(mun => (\n
  • onChange(mun)}>\n {mun.name} ({mun.code})\n
    • \n ))}\n
\n
\n );\n};\n```\n\n**📌 11. SINCRONIZAR TABLAS MAESTRAS**\n```javascript\n// Sincronizar todas las tablas maestras con sistema externo\nconst syncMasterTables = async () => {\n const tables = [\n 'municipalities',\n 'departments',\n 'type_documents',\n 'payment_forms',\n 'currencies'\n ];\n \n for (const tableName of tables) {\n console.log(`Sincronizando tabla: ${tableName}...`);\n \n // Obtener todos los registros (método directo en BD)\n const records = await DB.table(tableName).select('*').get();\n \n // Guardar en sistema externo\n await externalAPI.post('/sync-table', {\n table: tableName,\n data: records\n });\n \n console.log(`✅ ${records.length} registros sincronizados`);\n }\n};\n```\n\n**📌 12. VALIDAR CÓDIGO DANE**\n```javascript\nconst validateDANECode = async (daneCode) => {\n const response = await axios.get(\n `http://midominio.com/api/table/municipalities/code/${daneCode}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n if (response.data.count === 0) {\n throw new Error(`Código DANE \"${daneCode}\" no existe`);\n }\n \n const municipality = response.data.data[0];\n console.log(`✅ Código DANE válido: ${municipality.name}`);\n \n return municipality;\n};\n```\n\n**📌 13. MANEJO DE CARACTERES ESPECIALES EN LA URL**\n```javascript\n// Codificar caracteres especiales (tildes, espacios, etc.)\nconst searchMunicipality = async (name) => {\n const encodedName = encodeURIComponent(name);\n \n const response = await axios.get(\n `http://midominio.com/api/table/municipalities/name/${encodedName}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n return response.data.data;\n};\n\n// Ejemplos:\nawait searchMunicipality('Bogotá'); // → Bogot%C3%A1\nawait searchMunicipality('San José'); // → San%20Jos%C3%A9\nawait searchMunicipality('Quibdó'); // → Quibd%C3%B3\n```\n\n**📌 14. CACHÉ DE RESULTADOS**\n```javascript\nconst municipalityCache = new Map();\n\nconst getMunicipalityWithCache = async (name) => {\n // Verificar caché\n if (municipalityCache.has(name)) {\n console.log('✅ Resultado desde caché');\n return municipalityCache.get(name);\n }\n \n // Consultar API\n const response = await axios.get(\n `http://midominio.com/api/table/municipalities/name/${encodeURIComponent(name)}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n const result = response.data.data;\n \n // Guardar en caché (expiración 1 hora)\n municipalityCache.set(name, result);\n setTimeout(() => municipalityCache.delete(name), 3600000);\n \n return result;\n};\n```\n\n**📌 15. DROPDOWN DINÁMICO DE DEPARTAMENTOS Y MUNICIPIOS**\n```jsx\nconst LocationSelector = ({ onSelect }) => {\n const [departments, setDepartments] = useState([]);\n const [municipalities, setMunicipalities] = useState([]);\n const [selectedDept, setSelectedDept] = useState(null);\n \n // Cargar departamentos al montar\n useEffect(() => {\n const loadDepartments = async () => {\n const response = await axios.get(\n 'http://midominio.com/api/table/departments/id/1', // Truco: obtener todos\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n setDepartments(response.data.data);\n };\n loadDepartments();\n }, []);\n \n // Cargar municipios al seleccionar departamento\n const handleDepartmentChange = async (deptId) => {\n setSelectedDept(deptId);\n \n const response = await axios.get(\n `http://midominio.com/api/table/municipalities/department_id/${deptId}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n setMunicipalities(response.data.data);\n };\n \n return (\n
\n \n \n \n
\n );\n};\n```\n\n---\n\n### **📊 TABLA DE PARÁMETROS**\n\n| Parámetro | Ubicación | Tipo | Requerido | Descripción |\n|-----------|-----------|------|-----------|-------------|\n| `tableName` | Path (URL) | String | ✅ Sí | Nombre de la tabla a consultar |\n| `columnName` | Path (URL) | String | ✅ Sí | Columna por la cual filtrar |\n| `value` | Path (URL) | String | ✅ Sí | Valor a buscar (codificar caracteres especiales) |\n| `Authorization` | Header | String | ✅ Sí | Token Bearer del API |\n\n---\n\n### **📊 TABLA DE RESPUESTAS**\n\n| Código | Descripción | Body |\n|--------|-------------|------|\n| **200** | Consulta exitosa | `{ success: true, data: [...], count: N }` |\n| **200** | Sin resultados | `{ success: true, data: [], count: 0 }` |\n| **404** | Tabla no encontrada | `{ message: \"Table not found\" }` |\n| **401** | Token inválido | `{ message: \"Unauthenticated.\" }` |\n| **500** | Error interno | `{ message: \"Server error\" }` |\n\n---\n\n### **🔧 EJEMPLO DE USO: JAVASCRIPT/AXIOS**\n\n```javascript\nconst axios = require('axios');\n\nconst searchMunicipality = async () => {\n try {\n const response = await axios.get(\n 'http://midominio.com/api/table/municipalities/name/Armenia',\n {\n headers: {\n 'Authorization': 'Bearer 4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa',\n 'Content-Type': 'application/json'\n }\n }\n );\n \n console.log('✅ Resultados encontrados:', response.data.count);\n console.log('Datos:', response.data.data);\n \n response.data.data.forEach(mun => {\n console.log(`- ${mun.name} (Código DANE: ${mun.code})`);\n });\n \n } catch (error) {\n console.error('❌ Error:', error.response?.data || error.message);\n }\n};\n\nsearchMunicipality();\n```\n\n---\n\n### **🔧 EJEMPLO: CURL**\n\n```bash\ncurl -X GET \"http://midominio.com/api/table/municipalities/name/Armenia\" \\\n -H \"Authorization: Bearer 4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa\" \\\n -H \"Content-Type: application/json\"\n```\n\n---\n\n### **📖 ESCENARIOS DE USO**\n\n**Escenario 1: Validar Dirección de Cliente**\n```javascript\nconst validateCustomerAddress = async (customer) => {\n const mun = await searchMunicipality(customer.city);\n const dept = await searchDepartment(customer.department);\n \n if (mun.length === 0 || dept.length === 0) {\n throw new Error('Ubicación inválida');\n }\n \n return { municipalityCode: mun[0].code, departmentCode: dept[0].code };\n};\n```\n\n**Escenario 2: Autocompletado de Formulario**\n```javascript\nconst autocomplete = async (searchTerm) => {\n const results = await getMunicipalityWithCache(searchTerm);\n return results.slice(0, 10); // Top 10 resultados\n};\n```\n\n**Escenario 3: Migración de Datos**\n```javascript\nconst migrateLegacyData = async () => {\n const legacyCustomers = await getLegacyCustomers();\n \n for (const customer of legacyCustomers) {\n const mun = await searchMunicipality(customer.city_name);\n customer.municipality_id = mun[0]?.id || null;\n await updateCustomer(customer);\n }\n};\n```\n\n---\n\n### **✅ MEJORES PRÁCTICAS**\n\n1. **Codificar caracteres especiales** → Usar `encodeURIComponent()` para tildes y espacios\n2. **Implementar caché local** → Evitar consultas repetitivas a la API\n3. **Validar longitud mínima en búsquedas** → Mínimo 3 caracteres para autocompletado\n4. **Manejar resultados vacíos** → Mostrar mensaje al usuario si no hay coincidencias\n5. **Limitar resultados en UI** → Mostrar máximo 10-15 sugerencias en autocompletado\n6. **Precargar tablas pequeñas** → Departamentos, tipos de documento (pocas filas)\n7. **Usar debounce en búsquedas en vivo** → Evitar requests excesivos al escribir\n8. **Validar siempre antes de facturar** → Asegurar que municipio/departamento existan" }, "response": [] }, { "name": "SearchNameByNIT", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Content-Type", "type": "text", "value": "application/json" }, { "key": "cache-control", "type": "text", "value": "no-cache" }, { "key": "Connection", "type": "text", "value": "keep-alive" }, { "key": "Accept-Encoding", "type": "text", "value": "gzip, deflate" }, { "key": "Host", "type": "text", "value": "apidian2026-8.oo", "disabled": true }, { "key": "accept", "type": "text", "value": "application/json" }, { "key": "X-CSRF-TOKEN", "type": "text", "value": "" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/name-by-nit/42061403", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "name-by-nit", "42061403" ] }, "description": "## **SEARCH NAME BY NIT**\n\n**Endpoint:** `GET /api/ubl2.1/name-by-nit/{nit}`\n\n**Propósito:** Busca el nombre o razón social de una persona o empresa registrada en el sistema APIDIAN mediante su número de identificación tributaria (NIT o documento). Útil para autocompletar formularios y validar clientes al crear facturas.\n\n---\n\n### **📌 NOTAS CRÍTICAS**\n\n**📌 1. NIT EN LA RUTA (PATH PARAMETER)**\n- El NIT se pasa como parte de la URL, **NO en el body**\n- Formato: `/api/ubl2.1/name-by-nit/{nit}`\n- Ejemplo: `/api/ubl2.1/name-by-nit/42061403`\n- Soporta NIT con o sin dígito de verificación (DV)\n\n**📌 2. BÚSQUEDA EN TABLA DE CLIENTES**\n```sql\n-- El endpoint busca en la tabla 'customers'\nSELECT * FROM customers \nWHERE identification_number = '42061403' \nLIMIT 1;\n```\n- Busca en la columna `identification_number` de la tabla `customers`\n- **NO busca en registros públicos de la DIAN** (solo en base de datos local)\n- Retorna solo clientes previamente registrados en el sistema\n\n**📌 3. DIFERENCIA CON SearchCompanyByNIT**\n\n| Endpoint | Fuente de Datos | Retorna |\n|----------|-----------------|----------|\n| `name-by-nit/{nit}` | Tabla `customers` local | Solo nombre/razón social |\n| `company-by-nit/{nit}` | Tabla `customers` local | Datos completos del cliente |\n| *(Futuro)* API DIAN | Registros públicos DIAN | Datos oficiales RUT |\n\n- **name-by-nit** → Retorna solo el nombre (ligero, rápido)\n- **company-by-nit** → Retorna objeto completo (nombre, email, teléfono, dirección, etc.)\n\n**📌 4. MÉTODO HTTP: GET (NO POST)**\n- Este endpoint usa **GET**, no POST\n- El body debe estar vacío\n- Todo va en la URL (path parameter)\n- Ideal para requests rápidas de autocompletado\n\n**📌 5. RESPUESTA JSON SIMPLE**\n```json\n{\n \"success\": true,\n \"name\": \"ALEXANDER OBANDO LONDOÑO\"\n}\n```\n- **name** → Nombre completo o razón social del cliente\n- Respuesta minimalista (solo el nombre, nada más)\n\n**📌 6. RESPUESTA SI EL NIT NO EXISTE**\n```json\n{\n \"success\": false,\n \"message\": \"Cliente no encontrado con NIT 42061403\"\n}\n```\n- **success: false** → Indica que no se encontró el cliente\n- El endpoint **NO falla con error 404**, retorna 200 con success: false\n\n**📌 7. CASOS DE USO PRINCIPALES**\n- **Autocompletado de facturas** → Usuario ingresa NIT, sistema autocompleta nombre\n- **Validación de clientes** → Verificar que el cliente existe antes de facturar\n- **Búsqueda rápida en POS** → Cajero busca cliente por cédula\n- **Formularios de notas crédito/débito** → Autocompletar datos del cliente\n- **Verificación pre-registro** → Evitar duplicados antes de registrar cliente\n\n**📌 8. AUTOCOMPLETADO EN FORMULARIO DE FACTURA**\n```javascript\nconst InvoiceForm = () => {\n const [nit, setNit] = useState('');\n const [customerName, setCustomerName] = useState('');\n const [loading, setLoading] = useState(false);\n \n const searchByNIT = async (nitValue) => {\n if (nitValue.length < 6) return; // Mínimo 6 dígitos\n \n setLoading(true);\n try {\n const response = await axios.get(\n `http://midominio.com/api/ubl2.1/name-by-nit/${nitValue}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n if (response.data.success) {\n setCustomerName(response.data.name);\n console.log('✅ Cliente encontrado:', response.data.name);\n } else {\n setCustomerName('');\n alert('Cliente no encontrado. ¿Desea registrarlo?');\n }\n } catch (error) {\n console.error('Error buscando cliente:', error);\n } finally {\n setLoading(false);\n }\n };\n \n return (\n
\n setNit(e.target.value)}\n onBlur={(e) => searchByNIT(e.target.value)}\n />\n {loading && Buscando...}\n \n
\n );\n};\n```\n\n**📌 9. VALIDACIÓN ANTES DE CREAR FACTURA**\n```javascript\nconst validateCustomerBeforeInvoice = async (nit) => {\n const response = await axios.get(\n `http://midominio.com/api/ubl2.1/name-by-nit/${nit}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n if (!response.data.success) {\n throw new Error(`Cliente con NIT ${nit} no está registrado. Debe registrarlo primero.`);\n }\n \n console.log(`✅ Cliente validado: ${response.data.name}`);\n return response.data.name;\n};\n\n// Uso en flujo de facturación\ntry {\n const customerName = await validateCustomerBeforeInvoice('42061403');\n \n // Proceder a crear factura\n await createInvoice({\n customer: { identification_number: '42061403', name: customerName },\n // ... resto de datos de la factura\n });\n} catch (error) {\n alert(error.message);\n}\n```\n\n**📌 10. BÚSQUEDA CON DEBOUNCE (OPTIMIZACIÓN)**\n```javascript\nconst useDebounce = (value, delay) => {\n const [debouncedValue, setDebouncedValue] = useState(value);\n \n useEffect(() => {\n const handler = setTimeout(() => {\n setDebouncedValue(value);\n }, delay);\n \n return () => clearTimeout(handler);\n }, [value, delay]);\n \n return debouncedValue;\n};\n\n// Uso en componente\nconst CustomerSearch = () => {\n const [nit, setNit] = useState('');\n const [result, setResult] = useState(null);\n const debouncedNIT = useDebounce(nit, 500); // 500ms de espera\n \n useEffect(() => {\n if (debouncedNIT.length >= 6) {\n searchCustomer(debouncedNIT);\n }\n }, [debouncedNIT]);\n \n const searchCustomer = async (nitValue) => {\n const response = await axios.get(\n `http://midominio.com/api/ubl2.1/name-by-nit/${nitValue}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n setResult(response.data);\n };\n \n return (\n
\n setNit(e.target.value)}\n placeholder=\"Ingrese NIT...\"\n />\n {result?.success &&

✅ {result.name}

}\n {result?.success === false &&

❌ Cliente no encontrado

}\n
\n );\n};\n```\n\n**📌 11. VERIFICAR DUPLICADOS ANTES DE REGISTRAR**\n```javascript\nconst checkDuplicateBeforeRegister = async (nit, name) => {\n const response = await axios.get(\n `http://midominio.com/api/ubl2.1/name-by-nit/${nit}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n if (response.data.success) {\n const confirmed = confirm(\n `Ya existe un cliente con NIT ${nit}:\\n\"${response.data.name}\"\\n\\n¿Desea actualizar sus datos?`\n );\n \n if (confirmed) {\n // Actualizar cliente existente\n await axios.put('/api/ubl2.1/register-update-customer', {\n identification_number: nit,\n name: name,\n // ... otros datos\n });\n } else {\n throw new Error('Registro cancelado');\n }\n } else {\n // No existe, proceder a registrar\n await axios.put('/api/ubl2.1/register-update-customer', {\n identification_number: nit,\n name: name,\n // ... otros datos\n });\n }\n};\n```\n\n**📌 12. INTEGRACIÓN CON ENDPOINT COMPLETO**\n```javascript\n// Flujo completo: buscar nombre, luego obtener datos completos\nconst getFullCustomerData = async (nit) => {\n // 1. Verificar que existe (búsqueda rápida)\n const nameResponse = await axios.get(\n `http://midominio.com/api/ubl2.1/name-by-nit/${nit}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n if (!nameResponse.data.success) {\n throw new Error('Cliente no encontrado');\n }\n \n console.log(`✅ Cliente encontrado: ${nameResponse.data.name}`);\n \n // 2. Obtener datos completos\n const fullDataResponse = await axios.get(\n `http://midominio.com/api/ubl2.1/company-by-nit/${nit}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n return fullDataResponse.data;\n};\n```\n\n**📌 13. MANEJO DE NITs CON DÍGITO DE VERIFICACIÓN**\n```javascript\n// Algunos usuarios ingresan NIT con DV (ejemplo: 42061403-5)\nconst normalizeNIT = (nit) => {\n // Remover espacios, guiones y puntos\n return nit.replace(/[\\s.-]/g, '');\n};\n\nconst searchByNIT = async (rawNIT) => {\n const cleanNIT = normalizeNIT(rawNIT);\n \n const response = await axios.get(\n `http://midominio.com/api/ubl2.1/name-by-nit/${cleanNIT}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n return response.data;\n};\n\n// Ejemplos:\nawait searchByNIT('42061403'); // → '42061403'\nawait searchByNIT('42061403-5'); // → '420614035' o '42061403' (según formato en BD)\nawait searchByNIT('42.061.403-5'); // → '420614035' o '42061403'\n```\n\n**📌 14. CACHÉ DE BÚSQUEDAS FRECUENTES**\n```javascript\nconst customerCache = new Map();\n\nconst searchWithCache = async (nit) => {\n // Verificar caché\n if (customerCache.has(nit)) {\n console.log('✅ Resultado desde caché');\n return customerCache.get(nit);\n }\n \n // Consultar API\n const response = await axios.get(\n `http://midominio.com/api/ubl2.1/name-by-nit/${nit}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n // Guardar en caché (expiración 5 minutos)\n if (response.data.success) {\n customerCache.set(nit, response.data.name);\n setTimeout(() => customerCache.delete(nit), 300000);\n }\n \n return response.data.name;\n};\n```\n\n**📌 15. INTEGRACIÓN CON POS (PUNTO DE VENTA)**\n```javascript\n// Sistema POS: búsqueda rápida en caja\nconst POSCustomerSearch = ({ onCustomerSelect }) => {\n const [nit, setNit] = useState('');\n const [searching, setSearching] = useState(false);\n \n const handleSearch = async () => {\n if (nit.length < 6) {\n alert('Ingrese al menos 6 dígitos');\n return;\n }\n \n setSearching(true);\n try {\n const response = await axios.get(\n `http://midominio.com/api/ubl2.1/name-by-nit/${nit}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n if (response.data.success) {\n // Cliente encontrado, cargar datos completos\n const fullData = await axios.get(\n `http://midominio.com/api/ubl2.1/company-by-nit/${nit}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n onCustomerSelect(fullData.data);\n } else {\n // Cliente no encontrado, ofrecer registro rápido\n const register = confirm('Cliente no encontrado. ¿Registrar ahora?');\n if (register) {\n openQuickRegisterModal(nit);\n }\n }\n } catch (error) {\n alert('Error al buscar cliente');\n } finally {\n setSearching(false);\n }\n };\n \n return (\n
\n setNit(e.target.value)}\n onKeyPress={(e) => e.key === 'Enter' && handleSearch()}\n placeholder=\"NIT o Cédula\"\n disabled={searching}\n />\n \n
\n );\n};\n```\n\n---\n\n### **📊 TABLA DE PARÁMETROS**\n\n| Parámetro | Ubicación | Tipo | Requerido | Descripción |\n|-----------|-----------|------|-----------|-------------|\n| `nit` | Path (URL) | String | ✅ Sí | Número de identificación tributaria (NIT o documento) |\n| `Authorization` | Header | String | ✅ Sí | Token Bearer del API |\n\n---\n\n### **📊 TABLA DE RESPUESTAS**\n\n| Código | Descripción | Body |\n|--------|-------------|------|\n| **200** | Cliente encontrado | `{ success: true, name: \"NOMBRE COMPLETO\" }` |\n| **200** | Cliente no encontrado | `{ success: false, message: \"Cliente no encontrado...\" }` |\n| **401** | Token inválido | `{ message: \"Unauthenticated.\" }` |\n| **500** | Error interno | `{ message: \"Server error\" }` |\n\n---\n\n### **🔧 EJEMPLO DE USO: JAVASCRIPT/AXIOS**\n\n```javascript\nconst axios = require('axios');\n\nconst searchNameByNIT = async (nit) => {\n try {\n const response = await axios.get(\n `http://midominio.com/api/ubl2.1/name-by-nit/${nit}`,\n {\n headers: {\n 'Authorization': 'Bearer 4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa',\n 'Content-Type': 'application/json'\n }\n }\n );\n \n if (response.data.success) {\n console.log('✅ Cliente encontrado:', response.data.name);\n return response.data.name;\n } else {\n console.log('❌ Cliente no encontrado');\n return null;\n }\n \n } catch (error) {\n console.error('❌ Error:', error.response?.data || error.message);\n }\n};\n\n// Uso\nconst customerName = await searchNameByNIT('42061403');\nif (customerName) {\n console.log(`Proceder a facturar a: ${customerName}`);\n} else {\n console.log('Debe registrar el cliente primero');\n}\n```\n\n---\n\n### **🔧 EJEMPLO: CURL**\n\n```bash\ncurl -X GET \"http://midominio.com/api/ubl2.1/name-by-nit/42061403\" \\\n -H \"Authorization: Bearer 4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa\" \\\n -H \"Content-Type: application/json\"\n```\n\n---\n\n### **📖 ESCENARIOS DE USO**\n\n**Escenario 1: Autocompletado en Facturación**\n```javascript\nconst handleNITBlur = async (nit) => {\n const name = await searchNameByNIT(nit);\n if (name) {\n document.getElementById('customer-name').value = name;\n }\n};\n```\n\n**Escenario 2: Validación Pre-Factura**\n```javascript\nconst validateBeforeInvoice = async (nit) => {\n const response = await axios.get(`/api/ubl2.1/name-by-nit/${nit}`);\n if (!response.data.success) {\n throw new Error('Cliente no registrado');\n }\n};\n```\n\n**Escenario 3: Búsqueda Rápida en POS**\n```javascript\nconst quickSearch = async (nit) => {\n const name = await searchNameByNIT(nit);\n return name || 'CONSUMIDOR FINAL';\n};\n```\n\n---\n\n### **✅ MEJORES PRÁCTICAS**\n\n1. **Implementar debounce en búsquedas en vivo** → Evitar requests excesivos\n2. **Validar longitud mínima del NIT** → Mínimo 6 dígitos antes de buscar\n3. **Normalizar NITs antes de buscar** → Remover espacios, guiones, puntos\n4. **Caché de búsquedas frecuentes** → Reducir carga en el servidor\n5. **Ofrecer registro rápido si no existe** → Mejor experiencia de usuario\n6. **Usar para validación, no para obtener datos completos** → Para datos completos usar company-by-nit\n7. **Implementar rate limiting en cliente** → Evitar abusos\n8. **Mostrar feedback visual durante búsqueda** → Spinner o mensaje \"Buscando...\"" }, "response": [] }, { "name": "Get Reference Notes - Obtener Notas de un Documento", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Content-Type", "type": "text", "value": "application/json" }, { "key": "cache-control", "type": "text", "value": "no-cache" }, { "key": "Connection", "type": "text", "value": "keep-alive" }, { "key": "Accept-Encoding", "type": "text", "value": "gzip, deflate" }, { "key": "Host", "type": "text", "value": "apidian2026-8.oo", "disabled": true }, { "key": "accept", "type": "text", "value": "application/json" }, { "key": "X-CSRF-TOKEN", "type": "text", "value": "" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/document/get-reference-notes/cf2f3415b1a3d90501df87a899640eeb86d02bbc40cdc56115e2fa885ccc81a2f318bcb7010dff4db4747719e2c95dd6", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "document", "get-reference-notes", "cf2f3415b1a3d90501df87a899640eeb86d02bbc40cdc56115e2fa885ccc81a2f318bcb7010dff4db4747719e2c95dd6" ] }, "description": "## **GET REFERENCE NOTES - OBTENER NOTAS DE UN DOCUMENTO**\n\n**Endpoint:** `GET /api/ubl2.1/document/get-reference-notes/{uuid}`\n\n**Propósito:** Recupera todas las notas crédito y notas débito asociadas a un documento específico (factura o nota) mediante su UUID. Permite consultar el historial completo de ajustes, devoluciones y correcciones aplicadas a un documento.\n\n---\n\n### **📌 NOTAS CRÍTICAS**\n\n**📌 1. UUID EN LA RUTA (PATH PARAMETER)**\n- El UUID del **documento de referencia** se pasa en la URL\n- Formato: `/api/ubl2.1/document/get-reference-notes/{uuid}`\n- Ejemplo: `/api/ubl2.1/document/get-reference-notes/cf2f3415b1a3d90501df87a899640eeb86d02bbc40cdc56115e2fa885ccc81a2f318bcb7010dff4db4747719e2c95dd6`\n- El UUID debe ser del documento **original** (la factura), no de las notas\n\n**📌 2. RELACIÓN ENTRE DOCUMENTOS**\n```\nFactura Original (UUID: abc123...)\n ├── Nota Crédito 1 (UUID: xyz789...) → Referencia a abc123...\n ├── Nota Crédito 2 (UUID: def456...) → Referencia a abc123...\n └── Nota Débito 1 (UUID: ghi789...) → Referencia a abc123...\n```\n- Este endpoint retorna **todas las notas** que referencian el UUID especificado\n- Útil para ver el historial completo de ajustes a una factura\n\n**📌 3. TIPOS DE NOTAS RETORNADAS**\n\n| Tipo | Código | Propósito |\n|------|--------|----------|\n| **Nota Crédito** | 91 | Anular, devolver o corregir una factura (reduce el valor) |\n| **Nota Débito** | 92 | Aumentar el valor de una factura (cargos adicionales) |\n\n**📌 4. MÉTODO HTTP: GET (NO POST)**\n- Este endpoint usa **GET**, no POST\n- El body debe estar vacío\n- UUID va exclusivamente en la URL\n- Ideal para consultas rápidas de historial\n\n**📌 5. RESPUESTA JSON CON ARRAY DE NOTAS**\n```json\n{\n \"success\": true,\n \"data\": [\n {\n \"id\": 150,\n \"uuid\": \"xyz789abc...\",\n \"type_document_id\": 91,\n \"type_document_name\": \"Nota Crédito\",\n \"number\": \"NC-001\",\n \"prefix\": \"NC\",\n \"issue_date\": \"2025-01-15\",\n \"cufe\": \"c3d5f6a8b1e9d4c7b3a2f8e1...\",\n \"total\": 150000.00,\n \"status\": \"Aceptado\",\n \"customer_name\": \"ALEXANDER OBANDO LONDOÑO\",\n \"customer_identification\": \"42061403\",\n \"reference_document_uuid\": \"cf2f3415b1a3d90501df87a899640eeb...\",\n \"reference_document_number\": \"SETP990000001\",\n \"discrepancy_response_description\": \"Devolución parcial de mercancía\",\n \"created_at\": \"2025-01-15T10:30:00Z\"\n },\n {\n \"id\": 155,\n \"uuid\": \"def456ghi...\",\n \"type_document_id\": 91,\n \"type_document_name\": \"Nota Crédito\",\n \"number\": \"NC-002\",\n \"prefix\": \"NC\",\n \"issue_date\": \"2025-01-20\",\n \"cufe\": \"d4e6g7b9c2f0e5d8c4b3...\",\n \"total\": 50000.00,\n \"status\": \"Aceptado\",\n \"customer_name\": \"ALEXANDER OBANDO LONDOÑO\",\n \"customer_identification\": \"42061403\",\n \"reference_document_uuid\": \"cf2f3415b1a3d90501df87a899640eeb...\",\n \"reference_document_number\": \"SETP990000001\",\n \"discrepancy_response_description\": \"Descuento comercial\",\n \"created_at\": \"2025-01-20T14:15:00Z\"\n }\n ],\n \"count\": 2,\n \"total_credit_notes\": 200000.00,\n \"total_debit_notes\": 0.00,\n \"net_adjustment\": -200000.00\n}\n```\n\n**📌 6. RESPUESTA SI NO HAY NOTAS ASOCIADAS**\n```json\n{\n \"success\": true,\n \"data\": [],\n \"count\": 0,\n \"message\": \"No se encontraron notas asociadas a este documento\"\n}\n```\n- **NO retorna error 404** si no hay notas\n- Retorna array vacío con success: true\n\n**📌 7. CASOS DE USO PRINCIPALES**\n- **Consultar historial de ajustes** → Ver todas las modificaciones a una factura\n- **Validar saldo pendiente** → Calcular valor neto tras notas crédito/débito\n- **Auditorías contables** → Rastrear correcciones y devoluciones\n- **Reportes de cartera** → Verificar abonos y cargos adicionales\n- **Integración con sistemas contables** → Sincronizar ajustes a facturas\n- **Portal del cliente** → Mostrar historial completo de una factura\n\n**📌 8. CALCULAR SALDO NETO DE UNA FACTURA**\n```javascript\nconst calculateNetBalance = async (invoiceUUID) => {\n // 1. Obtener factura original\n const invoice = await Document.where('uuid', invoiceUUID).first();\n const originalAmount = parseFloat(invoice.total);\n \n // 2. Obtener todas las notas asociadas\n const response = await axios.get(\n `http://midominio.com/api/ubl2.1/document/get-reference-notes/${invoiceUUID}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n const notes = response.data.data;\n \n // 3. Calcular ajustes\n let totalCreditNotes = 0;\n let totalDebitNotes = 0;\n \n notes.forEach(note => {\n if (note.type_document_id === 91) {\n // Nota Crédito (reduce saldo)\n totalCreditNotes += parseFloat(note.total);\n } else if (note.type_document_id === 92) {\n // Nota Débito (aumenta saldo)\n totalDebitNotes += parseFloat(note.total);\n }\n });\n \n // 4. Calcular saldo neto\n const netBalance = originalAmount - totalCreditNotes + totalDebitNotes;\n \n console.log('Factura original:', originalAmount);\n console.log('Notas crédito:', -totalCreditNotes);\n console.log('Notas débito:', +totalDebitNotes);\n console.log('Saldo neto:', netBalance);\n \n return {\n originalAmount,\n totalCreditNotes,\n totalDebitNotes,\n netBalance\n };\n};\n```\n\n**📌 9. MOSTRAR HISTORIAL EN PORTAL DEL CLIENTE**\n```jsx\nconst InvoiceHistory = ({ invoiceUUID }) => {\n const [invoice, setInvoice] = useState(null);\n const [notes, setNotes] = useState([]);\n const [loading, setLoading] = useState(true);\n \n useEffect(() => {\n loadInvoiceHistory();\n }, [invoiceUUID]);\n \n const loadInvoiceHistory = async () => {\n try {\n // Cargar factura original\n const invoiceData = await getDocumentByUUID(invoiceUUID);\n setInvoice(invoiceData);\n \n // Cargar notas asociadas\n const response = await axios.get(\n `http://midominio.com/api/ubl2.1/document/get-reference-notes/${invoiceUUID}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n setNotes(response.data.data);\n } catch (error) {\n console.error('Error cargando historial:', error);\n } finally {\n setLoading(false);\n }\n };\n \n if (loading) return
Cargando...
;\n \n return (\n
\n

Historial de Factura {invoice.number}

\n \n
\n

📄 Factura Original

\n

Fecha: {invoice.issue_date}

\n

Total: ${invoice.total.toLocaleString()}

\n

Estado: {invoice.status}

\n
\n \n {notes.length > 0 && (\n
\n

📝 Ajustes y Correcciones

\n {notes.map(note => (\n
\n

\n {note.type_document_name} {note.number}\n

\n

Fecha: {note.issue_date}

\n

Monto: ${note.total.toLocaleString()}

\n

Motivo: {note.discrepancy_response_description}

\n

Estado: {note.status}

\n
\n ))}\n
\n )}\n \n
\n

💰 Saldo Neto

\n

Total a pagar: ${calculateNetBalance(invoice, notes).toLocaleString()}

\n
\n
\n );\n};\n```\n\n**📌 10. VALIDAR SI UNA FACTURA FUE ANULADA**\n```javascript\nconst isInvoiceCancelled = async (invoiceUUID) => {\n const response = await axios.get(\n `http://midominio.com/api/ubl2.1/document/get-reference-notes/${invoiceUUID}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n const notes = response.data.data;\n \n // Verificar si hay nota crédito por el total de la factura\n const invoice = await Document.where('uuid', invoiceUUID).first();\n const invoiceTotal = parseFloat(invoice.total);\n \n const totalCreditNotes = notes\n .filter(n => n.type_document_id === 91)\n .reduce((sum, n) => sum + parseFloat(n.total), 0);\n \n // Si las notas crédito cubren el 100% de la factura, está anulada\n const isCancelled = totalCreditNotes >= invoiceTotal;\n \n if (isCancelled) {\n console.log('⚠️ Factura anulada completamente');\n }\n \n return isCancelled;\n};\n```\n\n**📌 11. REPORTE DE CARTERA CON AJUSTES**\n```javascript\nconst generatePortfolioReport = async (invoiceUUIDs) => {\n const report = [];\n \n for (const uuid of invoiceUUIDs) {\n const invoice = await Document.where('uuid', uuid).first();\n \n const notesResponse = await axios.get(\n `http://midominio.com/api/ubl2.1/document/get-reference-notes/${uuid}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n const notes = notesResponse.data.data;\n const originalAmount = parseFloat(invoice.total);\n \n const totalCreditNotes = notes\n .filter(n => n.type_document_id === 91)\n .reduce((sum, n) => sum + parseFloat(n.total), 0);\n \n const totalDebitNotes = notes\n .filter(n => n.type_document_id === 92)\n .reduce((sum, n) => sum + parseFloat(n.total), 0);\n \n const netBalance = originalAmount - totalCreditNotes + totalDebitNotes;\n \n report.push({\n invoiceNumber: invoice.number,\n customer: invoice.customer_name,\n issueDate: invoice.issue_date,\n originalAmount,\n creditNotes: totalCreditNotes,\n debitNotes: totalDebitNotes,\n netBalance,\n status: netBalance <= 0 ? 'PAGADO/ANULADO' : 'PENDIENTE'\n });\n }\n \n console.table(report);\n return report;\n};\n```\n\n**📌 12. OBTENER DETALLES DE UNA NOTA ESPECÍFICA**\n```javascript\nconst getNoteDetails = async (invoiceUUID, noteNumber) => {\n const response = await axios.get(\n `http://midominio.com/api/ubl2.1/document/get-reference-notes/${invoiceUUID}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n const notes = response.data.data;\n const note = notes.find(n => n.number === noteNumber);\n \n if (!note) {\n throw new Error(`Nota ${noteNumber} no encontrada`);\n }\n \n return note;\n};\n\n// Uso\nconst note = await getNoteDetails('cf2f3415b1a3d90501df87a899640eeb...', 'NC-001');\nconsole.log('Detalles de la nota:', note);\n```\n\n**📌 13. EXPORTAR HISTORIAL A EXCEL**\n```javascript\nconst XLSX = require('xlsx');\n\nconst exportInvoiceHistoryToExcel = async (invoiceUUID) => {\n const invoice = await Document.where('uuid', invoiceUUID).first();\n \n const response = await axios.get(\n `http://midominio.com/api/ubl2.1/document/get-reference-notes/${invoiceUUID}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n const notes = response.data.data;\n \n // Preparar datos para Excel\n const excelData = [\n {\n Tipo: 'Factura Original',\n Numero: invoice.number,\n Fecha: invoice.issue_date,\n Monto: invoice.total,\n Estado: invoice.status\n },\n ...notes.map(note => ({\n Tipo: note.type_document_name,\n Numero: note.number,\n Fecha: note.issue_date,\n Monto: note.type_document_id === 91 ? -note.total : note.total,\n Estado: note.status,\n Motivo: note.discrepancy_response_description\n }))\n ];\n \n // Crear workbook\n const ws = XLSX.utils.json_to_sheet(excelData);\n const wb = XLSX.utils.book_new();\n XLSX.utils.book_append_sheet(wb, ws, 'Historial');\n \n // Guardar archivo\n XLSX.writeFile(wb, `historial_factura_${invoice.number}.xlsx`);\n console.log('✅ Archivo Excel generado');\n};\n```\n\n**📌 14. NOTIFICAR AL CLIENTE SOBRE NUEVAS NOTAS**\n```javascript\nconst notifyCustomerAboutNotes = async (invoiceUUID) => {\n const response = await axios.get(\n `http://midominio.com/api/ubl2.1/document/get-reference-notes/${invoiceUUID}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n const notes = response.data.data;\n const recentNotes = notes.filter(note => {\n const noteDate = new Date(note.created_at);\n const today = new Date();\n const daysDiff = (today - noteDate) / (1000 * 60 * 60 * 24);\n return daysDiff <= 7; // Notas de los últimos 7 días\n });\n \n if (recentNotes.length > 0) {\n const invoice = await Document.where('uuid', invoiceUUID).first();\n \n await sendEmail({\n to: invoice.customer_email,\n subject: `Ajustes en su factura ${invoice.number}`,\n body: `\n Estimado cliente,\\n\\n\n Se han aplicado los siguientes ajustes a su factura ${invoice.number}:\\n\\n\n ${recentNotes.map(note => \n `- ${note.type_document_name} ${note.number}: $${note.total} (${note.discrepancy_response_description})`\n ).join('\\n')}\n \\n\\nSaludos.\n `\n });\n }\n};\n```\n\n**📌 15. INTEGRACIÓN CON SISTEMA CONTABLE**\n```javascript\nconst syncNotesToAccountingSystem = async (invoiceUUID) => {\n const response = await axios.get(\n `http://midominio.com/api/ubl2.1/document/get-reference-notes/${invoiceUUID}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n const notes = response.data.data;\n \n for (const note of notes) {\n // Enviar a sistema contable\n await accountingSystemAPI.post('/adjustments', {\n reference_document: invoiceUUID,\n adjustment_type: note.type_document_id === 91 ? 'CREDIT' : 'DEBIT',\n adjustment_number: note.number,\n amount: note.total,\n date: note.issue_date,\n description: note.discrepancy_response_description,\n cufe: note.cufe\n });\n \n console.log(`✅ Sincronizado: ${note.number}`);\n }\n};\n```\n\n---\n\n### **📊 TABLA DE PARÁMETROS**\n\n| Parámetro | Ubicación | Tipo | Requerido | Descripción |\n|-----------|-----------|------|-----------|-------------|\n| `uuid` | Path (URL) | String | ✅ Sí | UUID del documento original (128 caracteres) |\n| `Authorization` | Header | String | ✅ Sí | Token Bearer del API |\n\n---\n\n### **📊 TABLA DE RESPUESTAS**\n\n| Código | Descripción | Body |\n|--------|-------------|------|\n| **200** | Notas encontradas | `{ success: true, data: [...], count: N }` |\n| **200** | Sin notas | `{ success: true, data: [], count: 0 }` |\n| **404** | UUID no encontrado | `{ message: \"Document not found\" }` |\n| **401** | Token inválido | `{ message: \"Unauthenticated.\" }` |\n| **500** | Error interno | `{ message: \"Server error\" }` |\n\n---\n\n### **🔧 EJEMPLO DE USO: JAVASCRIPT/AXIOS**\n\n```javascript\nconst axios = require('axios');\n\nconst getReferenceNotes = async (invoiceUUID) => {\n try {\n const response = await axios.get(\n `http://midominio.com/api/ubl2.1/document/get-reference-notes/${invoiceUUID}`,\n {\n headers: {\n 'Authorization': 'Bearer 4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa',\n 'Content-Type': 'application/json'\n }\n }\n );\n \n console.log(`✅ Encontradas ${response.data.count} notas`);\n console.log('Notas:', response.data.data);\n \n response.data.data.forEach(note => {\n console.log(`- ${note.type_document_name} ${note.number}: $${note.total}`);\n });\n \n return response.data.data;\n \n } catch (error) {\n console.error('❌ Error:', error.response?.data || error.message);\n }\n};\n\n// Uso\nconst notes = await getReferenceNotes('cf2f3415b1a3d90501df87a899640eeb86d02bbc40cdc56115e2fa885ccc81a2f318bcb7010dff4db4747719e2c95dd6');\n```\n\n---\n\n### **🔧 EJEMPLO: CURL**\n\n```bash\ncurl -X GET \"http://midominio.com/api/ubl2.1/document/get-reference-notes/cf2f3415b1a3d90501df87a899640eeb86d02bbc40cdc56115e2fa885ccc81a2f318bcb7010dff4db4747719e2c95dd6\" \\\n -H \"Authorization: Bearer 4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa\" \\\n -H \"Content-Type: application/json\"\n```\n\n---\n\n### **📖 ESCENARIOS DE USO**\n\n**Escenario 1: Portal de Cliente**\n```javascript\nconst showInvoiceDetails = async (uuid) => {\n const invoice = await getInvoiceByUUID(uuid);\n const notes = await getReferenceNotes(uuid);\n displayInvoiceWithHistory(invoice, notes);\n};\n```\n\n**Escenario 2: Validar Saldo Pendiente**\n```javascript\nconst checkPendingBalance = async (uuid) => {\n const balance = await calculateNetBalance(uuid);\n return balance.netBalance > 0;\n};\n```\n\n**Escenario 3: Reporte de Auditoría**\n```javascript\nconst auditReport = async (startDate, endDate) => {\n const invoices = await getInvoicesBetweenDates(startDate, endDate);\n for (const inv of invoices) {\n const notes = await getReferenceNotes(inv.uuid);\n console.log(`${inv.number}: ${notes.length} ajustes`);\n }\n};\n```\n\n---\n\n### **✅ MEJORES PRÁCTICAS**\n\n1. **Caché de consultas frecuentes** → Reducir carga en servidor\n2. **Mostrar historial completo al cliente** → Transparencia en ajustes\n3. **Calcular saldo neto antes de cobros** → Evitar errores de facturación\n4. **Validar estado de notas** → Solo considerar notas aceptadas por DIAN\n5. **Notificar al cliente sobre ajustes** → Email automático al emitir notas\n6. **Sincronizar con sistema contable** → Mantener contabilidad actualizada\n7. **Generar reportes de auditoría** → Documentar todos los ajustes\n8. **Implementar permisos de acceso** → Solo usuarios autorizados ven ajustes" }, "response": [] }, { "name": "SearchCompanyByNIT", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Content-Type", "type": "text", "value": "application/json" }, { "key": "cache-control", "type": "text", "value": "no-cache" }, { "key": "Connection", "type": "text", "value": "keep-alive" }, { "key": "Accept-Encoding", "type": "text", "value": "gzip, deflate" }, { "key": "Host", "type": "text", "value": "apidian2026-8.oo", "disabled": true }, { "key": "accept", "type": "text", "value": "application/json" }, { "key": "X-CSRF-TOKEN", "type": "text", "value": "" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/SearchCompany/1124024319", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "SearchCompany", "1124024319" ] }, "description": "## **SEARCH COMPANY BY NIT**\n\n**Endpoint:** `GET /api/ubl2.1/SearchCompany/{nit}`\n\n**Propósito:** Busca y recupera información completa de una empresa o persona registrada en el sistema APIDIAN mediante su NIT o número de identificación. Retorna todos los datos del cliente incluyendo nombre, email, teléfono, dirección, tipo de documento, régimen fiscal y más.\n\n---\n\n### **📌 NOTAS CRÍTICAS**\n\n**📌 1. NIT EN LA RUTA (PATH PARAMETER)**\n- El NIT se pasa como parte de la URL, **NO en el body**\n- Formato: `/api/ubl2.1/SearchCompany/{nit}`\n- Ejemplo: `/api/ubl2.1/SearchCompany/1124024319`\n- Soporta NIT con o sin dígito de verificación\n\n**📌 2. DIFERENCIA CON name-by-nit**\n\n| Endpoint | Retorna | Uso Recomendado |\n|----------|---------|------------------|\n| `name-by-nit/{nit}` | Solo nombre/razón social | Autocompletado rápido |\n| `SearchCompany/{nit}` | **Objeto completo del cliente** | Crear facturas, mostrar detalles |\n\n- **name-by-nit** → Ligero, solo el nombre (validación rápida)\n- **SearchCompany** → Completo, todos los datos del cliente (facturación)\n\n**📌 3. BÚSQUEDA EN TABLA DE CLIENTES LOCAL**\n```sql\nSELECT * FROM customers \nWHERE identification_number = '1124024319' \nLIMIT 1;\n```\n- Busca en la tabla `customers` de la base de datos local\n- **NO consulta registros públicos de la DIAN** (solo clientes registrados)\n- Para consultar RUT de la DIAN usar el endpoint `query_rut`\n\n**📌 4. MÉTODO HTTP: GET (NO POST)**\n- Este endpoint usa **GET**, no POST\n- El body debe estar vacío\n- NIT va en la URL como path parameter\n- Respuesta rápida, ideal para cargar datos en formularios\n\n**📌 5. RESPUESTA JSON COMPLETA**\n```json\n{\n \"success\": true,\n \"data\": {\n \"id\": 25,\n \"identification_number\": \"1124024319\",\n \"dv\": \"5\",\n \"type_document_identification_id\": 3,\n \"type_organization_id\": 2,\n \"language_id\": 79,\n \"country_id\": 46,\n \"municipality_id\": 149,\n \"type_regime_id\": 2,\n \"type_liability_id\": \"48;49\",\n \"name\": \"JUAN CARLOS RODRIGUEZ MARTINEZ\",\n \"phone\": \"3157894561\",\n \"address\": \"Calle 50 #25-30\",\n \"email\": \"juancarlos@example.com\",\n \"merchant_registration\": \"12345678\",\n \"created_at\": \"2024-12-01T10:00:00.000000Z\",\n \"updated_at\": \"2025-01-15T14:30:00.000000Z\",\n \"type_document_identification\": {\n \"id\": 3,\n \"name\": \"Cédula de ciudadanía\",\n \"code\": \"13\"\n },\n \"type_organization\": {\n \"id\": 2,\n \"name\": \"Persona Natural\",\n \"code\": \"1\"\n },\n \"municipality\": {\n \"id\": 149,\n \"name\": \"Bogotá D.C.\",\n \"code\": \"11001\",\n \"department_id\": 11\n },\n \"type_regime\": {\n \"id\": 2,\n \"name\": \"Régimen Simplificado\",\n \"code\": \"49\"\n }\n }\n}\n```\n\n**📌 6. RESPUESTA SI EL CLIENTE NO EXISTE**\n```json\n{\n \"success\": false,\n \"message\": \"Cliente no encontrado con NIT 1124024319\"\n}\n```\n- **success: false** → Cliente no registrado en el sistema\n- Retorna código 200 (no 404), con success: false\n\n**📌 7. CASOS DE USO PRINCIPALES**\n- **Cargar datos completos en factura** → Autocompletar todos los campos del cliente\n- **Validar información del cliente** → Verificar datos antes de facturar\n- **Actualizar registros** → Obtener datos actuales para comparar\n- **Mostrar perfil del cliente** → Dashboard, portal de clientes\n- **Pre-llenar formularios de notas** → Crédito/débito con datos completos\n- **Auditorías y reportes** → Generar listados con información detallada\n\n**📌 8. AUTOCOMPLETAR FORMULARIO DE FACTURA**\n```javascript\nconst InvoiceForm = () => {\n const [nit, setNit] = useState('');\n const [customer, setCustomer] = useState(null);\n const [loading, setLoading] = useState(false);\n \n const loadCustomerData = async (nitValue) => {\n if (nitValue.length < 6) return;\n \n setLoading(true);\n try {\n const response = await axios.get(\n `http://midominio.com/api/ubl2.1/SearchCompany/${nitValue}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n if (response.data.success) {\n const customerData = response.data.data;\n setCustomer(customerData);\n \n // Autocompletar formulario\n document.getElementById('customer-name').value = customerData.name;\n document.getElementById('customer-email').value = customerData.email;\n document.getElementById('customer-phone').value = customerData.phone;\n document.getElementById('customer-address').value = customerData.address;\n document.getElementById('municipality-id').value = customerData.municipality_id;\n \n console.log('✅ Datos del cliente cargados:', customerData.name);\n } else {\n setCustomer(null);\n if (confirm('Cliente no encontrado. ¿Desea registrarlo?')) {\n openCustomerRegistrationModal(nitValue);\n }\n }\n } catch (error) {\n console.error('Error buscando cliente:', error);\n alert('Error al buscar cliente');\n } finally {\n setLoading(false);\n }\n };\n \n return (\n
\n
\n \n setNit(e.target.value)}\n onBlur={(e) => loadCustomerData(e.target.value)}\n placeholder=\"Ingrese NIT...\"\n />\n {loading && 🔍 Buscando...}\n
\n \n {customer && (\n
\n

✅ Cliente: {customer.name}

\n

Email: {customer.email}

\n

Teléfono: {customer.phone}

\n

Dirección: {customer.address}

\n

Municipio: {customer.municipality?.name}

\n

Régimen: {customer.type_regime?.name}

\n
\n )}\n \n {/* Resto del formulario de factura */}\n
\n );\n};\n```\n\n**📌 9. VALIDAR DATOS ANTES DE FACTURAR**\n```javascript\nconst validateCustomerForInvoicing = async (nit) => {\n const response = await axios.get(\n `http://midominio.com/api/ubl2.1/SearchCompany/${nit}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n if (!response.data.success) {\n throw new Error(`Cliente con NIT ${nit} no está registrado`);\n }\n \n const customer = response.data.data;\n \n // Validaciones adicionales\n if (!customer.email) {\n throw new Error('Cliente no tiene email registrado. Actualice sus datos.');\n }\n \n if (!customer.municipality_id) {\n throw new Error('Cliente no tiene municipio registrado.');\n }\n \n console.log('✅ Cliente validado:', customer.name);\n return customer;\n};\n\n// Uso\ntry {\n const customer = await validateCustomerForInvoicing('1124024319');\n await createInvoice(customer);\n} catch (error) {\n alert(error.message);\n}\n```\n\n**📌 10. COMPARAR DATOS PARA ACTUALIZACIÓN**\n```javascript\nconst checkIfUpdateNeeded = async (nit, newData) => {\n const response = await axios.get(\n `http://midominio.com/api/ubl2.1/SearchCompany/${nit}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n if (!response.data.success) {\n console.log('Cliente no existe, proceder a registrar');\n return { needsUpdate: false, isNew: true };\n }\n \n const existingData = response.data.data;\n \n // Comparar datos\n const changes = {};\n if (existingData.name !== newData.name) changes.name = newData.name;\n if (existingData.email !== newData.email) changes.email = newData.email;\n if (existingData.phone !== newData.phone) changes.phone = newData.phone;\n if (existingData.address !== newData.address) changes.address = newData.address;\n \n const hasChanges = Object.keys(changes).length > 0;\n \n if (hasChanges) {\n console.log('⚠️ Cambios detectados:', changes);\n return { needsUpdate: true, changes, existingData };\n }\n \n console.log('✅ Datos actualizados, no requiere cambios');\n return { needsUpdate: false, isNew: false };\n};\n```\n\n**📌 11. MOSTRAR PERFIL COMPLETO DEL CLIENTE**\n```jsx\nconst CustomerProfile = ({ nit }) => {\n const [customer, setCustomer] = useState(null);\n const [loading, setLoading] = useState(true);\n \n useEffect(() => {\n loadCustomerProfile();\n }, [nit]);\n \n const loadCustomerProfile = async () => {\n try {\n const response = await axios.get(\n `http://midominio.com/api/ubl2.1/SearchCompany/${nit}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n if (response.data.success) {\n setCustomer(response.data.data);\n }\n } catch (error) {\n console.error('Error:', error);\n } finally {\n setLoading(false);\n }\n };\n \n if (loading) return
Cargando...
;\n if (!customer) return
Cliente no encontrado
;\n \n return (\n
\n

{customer.name}

\n \n
\n

📋 Identificación

\n

Tipo: {customer.type_document_identification?.name}

\n

Número: {customer.identification_number}

\n

DV: {customer.dv || 'N/A'}

\n
\n \n
\n

📞 Contacto

\n

Email: {customer.email}

\n

Teléfono: {customer.phone}

\n

Dirección: {customer.address}

\n
\n \n
\n

📍 Ubicación

\n

Municipio: {customer.municipality?.name}

\n

Código DANE: {customer.municipality?.code}

\n
\n \n
\n

💼 Información Fiscal

\n

Tipo de organización: {customer.type_organization?.name}

\n

Régimen: {customer.type_regime?.name}

\n

Responsabilidades: {customer.type_liability_id}

\n

Matrícula mercantil: {customer.merchant_registration || 'N/A'}

\n
\n \n
\n

📅 Registro

\n

Creado: {new Date(customer.created_at).toLocaleDateString()}

\n

Actualizado: {new Date(customer.updated_at).toLocaleDateString()}

\n
\n
\n );\n};\n```\n\n**📌 12. INTEGRACIÓN CON CREACIÓN DE FACTURA**\n```javascript\nconst createInvoiceWithCustomer = async (nit, invoiceData) => {\n // 1. Obtener datos completos del cliente\n const response = await axios.get(\n `http://midominio.com/api/ubl2.1/SearchCompany/${nit}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n if (!response.data.success) {\n throw new Error('Cliente no encontrado');\n }\n \n const customer = response.data.data;\n \n // 2. Construir objeto de factura con datos del cliente\n const invoicePayload = {\n type_document_id: 1, // Factura de venta\n customer: {\n identification_number: customer.identification_number,\n dv: customer.dv,\n name: customer.name,\n phone: customer.phone,\n address: customer.address,\n email: customer.email,\n merchant_registration: customer.merchant_registration,\n type_document_identification_id: customer.type_document_identification_id,\n type_organization_id: customer.type_organization_id,\n type_regime_id: customer.type_regime_id,\n type_liability_id: customer.type_liability_id,\n municipality_id: customer.municipality_id,\n country_id: customer.country_id\n },\n ...invoiceData // Items, totales, etc.\n };\n \n // 3. Crear factura\n const invoiceResponse = await axios.post(\n 'http://midominio.com/api/ubl2.1/invoice',\n invoicePayload,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n console.log('✅ Factura creada:', invoiceResponse.data);\n return invoiceResponse.data;\n};\n```\n\n**📌 13. CACHÉ DE DATOS DE CLIENTES**\n```javascript\nconst customerCache = new Map();\n\nconst getCustomerWithCache = async (nit) => {\n // Verificar caché\n if (customerCache.has(nit)) {\n const cached = customerCache.get(nit);\n const now = Date.now();\n \n // Validar expiración (10 minutos)\n if (now - cached.timestamp < 600000) {\n console.log('✅ Datos desde caché');\n return cached.data;\n } else {\n customerCache.delete(nit);\n }\n }\n \n // Consultar API\n const response = await axios.get(\n `http://midominio.com/api/ubl2.1/SearchCompany/${nit}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n if (response.data.success) {\n // Guardar en caché\n customerCache.set(nit, {\n data: response.data.data,\n timestamp: Date.now()\n });\n \n return response.data.data;\n }\n \n return null;\n};\n```\n\n**📌 14. EXPORTAR LISTA DE CLIENTES**\n```javascript\nconst exportCustomersToCSV = async (nitList) => {\n const customers = [];\n \n for (const nit of nitList) {\n try {\n const response = await axios.get(\n `http://midominio.com/api/ubl2.1/SearchCompany/${nit}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n if (response.data.success) {\n customers.push(response.data.data);\n }\n } catch (error) {\n console.error(`Error con NIT ${nit}:`, error.message);\n }\n }\n \n // Convertir a CSV\n const csvContent = [\n 'NIT,Nombre,Email,Teléfono,Dirección,Municipio,Régimen',\n ...customers.map(c => \n `${c.identification_number},${c.name},${c.email},${c.phone},${c.address},${c.municipality?.name},${c.type_regime?.name}`\n )\n ].join('\\n');\n \n // Guardar archivo\n const fs = require('fs');\n fs.writeFileSync('clientes_export.csv', csvContent, 'utf8');\n console.log('✅ Exportación completada');\n};\n```\n\n**📌 15. SINCRONIZAR CON SISTEMA EXTERNO**\n```javascript\nconst syncCustomerToExternalSystem = async (nit) => {\n // 1. Obtener datos de APIDIAN\n const response = await axios.get(\n `http://midominio.com/api/ubl2.1/SearchCompany/${nit}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n if (!response.data.success) {\n throw new Error('Cliente no encontrado');\n }\n \n const customer = response.data.data;\n \n // 2. Sincronizar con sistema contable (SAP, Siigo, etc.)\n await externalSystemAPI.post('/customers/sync', {\n nit: customer.identification_number,\n name: customer.name,\n email: customer.email,\n phone: customer.phone,\n address: customer.address,\n city: customer.municipality?.name,\n taxRegime: customer.type_regime?.code,\n source: 'APIDIAN'\n });\n \n console.log(`✅ Cliente ${customer.name} sincronizado`);\n};\n```\n\n---\n\n### **📊 TABLA DE PARÁMETROS**\n\n| Parámetro | Ubicación | Tipo | Requerido | Descripción |\n|-----------|-----------|------|-----------|-------------|\n| `nit` | Path (URL) | String | ✅ Sí | Número de identificación tributaria |\n| `Authorization` | Header | String | ✅ Sí | Token Bearer del API |\n\n---\n\n### **📊 TABLA DE RESPUESTAS**\n\n| Código | Descripción | Body |\n|--------|-------------|------|\n| **200** | Cliente encontrado | `{ success: true, data: {...} }` |\n| **200** | Cliente no encontrado | `{ success: false, message: \"Cliente no encontrado...\" }` |\n| **401** | Token inválido | `{ message: \"Unauthenticated.\" }` |\n| **500** | Error interno | `{ message: \"Server error\" }` |\n\n---\n\n### **🔧 EJEMPLO DE USO: JAVASCRIPT/AXIOS**\n\n```javascript\nconst axios = require('axios');\n\nconst searchCompanyByNIT = async (nit) => {\n try {\n const response = await axios.get(\n `http://midominio.com/api/ubl2.1/SearchCompany/${nit}`,\n {\n headers: {\n 'Authorization': 'Bearer 4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa',\n 'Content-Type': 'application/json'\n }\n }\n );\n \n if (response.data.success) {\n const customer = response.data.data;\n console.log('✅ Cliente encontrado:');\n console.log('Nombre:', customer.name);\n console.log('Email:', customer.email);\n console.log('Teléfono:', customer.phone);\n console.log('Dirección:', customer.address);\n console.log('Municipio:', customer.municipality?.name);\n console.log('Régimen:', customer.type_regime?.name);\n return customer;\n } else {\n console.log('❌ Cliente no encontrado');\n return null;\n }\n \n } catch (error) {\n console.error('❌ Error:', error.response?.data || error.message);\n }\n};\n\n// Uso\nconst customer = await searchCompanyByNIT('1124024319');\nif (customer) {\n console.log('Proceder a facturar...');\n}\n```\n\n---\n\n### **🔧 EJEMPLO: CURL**\n\n```bash\ncurl -X GET \"http://midominio.com/api/ubl2.1/SearchCompany/1124024319\" \\\n -H \"Authorization: Bearer 4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa\" \\\n -H \"Content-Type: application/json\"\n```\n\n---\n\n### **📖 ESCENARIOS DE USO**\n\n**Escenario 1: Autocompletado de Factura**\n```javascript\nconst handleNITInput = async (nit) => {\n const customer = await searchCompanyByNIT(nit);\n if (customer) autoFillInvoiceForm(customer);\n};\n```\n\n**Escenario 2: Validación Pre-Factura**\n```javascript\nconst validateBeforeInvoice = async (nit) => {\n const customer = await searchCompanyByNIT(nit);\n if (!customer) throw new Error('Cliente no registrado');\n return customer;\n};\n```\n\n**Escenario 3: Sincronización de Datos**\n```javascript\nconst syncCustomer = async (nit) => {\n const customer = await searchCompanyByNIT(nit);\n await externalSystem.updateCustomer(customer);\n};\n```\n\n---\n\n### **✅ MEJORES PRÁCTICAS**\n\n1. **Caché de datos frecuentes** → Reducir consultas repetitivas\n2. **Validar datos antes de facturar** → Verificar email, municipio, etc.\n3. **Normalizar NITs antes de buscar** → Remover espacios, guiones, puntos\n4. **Usar para cargar datos completos** → No solo el nombre\n5. **Implementar retry con exponential backoff** → En caso de errores temporales\n6. **Comparar con datos existentes** → Detectar cambios antes de actualizar\n7. **Mostrar datos legibles al usuario** → No solo IDs, mostrar nombres\n8. **Sincronizar con sistemas externos** → Mantener consistencia en todos los sistemas" }, "response": [] }, { "name": "RUT Query", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Content-Type", "type": "text", "value": "application/json" }, { "key": "cache-control", "type": "text", "value": "no-cache" }, { "key": "Connection", "type": "text", "value": "keep-alive" }, { "key": "Accept-Encoding", "type": "text", "value": "gzip, deflate" }, { "key": "Host", "type": "text", "value": "apidian2026-8.oo", "disabled": true }, { "key": "accept", "type": "text", "value": "application/json" }, { "key": "X-CSRF-TOKEN", "type": "text", "value": "" } ], "body": { "mode": "raw", "raw": "{\r\n \"identification_number\": 89008003\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/query_rut", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "query_rut" ] }, "description": "## **RUT QUERY - CONSULTAR RUT EN LA DIAN**\n\n**Endpoint:** `GET /api/ubl2.1/query_rut`\n\n**Propósito:** Consulta el Registro Único Tributario (RUT) de una empresa directamente en los servicios públicos de la DIAN. Retorna información oficial incluyendo razón social, régimen fiscal, responsabilidades tributarias y estado del contribuyente. Este endpoint consume APIs externas de la DIAN.\n\n---\n\n### **📌 NOTAS CRÍTICAS**\n\n**📌 1. BODY CON NÚMERO DE IDENTIFICACIÓN**\n```json\n{\n \"identification_number\": 89008003\n}\n```\n- El NIT se envía en el **body** (no en la URL)\n- Campo requerido: `identification_number`\n- Puede ser NIT (sin dígito de verificación) o cédula\n- **Método GET pero con body** (configuración especial)\n\n**📌 2. CONSULTA EXTERNA A LA DIAN**\n- Este endpoint **NO consulta la base de datos local** de APIDIAN\n- Conecta directamente con servicios públicos de la DIAN\n- Retorna información oficial y actualizada del RUT\n- Requiere conexión a Internet y disponibilidad de servicios DIAN\n\n**📌 3. DIFERENCIA CON SearchCompany**\n\n| Endpoint | Fuente | Datos |\n|----------|--------|-------|\n| `query_rut` | **DIAN (RUT oficial)** | Datos públicos del contribuyente |\n| `SearchCompany/{nit}` | **Base de datos local** | Clientes registrados en APIDIAN |\n\n- **query_rut** → Consulta registros oficiales de la DIAN (cualquier empresa)\n- **SearchCompany** → Solo clientes ya registrados en el sistema\n\n**📌 4. MÉTODO: GET CON BODY (CONFIGURACIÓN ESPECIAL)**\n```javascript\n// Axios con método GET y body\nconst response = await axios.get(\n 'http://midominio.com/api/ubl2.1/query_rut',\n {\n headers: { 'Authorization': `Bearer ${apiToken}` },\n data: { identification_number: 89008003 } // Body en GET\n }\n);\n```\n- **Atención:** GET con body no es estándar REST, pero funciona en APIDIAN\n- Algunos clientes HTTP requieren configuración especial\n\n**📌 5. RESPUESTA CON DATOS DEL RUT**\n```json\n{\n \"success\": true,\n \"data\": {\n \"identification_number\": \"89008003\",\n \"dv\": \"7\",\n \"business_name\": \"TORRE INGENIERIA Y SOFTWARE LTDA\",\n \"trade_name\": \"TORRESOFTWARE\",\n \"regime\": \"Régimen Común\",\n \"responsibilities\": [\n \"O-13 Gran Contribuyente\",\n \"O-15 Autorretenedor\",\n \"R-99-PN Responsable del IVA\"\n ],\n \"activity\": \"6201 - Actividades de programación informática\",\n \"address\": \"CARRERA 23 # 13-32\",\n \"municipality\": \"Armenia\",\n \"department\": \"Quindío\",\n \"email\": \"gerencia@torresoftware.com\",\n \"phone\": \"7441234\",\n \"status\": \"Activo\"\n }\n}\n```\n\n**📌 6. RESPUESTA SI EL NIT NO EXISTE EN LA DIAN**\n```json\n{\n \"success\": false,\n \"message\": \"NIT no encontrado en registros de la DIAN\"\n}\n```\n- Si el NIT no está registrado en la DIAN, retorna success: false\n- Puede significar que el NIT es inválido o no existe\n\n**📌 7. CASOS DE USO PRINCIPALES**\n- **Validar NIT antes de registrar cliente** → Verificar que el NIT existe\n- **Autocompletar datos desde la DIAN** → Rellenar formularios con datos oficiales\n- **Verificar estado del contribuyente** → Confirmar que está activo\n- **Auditorías y compliance** → Validar régimen y responsabilidades\n- **Integración con RUT oficial** → Sincronizar datos con registros DIAN\n- **Prevenir fraude** → Verificar autenticidad de clientes\n\n**📌 8. REGISTRAR CLIENTE CON DATOS DE LA DIAN**\n```javascript\nconst registerCustomerFromRUT = async (nit) => {\n // 1. Consultar RUT en la DIAN\n const rutResponse = await axios.get(\n 'http://midominio.com/api/ubl2.1/query_rut',\n {\n headers: { 'Authorization': `Bearer ${apiToken}` },\n data: { identification_number: nit }\n }\n );\n \n if (!rutResponse.data.success) {\n throw new Error('NIT no encontrado en la DIAN');\n }\n \n const rutData = rutResponse.data.data;\n \n // 2. Registrar cliente en APIDIAN con datos del RUT\n const registerResponse = await axios.put(\n 'http://midominio.com/api/ubl2.1/register-update-customer',\n {\n identification_number: rutData.identification_number,\n dv: rutData.dv,\n name: rutData.business_name,\n address: rutData.address,\n email: rutData.email,\n phone: rutData.phone,\n // Mapear datos del RUT a campos de APIDIAN\n type_document_identification_id: 6, // NIT\n type_organization_id: 2, // Persona jurídica\n type_regime_id: rutData.regime === 'Régimen Común' ? 1 : 2\n },\n {\n headers: { 'Authorization': `Bearer ${apiToken}` }\n }\n );\n \n console.log('✅ Cliente registrado con datos del RUT');\n return registerResponse.data;\n};\n```\n\n**📌 9. VALIDAR NIT ANTES DE FACTURAR**\n```javascript\nconst validateNITWithDIAN = async (nit) => {\n try {\n const response = await axios.get(\n 'http://midominio.com/api/ubl2.1/query_rut',\n {\n headers: { 'Authorization': `Bearer ${apiToken}` },\n data: { identification_number: nit }\n }\n );\n \n if (!response.data.success) {\n throw new Error('NIT no registrado en la DIAN');\n }\n \n const rutData = response.data.data;\n \n // Validaciones adicionales\n if (rutData.status !== 'Activo') {\n throw new Error(`Contribuyente inactivo: ${rutData.status}`);\n }\n \n console.log('✅ NIT válido:', rutData.business_name);\n return rutData;\n \n } catch (error) {\n console.error('❌ Validación fallida:', error.message);\n throw error;\n }\n};\n```\n\n**📌 10. AUTOCOMPLETAR FORMULARIO CON DATOS DEL RUT**\n```jsx\nconst CustomerRegistrationForm = () => {\n const [nit, setNit] = useState('');\n const [rutData, setRutData] = useState(null);\n const [loading, setLoading] = useState(false);\n \n const queryRUT = async () => {\n if (nit.length < 6) {\n alert('Ingrese un NIT válido');\n return;\n }\n \n setLoading(true);\n try {\n const response = await axios.get(\n 'http://midominio.com/api/ubl2.1/query_rut',\n {\n headers: { 'Authorization': `Bearer ${apiToken}` },\n data: { identification_number: nit }\n }\n );\n \n if (response.data.success) {\n const rut = response.data.data;\n setRutData(rut);\n \n // Autocompletar formulario\n document.getElementById('dv').value = rut.dv;\n document.getElementById('business-name').value = rut.business_name;\n document.getElementById('address').value = rut.address;\n document.getElementById('email').value = rut.email;\n document.getElementById('phone').value = rut.phone;\n document.getElementById('municipality').value = rut.municipality;\n \n alert(`✅ Datos cargados desde RUT: ${rut.business_name}`);\n } else {\n alert('❌ NIT no encontrado en la DIAN');\n }\n } catch (error) {\n alert('Error consultando RUT');\n } finally {\n setLoading(false);\n }\n };\n \n return (\n
\n

Registro de Cliente

\n \n
\n \n setNit(e.target.value)}\n placeholder=\"Ingrese NIT...\"\n />\n \n
\n \n {rutData && (\n
\n

✅ Información del RUT

\n

Razón Social: {rutData.business_name}

\n

Régimen: {rutData.regime}

\n

Estado: {rutData.status}

\n

Actividad: {rutData.activity}

\n
\n )}\n \n {/* Resto del formulario */}\n
\n );\n};\n```\n\n**📌 11. COMPARAR DATOS LOCALES VS RUT OFICIAL**\n```javascript\nconst compareLocalVsRUT = async (nit) => {\n // 1. Obtener datos locales\n const localResponse = await axios.get(\n `http://midominio.com/api/ubl2.1/SearchCompany/${nit}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n // 2. Consultar RUT oficial\n const rutResponse = await axios.get(\n 'http://midominio.com/api/ubl2.1/query_rut',\n {\n headers: { 'Authorization': `Bearer ${apiToken}` },\n data: { identification_number: nit }\n }\n );\n \n if (localResponse.data.success && rutResponse.data.success) {\n const local = localResponse.data.data;\n const rut = rutResponse.data.data;\n \n // Comparar discrepancias\n const differences = [];\n \n if (local.name !== rut.business_name) {\n differences.push(`Nombre: \"${local.name}\" vs \"${rut.business_name}\"`);\n }\n if (local.address !== rut.address) {\n differences.push(`Dirección: \"${local.address}\" vs \"${rut.address}\"`);\n }\n if (local.email !== rut.email) {\n differences.push(`Email: \"${local.email}\" vs \"${rut.email}\"`);\n }\n \n if (differences.length > 0) {\n console.warn('⚠️ Discrepancias encontradas:');\n differences.forEach(diff => console.log(` - ${diff}`));\n return { hasDiscrepancies: true, differences };\n } else {\n console.log('✅ Datos coinciden con el RUT oficial');\n return { hasDiscrepancies: false };\n }\n }\n};\n```\n\n**📌 12. ACTUALIZAR CLIENTE CON DATOS OFICIALES**\n```javascript\nconst syncWithOfficialRUT = async (nit) => {\n // 1. Consultar RUT oficial\n const rutResponse = await axios.get(\n 'http://midominio.com/api/ubl2.1/query_rut',\n {\n headers: { 'Authorization': `Bearer ${apiToken}` },\n data: { identification_number: nit }\n }\n );\n \n if (!rutResponse.data.success) {\n throw new Error('No se pudo consultar el RUT');\n }\n \n const rut = rutResponse.data.data;\n \n // 2. Actualizar en base local\n await axios.put(\n 'http://midominio.com/api/ubl2.1/register-update-customer',\n {\n identification_number: rut.identification_number,\n dv: rut.dv,\n name: rut.business_name,\n address: rut.address,\n email: rut.email,\n phone: rut.phone\n },\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n console.log(`✅ Cliente ${rut.business_name} actualizado con datos del RUT`);\n};\n```\n\n**📌 13. MANEJO DE ERRORES Y TIMEOUT**\n```javascript\nconst queryRUTWithRetry = async (nit, maxRetries = 3) => {\n for (let attempt = 1; attempt <= maxRetries; attempt++) {\n try {\n const response = await axios.get(\n 'http://midominio.com/api/ubl2.1/query_rut',\n {\n headers: { 'Authorization': `Bearer ${apiToken}` },\n data: { identification_number: nit },\n timeout: 15000 // 15 segundos\n }\n );\n \n return response.data;\n \n } catch (error) {\n if (attempt === maxRetries) {\n if (error.code === 'ECONNABORTED') {\n throw new Error('Timeout: Servicios de la DIAN no responden');\n } else if (error.response?.status === 503) {\n throw new Error('Servicios de la DIAN no disponibles');\n } else {\n throw error;\n }\n }\n \n console.log(`⚠️ Intento ${attempt} fallido, reintentando...`);\n await new Promise(resolve => setTimeout(resolve, 2000 * attempt));\n }\n }\n};\n```\n\n**📌 14. CACHÉ DE CONSULTAS RUT**\n```javascript\nconst rutCache = new Map();\n\nconst queryRUTWithCache = async (nit) => {\n // Verificar caché (válido por 24 horas)\n if (rutCache.has(nit)) {\n const cached = rutCache.get(nit);\n const age = Date.now() - cached.timestamp;\n \n if (age < 86400000) { // 24 horas\n console.log('✅ RUT desde caché');\n return cached.data;\n } else {\n rutCache.delete(nit);\n }\n }\n \n // Consultar DIAN\n const response = await axios.get(\n 'http://midominio.com/api/ubl2.1/query_rut',\n {\n headers: { 'Authorization': `Bearer ${apiToken}` },\n data: { identification_number: nit }\n }\n );\n \n if (response.data.success) {\n // Guardar en caché\n rutCache.set(nit, {\n data: response.data.data,\n timestamp: Date.now()\n });\n }\n \n return response.data.data;\n};\n```\n\n**📌 15. INTEGRACIÓN CON FLUJO DE REGISTRO**\n```javascript\nconst smartCustomerRegistration = async (nit) => {\n // 1. Verificar si ya existe localmente\n const localResponse = await axios.get(\n `http://midominio.com/api/ubl2.1/SearchCompany/${nit}`,\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n ).catch(() => ({ data: { success: false } }));\n \n if (localResponse.data.success) {\n console.log('✅ Cliente ya registrado localmente');\n return localResponse.data.data;\n }\n \n // 2. Cliente no existe, consultar RUT de la DIAN\n console.log('🔍 Consultando RUT en la DIAN...');\n const rutResponse = await axios.get(\n 'http://midominio.com/api/ubl2.1/query_rut',\n {\n headers: { 'Authorization': `Bearer ${apiToken}` },\n data: { identification_number: nit }\n }\n );\n \n if (!rutResponse.data.success) {\n throw new Error('NIT no encontrado en registros de la DIAN');\n }\n \n const rut = rutResponse.data.data;\n \n // 3. Registrar con datos oficiales del RUT\n console.log(`📝 Registrando: ${rut.business_name}`);\n const registerResponse = await axios.put(\n 'http://midominio.com/api/ubl2.1/register-update-customer',\n {\n identification_number: rut.identification_number,\n dv: rut.dv,\n name: rut.business_name,\n address: rut.address,\n email: rut.email,\n phone: rut.phone,\n type_document_identification_id: 6, // NIT\n type_organization_id: 2\n },\n { headers: { 'Authorization': `Bearer ${apiToken}` } }\n );\n \n console.log('✅ Cliente registrado exitosamente');\n return registerResponse.data;\n};\n```\n\n---\n\n### **📊 TABLA DE PARÁMETROS**\n\n| Campo | Ubicación | Tipo | Requerido | Descripción |\n|-------|-----------|------|-----------|-------------|\n| `identification_number` | Body | Number/String | ✅ Sí | NIT o cédula del contribuyente |\n| `Authorization` | Header | String | ✅ Sí | Token Bearer del API |\n\n---\n\n### **📊 TABLA DE RESPUESTAS**\n\n| Código | Descripción | Body |\n|--------|-------------|------|\n| **200** | RUT encontrado | `{ success: true, data: {...} }` |\n| **200** | NIT no encontrado | `{ success: false, message: \"NIT no encontrado...\" }` |\n| **503** | DIAN no disponible | `{ message: \"Service unavailable\" }` |\n| **401** | Token inválido | `{ message: \"Unauthenticated.\" }` |\n| **500** | Error interno | `{ message: \"Server error\" }` |\n\n---\n\n### **🔧 EJEMPLO DE USO: JAVASCRIPT/AXIOS**\n\n```javascript\nconst axios = require('axios');\n\nconst queryRUT = async (nit) => {\n try {\n const response = await axios.get(\n 'http://midominio.com/api/ubl2.1/query_rut',\n {\n headers: {\n 'Authorization': 'Bearer 4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa',\n 'Content-Type': 'application/json'\n },\n data: {\n identification_number: 89008003\n }\n }\n );\n \n if (response.data.success) {\n const rut = response.data.data;\n console.log('✅ RUT encontrado:');\n console.log('Razón Social:', rut.business_name);\n console.log('Régimen:', rut.regime);\n console.log('Estado:', rut.status);\n console.log('Dirección:', rut.address);\n return rut;\n } else {\n console.log('❌ NIT no encontrado en la DIAN');\n return null;\n }\n \n } catch (error) {\n console.error('❌ Error:', error.message);\n }\n};\n\n// Uso\nconst rutData = await queryRUT(89008003);\n```\n\n---\n\n### **🔧 EJEMPLO: CURL**\n\n```bash\ncurl -X GET \"http://midominio.com/api/ubl2.1/query_rut\" \\\n -H \"Authorization: Bearer 4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa\" \\\n -H \"Content-Type: application/json\" \\\n -d '{ \"identification_number\": 89008003 }'\n```\n\n---\n\n### **📖 ESCENARIOS DE USO**\n\n**Escenario 1: Registro con Datos Oficiales**\n```javascript\nconst registerFromRUT = async (nit) => {\n const rut = await queryRUT(nit);\n if (rut) await registerCustomer(rut);\n};\n```\n\n**Escenario 2: Validación de NIT**\n```javascript\nconst validateNIT = async (nit) => {\n const rut = await queryRUT(nit);\n return rut && rut.status === 'Activo';\n};\n```\n\n**Escenario 3: Sincronización Periódica**\n```javascript\nconst syncAllCustomers = async () => {\n const customers = await getAllCustomers();\n for (const c of customers) {\n await syncWithOfficialRUT(c.identification_number);\n }\n};\n```\n\n---\n\n### **✅ MEJORES PRÁCTICAS**\n\n1. **Implementar caché de 24 horas** → Reducir consultas a la DIAN\n2. **Manejar timeouts apropiadamente** → Servicios DIAN pueden ser lentos\n3. **Implementar retry con backoff** → Reintentar en caso de fallas temporales\n4. **Validar estado del contribuyente** → Solo registrar si está activo\n5. **Usar para registro inicial** → No para consultas frecuentes\n6. **Combinar con SearchCompany** → Primero local, luego DIAN\n7. **Notificar al usuario sobre demoras** → Consulta externa puede tardar\n8. **Registrar consultas en logs** → Auditoría de consultas RUT" }, "response": [] }, { "name": "JoinPDFs", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "type": "text", "value": "application/json" }, { "key": "cache-control", "type": "text", "value": "no-cache" }, { "key": "Connection", "type": "text", "value": "keep-alive" }, { "key": "Accept-Encoding", "type": "text", "value": "gzip, deflate" }, { "key": "Host", "type": "text", "value": "localhost", "disabled": true }, { "key": "accept", "type": "text", "value": "application/json" }, { "key": "X-CSRF-TOKEN", "type": "text", "value": "" } ], "body": { "mode": "raw", "raw": "{\r\n \"name_joined_pdfs\": \"PDFs-Unidos.pdf\",\r\n \"pdfs\": [\r\n {\r\n \"type_document_id\": 1,\r\n \"prefix\": \"SETP\",\r\n \"number\": \"990000249\"\r\n },{\r\n \"type_document_id\": 1,\r\n \"prefix\": \"SETP\",\r\n \"number\": \"990000667\"\r\n },{\r\n \"type_document_id\": 1,\r\n \"prefix\": \"SETP\",\r\n \"number\": \"990000699\"\r\n },{\r\n \"type_document_id\": 4,\r\n \"prefix\": \"NC\",\r\n \"number\": \"77\"\r\n }\r\n ]\r\n}" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/join-pdfs", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "join-pdfs" ] }, "description": "FECHA DE VENCIMIENTO DEL CERTIFICADO DIGITAL\n\n- Si se instalo un dominio se debe utilizar de la siguiente manera:\n\nhttp://midominio.com/api/ubl2.1/certificate-end-date\n\n- Requiere un token de autorizacion el cual fue devuelto al realizar el Paso 1 - Config Company, si este token se extravio, se puede consultar en la tabla de la base de datos de la API en la tabla users, en el campo API_TOKEN.\n\n- Este endpoint no tiene parametros en la URL, tampoco tiene campos JSON en el body\n\n- Este endpoint retorna la fecha de vencimiento del certificado digital de la empresa que utiliza el token utilizado en la autorizacion." }, "response": [] }, { "name": "Download File", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "4acf1833b3a763a2d7a6253c82cbcfb1e51c6eecd2a4e05d5fdfbc84871369fa", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "type": "text", "value": "application/json" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "http://apidian2026-8.oo/api/ubl2.1/download/24479929/FES-SETP990000249.xml/BASE64", "protocol": "http", "host": [ "apidian2026-8", "oo" ], "path": [ "api", "ubl2.1", "download", "24479929", "FES-SETP990000249.xml", "BASE64" ] }, "description": "# DESCARGAR ARCHIVO - Download File\n\n## 📋 DESCRIPCIÓN GENERAL\n\nEndpoint para descargar archivos de documentos electrónicos en diferentes formatos (XML, PDF, BASE64). Permite recuperar archivos generados por la API DIAN, especificando el NIT de la empresa, nombre del archivo y formato de salida deseado.\n\n**Endpoint:** `GET /api/ubl2.1/download/{nit}/{filename}/{format}`\n\n**Método HTTP:** GET\n\n**Autenticación:** Bearer Token\n\n---\n\n## 📌 NOTAS CRÍTICAS\n\n### 📌 1. Parámetros en la URL\n\nLa URL requiere tres parámetros obligatorios:\n\n```\nGET /api/ubl2.1/download/{nit}/{filename}/{format}\n\nEjemplo:\nGET /api/ubl2.1/download/24479929/FES-SETP990000249.xml/BASE64\n```\n\n**Parámetros:**\n- `nit`: Número de identificación tributaria de la empresa (sin dígito de verificación, sin puntos)\n- `filename`: Nombre completo del archivo (incluye prefijo del tipo de documento)\n- `format`: Formato de salida deseado (XML, PDF, BASE64)\n\n### 📌 2. Formatos de Descarga Disponibles\n\n**Formato XML (original):**\n```javascript\nconst response = await axios.get(\n 'http://api.dominio.com/api/ubl2.1/download/89008003/FES-SETP990000249.xml/XML',\n {\n headers: {\n 'Authorization': `Bearer ${token}`,\n 'Accept': 'application/xml'\n },\n responseType: 'text' // Para XML como texto\n }\n);\n\nconsole.log(response.data); // XML en formato texto\n```\n\n**Formato PDF (representación gráfica):**\n```javascript\nconst response = await axios.get(\n 'http://api.dominio.com/api/ubl2.1/download/89008003/FES-SETP990000249.xml/PDF',\n {\n headers: {\n 'Authorization': `Bearer ${token}`,\n 'Accept': 'application/pdf'\n },\n responseType: 'blob' // Para archivos binarios\n }\n);\n\n// Crear enlace de descarga\nconst url = window.URL.createObjectURL(new Blob([response.data]));\nconst link = document.createElement('a');\nlink.href = url;\nlink.setAttribute('download', 'FES-SETP990000249.pdf');\ndocument.body.appendChild(link);\nlink.click();\nlink.remove();\n```\n\n**Formato BASE64 (para envío por email/almacenamiento):**\n```javascript\nconst response = await axios.get(\n 'http://api.dominio.com/api/ubl2.1/download/89008003/FES-SETP990000249.xml/BASE64',\n {\n headers: {\n 'Authorization': `Bearer ${token}`,\n 'Accept': 'application/json'\n }\n }\n);\n\nconst base64Content = response.data.content; // String Base64\n\n// Decodificar Base64 a Blob\nconst byteCharacters = atob(base64Content);\nconst byteNumbers = new Array(byteCharacters.length);\nfor (let i = 0; i < byteCharacters.length; i++) {\n byteNumbers[i] = byteCharacters.charCodeAt(i);\n}\nconst byteArray = new Uint8Array(byteNumbers);\nconst blob = new Blob([byteArray], { type: 'application/pdf' });\n```\n\n### 📌 3. Nomenclatura de Archivos\n\nLos archivos siguen una nomenclatura específica según el tipo de documento:\n\n```javascript\n// Facturas de Venta\nconst invoiceFilename = `FES-${prefix}${number}.xml`;\n// Ejemplo: FES-SETP990000249.xml\n\n// Notas Crédito\nconst creditNoteFilename = `NC-${prefix}${number}.xml`;\n// Ejemplo: NC-NC77.xml\n\n// Notas Débito\nconst debitNoteFilename = `ND-${prefix}${number}.xml`;\n// Ejemplo: ND-ND55.xml\n\n// Documentos Soporte\nconst supportDocFilename = `DS-${prefix}${number}.xml`;\n// Ejemplo: DS-DS12345.xml\n\n// Función para construir el filename\nfunction buildFilename(documentType, prefix, number) {\n const prefixes = {\n 1: 'FES', // Factura Electrónica de Venta\n 4: 'NC', // Nota Crédito\n 5: 'ND', // Nota Débito\n 9: 'DS', // Documento Soporte\n 10: 'DS-NC', // Documento Soporte Nota Crédito\n 13: 'AR' // Documento Equivalente\n };\n \n const docPrefix = prefixes[documentType] || 'DOC';\n return `${docPrefix}-${prefix}${number}.xml`;\n}\n```\n\n### 📌 4. Manejo de Respuestas según Formato\n\n**Response XML:**\n```javascript\nconst downloadXML = async (nit, filename) => {\n try {\n const response = await axios.get(\n `${API_URL}/api/ubl2.1/download/${nit}/${filename}/XML`,\n {\n headers: { 'Authorization': `Bearer ${token}` },\n responseType: 'text'\n }\n );\n \n // Validar estructura XML\n const parser = new DOMParser();\n const xmlDoc = parser.parseFromString(response.data, 'text/xml');\n \n if (xmlDoc.getElementsByTagName('parsererror').length > 0) {\n throw new Error('XML inválido');\n }\n \n return response.data;\n } catch (error) {\n console.error('Error descargando XML:', error);\n throw error;\n }\n};\n```\n\n**Response PDF (Blob):**\n```javascript\nconst downloadPDF = async (nit, filename) => {\n try {\n const response = await axios.get(\n `${API_URL}/api/ubl2.1/download/${nit}/${filename}/PDF`,\n {\n headers: { 'Authorization': `Bearer ${token}` },\n responseType: 'blob'\n }\n );\n \n // Verificar tipo MIME\n if (response.data.type !== 'application/pdf') {\n throw new Error('Respuesta no es un PDF válido');\n }\n \n // Crear enlace de descarga\n const url = window.URL.createObjectURL(response.data);\n const link = document.createElement('a');\n link.href = url;\n link.download = filename.replace('.xml', '.pdf');\n link.click();\n \n // Liberar memoria\n window.URL.revokeObjectURL(url);\n } catch (error) {\n console.error('Error descargando PDF:', error);\n throw error;\n }\n};\n```\n\n**Response BASE64 (JSON):**\n```javascript\nconst downloadBASE64 = async (nit, filename) => {\n try {\n const response = await axios.get(\n `${API_URL}/api/ubl2.1/download/${nit}/${filename}/BASE64`,\n {\n headers: { 'Authorization': `Bearer ${token}` }\n }\n );\n \n // Respuesta típica:\n // {\n // \"content\": \"JVBERi0xLjQKJeLj...\",\n // \"filename\": \"FES-SETP990000249.pdf\",\n // \"size\": 45678\n // }\n \n return response.data;\n } catch (error) {\n console.error('Error descargando BASE64:', error);\n throw error;\n }\n};\n```\n\n### 📌 5. Descarga Masiva de Archivos\n\nPara descargar múltiples archivos de forma eficiente:\n\n```javascript\nconst downloadMultipleFiles = async (documents, format = 'PDF') => {\n // Limitar concurrencia para no saturar el servidor\n const BATCH_SIZE = 5;\n const results = [];\n \n for (let i = 0; i < documents.length; i += BATCH_SIZE) {\n const batch = documents.slice(i, i + BATCH_SIZE);\n \n const promises = batch.map(async (doc) => {\n try {\n const filename = buildFilename(\n doc.type_document_id,\n doc.prefix,\n doc.number\n );\n \n const response = await axios.get(\n `${API_URL}/api/ubl2.1/download/${doc.nit}/${filename}/${format}`,\n {\n headers: { 'Authorization': `Bearer ${token}` },\n responseType: format === 'BASE64' ? 'json' : 'blob',\n timeout: 30000 // 30 segundos por archivo\n }\n );\n \n return {\n success: true,\n document: doc,\n data: response.data\n };\n } catch (error) {\n return {\n success: false,\n document: doc,\n error: error.message\n };\n }\n });\n \n const batchResults = await Promise.all(promises);\n results.push(...batchResults);\n \n // Pausa entre batches para no saturar\n if (i + BATCH_SIZE < documents.length) {\n await new Promise(resolve => setTimeout(resolve, 1000));\n }\n }\n \n return results;\n};\n```\n\n### 📌 6. Almacenamiento en Base de Datos\n\nGuardar archivos en formato BASE64 en la base de datos:\n\n```javascript\nconst saveFileToDB = async (nit, filename) => {\n try {\n // Descargar en formato BASE64\n const response = await axios.get(\n `${API_URL}/api/ubl2.1/download/${nit}/${filename}/BASE64`,\n {\n headers: { 'Authorization': `Bearer ${token}` }\n }\n );\n \n const { content, size } = response.data;\n \n // Guardar en base de datos\n await db.query(\n `INSERT INTO document_files \n (nit, filename, content_base64, file_size, format, created_at)\n VALUES (?, ?, ?, ?, ?, NOW())`,\n [nit, filename, content, size, 'application/pdf']\n );\n \n return { success: true, size };\n } catch (error) {\n console.error('Error guardando archivo:', error);\n throw error;\n }\n};\n```\n\n### 📌 7. Envío por Email con Adjuntos\n\nIncorporar archivos descargados en envíos de email:\n\n```javascript\nconst sendEmailWithAttachment = async (email, nit, filename) => {\n try {\n // Descargar archivo en BASE64\n const fileResponse = await axios.get(\n `${API_URL}/api/ubl2.1/download/${nit}/${filename}/BASE64`,\n {\n headers: { 'Authorization': `Bearer ${token}` }\n }\n );\n \n const { content, filename: originalName } = fileResponse.data;\n \n // Enviar email con adjunto\n const emailData = {\n to: email,\n subject: 'Factura Electrónica',\n body: 'Adjunto encuentra su factura electrónica.',\n attachments: [\n {\n filename: originalName.replace('.xml', '.pdf'),\n content: content,\n encoding: 'base64',\n contentType: 'application/pdf'\n }\n ]\n };\n \n await sendEmail(emailData);\n return { success: true };\n } catch (error) {\n console.error('Error enviando email:', error);\n throw error;\n }\n};\n```\n\n### 📌 8. Manejo de Errores\n\n**Archivo no encontrado:**\n```javascript\ntry {\n const response = await axios.get(\n `${API_URL}/api/ubl2.1/download/${nit}/${filename}/${format}`,\n { headers: { 'Authorization': `Bearer ${token}` } }\n );\n} catch (error) {\n if (error.response?.status === 404) {\n console.error('Archivo no encontrado:', filename);\n // Verificar si el documento existe en la base de datos\n const docExists = await checkDocumentExists(nit, prefix, number);\n \n if (docExists) {\n // Regenerar archivo\n await regenerateDocumentFile(documentId);\n // Reintentar descarga\n return downloadFile(nit, filename, format);\n } else {\n throw new Error('El documento no existe en la base de datos');\n }\n } else if (error.response?.status === 401) {\n throw new Error('Token de autorización inválido o expirado');\n } else if (error.response?.status === 500) {\n throw new Error('Error del servidor al generar el archivo');\n } else {\n throw error;\n }\n}\n```\n\n### 📌 9. Componente React para Descarga\n\n```jsx\nimport React, { useState } from 'react';\nimport axios from 'axios';\nimport { Download, FileText, FilePdf } from 'lucide-react';\n\nconst FileDownloader = ({ document, nit, token }) => {\n const [downloading, setDownloading] = useState(false);\n const [format, setFormat] = useState('PDF');\n \n const buildFilename = () => {\n const prefixes = {\n 1: 'FES', 4: 'NC', 5: 'ND', 9: 'DS'\n };\n const prefix = prefixes[document.type_document_id] || 'DOC';\n return `${prefix}-${document.prefix}${document.number}.xml`;\n };\n \n const handleDownload = async () => {\n setDownloading(true);\n try {\n const filename = buildFilename();\n const response = await axios.get(\n `${process.env.REACT_APP_API_URL}/api/ubl2.1/download/${nit}/${filename}/${format}`,\n {\n headers: { 'Authorization': `Bearer ${token}` },\n responseType: format === 'BASE64' ? 'json' : 'blob',\n timeout: 30000\n }\n );\n \n if (format === 'BASE64') {\n // Convertir BASE64 a Blob y descargar\n const byteCharacters = atob(response.data.content);\n const byteNumbers = new Array(byteCharacters.length);\n for (let i = 0; i < byteCharacters.length; i++) {\n byteNumbers[i] = byteCharacters.charCodeAt(i);\n }\n const byteArray = new Uint8Array(byteNumbers);\n const blob = new Blob([byteArray], { type: 'application/pdf' });\n \n const url = window.URL.createObjectURL(blob);\n const link = document.createElement('a');\n link.href = url;\n link.download = filename.replace('.xml', '.pdf');\n link.click();\n window.URL.revokeObjectURL(url);\n } else {\n // Descarga directa de Blob\n const url = window.URL.createObjectURL(response.data);\n const link = document.createElement('a');\n link.href = url;\n link.download = filename.replace('.xml', format === 'PDF' ? '.pdf' : '.xml');\n link.click();\n window.URL.revokeObjectURL(url);\n }\n \n alert('Archivo descargado exitosamente');\n } catch (error) {\n console.error('Error descargando archivo:', error);\n if (error.response?.status === 404) {\n alert('El archivo no existe en el servidor');\n } else if (error.response?.status === 401) {\n alert('Token de autorización inválido. Por favor, inicie sesión nuevamente');\n } else {\n alert('Error al descargar el archivo. Intente nuevamente');\n }\n } finally {\n setDownloading(false);\n }\n };\n \n return (\n
\n setFormat(e.target.value)}\n className=\"border rounded px-2 py-1\"\n >\n \n \n \n \n \n \n {downloading ? (\n 'Descargando...'\n ) : (\n <>\n \n Descargar {format}\n \n )}\n \n
\n );\n};\n\nexport default FileDownloader;\n```\n\n### 📌 10. Verificación de Existencia de Archivos\n\nAntes de descargar, verificar si el archivo existe:\n\n```javascript\nconst fileExists = async (nit, filename) => {\n try {\n const response = await axios.head(\n `${API_URL}/api/ubl2.1/download/${nit}/${filename}/XML`,\n {\n headers: { 'Authorization': `Bearer ${token}` }\n }\n );\n \n return response.status === 200;\n } catch (error) {\n if (error.response?.status === 404) {\n return false;\n }\n throw error;\n }\n};\n\n// Uso\nconst filename = 'FES-SETP990000249.xml';\nif (await fileExists(nit, filename)) {\n await downloadFile(nit, filename, 'PDF');\n} else {\n console.error('Archivo no disponible:', filename);\n}\n```\n\n### 📌 11. Cache de Archivos Descargados\n\nImplementar cache local para evitar descargas repetidas:\n\n```javascript\nconst fileCache = new Map();\n\nconst getCachedFile = async (nit, filename, format) => {\n const cacheKey = `${nit}_${filename}_${format}`;\n \n // Verificar cache\n if (fileCache.has(cacheKey)) {\n const cached = fileCache.get(cacheKey);\n const cacheAge = Date.now() - cached.timestamp;\n \n // Cache válido por 1 hora\n if (cacheAge < 3600000) {\n console.log('Retornando archivo desde cache');\n return cached.data;\n } else {\n fileCache.delete(cacheKey);\n }\n }\n \n // Descargar archivo\n const response = await axios.get(\n `${API_URL}/api/ubl2.1/download/${nit}/${filename}/${format}`,\n {\n headers: { 'Authorization': `Bearer ${token}` },\n responseType: format === 'BASE64' ? 'json' : 'blob'\n }\n );\n \n // Guardar en cache\n fileCache.set(cacheKey, {\n data: response.data,\n timestamp: Date.now()\n });\n \n return response.data;\n};\n```\n\n### 📌 12. Descarga con Progress Bar\n\n```javascript\nconst downloadWithProgress = async (nit, filename, format, onProgress) => {\n try {\n const response = await axios.get(\n `${API_URL}/api/ubl2.1/download/${nit}/${filename}/${format}`,\n {\n headers: { 'Authorization': `Bearer ${token}` },\n responseType: format === 'BASE64' ? 'json' : 'blob',\n onDownloadProgress: (progressEvent) => {\n const percentCompleted = Math.round(\n (progressEvent.loaded * 100) / progressEvent.total\n );\n onProgress(percentCompleted);\n }\n }\n );\n \n return response.data;\n } catch (error) {\n console.error('Error en descarga con progreso:', error);\n throw error;\n }\n};\n\n// Componente React con Progress\nconst DownloadWithProgress = ({ nit, filename, format }) => {\n const [progress, setProgress] = useState(0);\n const [downloading, setDownloading] = useState(false);\n \n const handleDownload = async () => {\n setDownloading(true);\n setProgress(0);\n \n try {\n const data = await downloadWithProgress(\n nit,\n filename,\n format,\n setProgress\n );\n \n // Procesar descarga...\n alert('Descarga completada');\n } catch (error) {\n alert('Error en la descarga');\n } finally {\n setDownloading(false);\n setProgress(0);\n }\n };\n \n return (\n
\n \n {downloading && (\n
\n
\n {progress}%\n
\n
\n )}\n
\n );\n};\n```\n\n### 📌 13. Integración con ZIP para Descargas Masivas\n\nCrear archivo ZIP con múltiples documentos:\n\n```javascript\nimport JSZip from 'jszip';\nimport { saveAs } from 'file-saver';\n\nconst downloadMultipleAsZip = async (documents, nit, format = 'PDF') => {\n const zip = new JSZip();\n const errors = [];\n \n for (const doc of documents) {\n try {\n const filename = buildFilename(\n doc.type_document_id,\n doc.prefix,\n doc.number\n );\n \n // Descargar en BASE64\n const response = await axios.get(\n `${API_URL}/api/ubl2.1/download/${nit}/${filename}/BASE64`,\n {\n headers: { 'Authorization': `Bearer ${token}` }\n }\n );\n \n // Agregar al ZIP\n const outputFilename = filename.replace('.xml', '.pdf');\n zip.file(outputFilename, response.data.content, { base64: true });\n } catch (error) {\n errors.push({\n document: doc,\n error: error.message\n });\n }\n }\n \n // Generar ZIP\n const zipBlob = await zip.generateAsync({ type: 'blob' });\n \n // Descargar\n saveAs(zipBlob, `documentos_${nit}_${Date.now()}.zip`);\n \n return { success: true, errors };\n};\n```\n\n### 📌 14. Regeneración de Archivos Faltantes\n\nSi un archivo no existe, regenerarlo desde la base de datos:\n\n```javascript\nconst ensureFileExists = async (documentId, nit, filename) => {\n try {\n // Intentar descargar\n const response = await axios.get(\n `${API_URL}/api/ubl2.1/download/${nit}/${filename}/XML`,\n {\n headers: { 'Authorization': `Bearer ${token}` },\n validateStatus: (status) => status === 200 || status === 404\n }\n );\n \n if (response.status === 404) {\n console.log('Archivo no existe, regenerando...');\n \n // Llamar endpoint de regeneración\n await axios.post(\n `${API_URL}/api/ubl2.1/regenerate-document-files`,\n { document_id: documentId },\n {\n headers: { 'Authorization': `Bearer ${token}` }\n }\n );\n \n // Esperar procesamiento\n await new Promise(resolve => setTimeout(resolve, 2000));\n \n // Reintentar descarga\n return await axios.get(\n `${API_URL}/api/ubl2.1/download/${nit}/${filename}/XML`,\n {\n headers: { 'Authorization': `Bearer ${token}` }\n }\n );\n }\n \n return response;\n } catch (error) {\n console.error('Error asegurando existencia del archivo:', error);\n throw error;\n }\n};\n```\n\n### 📌 15. Vista Previa de PDF\n\nMostrar vista previa del PDF antes de descargar:\n\n```jsx\nimport React, { useState } from 'react';\nimport axios from 'axios';\n\nconst PDFPreviewModal = ({ nit, filename, token, onClose }) => {\n const [pdfUrl, setPdfUrl] = useState(null);\n const [loading, setLoading] = useState(true);\n \n useEffect(() => {\n const loadPDF = async () => {\n try {\n const response = await axios.get(\n `${process.env.REACT_APP_API_URL}/api/ubl2.1/download/${nit}/${filename}/PDF`,\n {\n headers: { 'Authorization': `Bearer ${token}` },\n responseType: 'blob'\n }\n );\n \n const url = window.URL.createObjectURL(response.data);\n setPdfUrl(url);\n } catch (error) {\n console.error('Error cargando PDF:', error);\n } finally {\n setLoading(false);\n }\n };\n \n loadPDF();\n \n return () => {\n if (pdfUrl) {\n window.URL.revokeObjectURL(pdfUrl);\n }\n };\n }, [nit, filename, token]);\n \n return (\n
\n
\n
\n

Vista Previa - {filename}

\n \n
\n
\n {loading ? (\n

Cargando PDF...

\n ) : pdfUrl ? (\n \n ) : (\n

Error cargando PDF

\n )}\n
\n
\n
\n );\n};\n\nexport default PDFPreviewModal;\n```\n\n---\n\n## 📊 TABLAS DE REFERENCIA\n\n### Tabla 1: Parámetros de URL\n\n| Parámetro | Tipo | Obligatorio | Descripción | Ejemplo |\n|-----------|------|-------------|-------------|----------|\n| `nit` | string | Sí | NIT de la empresa (sin DV, sin puntos) | `89008003` |\n| `filename` | string | Sí | Nombre completo del archivo con extensión | `FES-SETP990000249.xml` |\n| `format` | string | Sí | Formato de salida deseado | `XML`, `PDF`, `BASE64` |\n\n### Tabla 2: Formatos de Descarga\n\n| Formato | Content-Type | Response Type | Uso Principal | Ventajas | Desventajas |\n|---------|--------------|---------------|---------------|----------|-------------|\n| `XML` | `application/xml` | `text` | Validación, integración | Formato original, validable | No legible humano |\n| `PDF` | `application/pdf` | `blob` | Visualización, impresión | Legible, portable | No editable |\n| `BASE64` | `application/json` | `json` | Email, almacenamiento DB | Transportable, embebible | Mayor tamaño |\n\n### Tabla 3: Prefijos de Tipos de Documento\n\n| type_document_id | Prefijo | Descripción | Ejemplo Filename |\n|------------------|---------|-------------|------------------|\n| 1 | `FES` | Factura Electrónica de Venta | `FES-SETP990000249.xml` |\n| 4 | `NC` | Nota Crédito | `NC-NC77.xml` |\n| 5 | `ND` | Nota Débito | `ND-ND55.xml` |\n| 9 | `DS` | Documento Soporte | `DS-DS12345.xml` |\n| 10 | `DS-NC` | Documento Soporte Nota Crédito | `DS-NC-DSNC100.xml` |\n| 13 | `AR` | Documento Equivalente | `AR-AR2024001.xml` |\n\n### Tabla 4: Códigos de Respuesta HTTP\n\n| Código | Descripción | Acción Recomendada |\n|--------|-------------|--------------------|\n| 200 | Archivo descargado exitosamente | Procesar archivo |\n| 401 | Token inválido o expirado | Renovar autenticación |\n| 404 | Archivo no encontrado | Verificar existencia del documento, regenerar |\n| 500 | Error del servidor | Reintentar después de unos segundos |\n| 503 | Servicio no disponible | Implementar cola de reintentos |\n\n### Tabla 5: Casos de Uso por Formato\n\n| Caso de Uso | Formato Recomendado | Justificación |\n|-------------|---------------------|---------------|\n| Envío por email a cliente | `BASE64` (convertir a PDF) | Compatible con SMTP, adjunto inline |\n| Visualización en navegador | `PDF` (blob) | Renderizado directo con `