{ "variable": [ { "id": "baseUrl", "key": "baseUrl", "type": "string", "name": "string", "value": "https:\/\/autorizaciones.jfpcode.com" } ], "info": { "name": "API Facturaci\u00f3n Electr\u00f3nica - Ecuador SRI", "_postman_id": "dda543ad-6314-4803-b16e-bc87bf658643", "description": "API REST para emisi\u00f3n y autorizaci\u00f3n de documentos electr\u00f3nicos con el SRI Ecuador", "schema": "https:\/\/schema.getpostman.com\/json\/collection\/v2.1.0\/collection.json" }, "item": [ { "name": "01. Autenticaci\u00f3n", "description": "\nEndpoints para gesti\u00f3n de autenticaci\u00f3n de usuarios.\nUtiliza Laravel Sanctum para generar tokens Bearer.", "item": [ { "name": "Iniciar sesi\u00f3n", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/auth\/login", "query": [], "raw": "{{baseUrl}}\/api\/auth\/login" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"email\":\"gbailey@example.net\",\"password\":\"|]|{+-\"}" }, "description": "Autentica al usuario y devuelve un token Bearer para usar en las dem\u00e1s peticiones.", "auth": { "type": "noauth" } }, "response": [ { "header": [], "code": 200, "body": "{\n \"success\": true,\n \"message\": \"Inicio de sesi\u00f3n exitoso\",\n \"data\": {\n \"user\": {\n \"id\": 1,\n \"name\": \"Juan P\u00e9rez\",\n \"email\": \"usuario@empresa.com\",\n \"ruc\": \"1793190102001\",\n \"role\": \"user\",\n \"business\": {\n \"id\": 1,\n \"name\": \"Mi Empresa S.A.\",\n \"ruc\": \"1793190102001\"\n }\n },\n \"token\": \"1|abc123def456...\"\n }\n}", "name": "Login exitoso" }, { "header": [], "code": 422, "body": "{\n \"message\": \"Las credenciales proporcionadas son incorrectas.\",\n \"errors\": {\n \"email\": [\"Las credenciales proporcionadas son incorrectas.\"]\n }\n}", "name": "Credenciales inv\u00e1lidas" }, { "header": [], "code": 422, "body": "{\n \"message\": \"Esta cuenta ha sido desactivada.\",\n \"errors\": {\n \"email\": [\"Esta cuenta ha sido desactivada.\"]\n }\n}", "name": "Cuenta desactivada" } ] }, { "name": "Registrar nuevo usuario", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/auth\/register", "query": [], "raw": "{{baseUrl}}\/api\/auth\/register" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"b\",\"email\":\"zbailey@example.net\",\"password\":\"|]|{+-\",\"password_confirmation\":\"architecto\"}" }, "description": "Endpoint p\u00fablico para registro de usuarios desde apps m\u00f3viles y web.\nProtegido con rate limiting para prevenir abuso.", "auth": { "type": "noauth" } }, "response": [ { "header": [], "code": 201, "body": "{\n \"success\": true,\n \"message\": \"Usuario registrado exitosamente\",\n \"data\": {\n \"user\": {\n \"id\": 1,\n \"name\": \"Juan P\u00e9rez\",\n \"email\": \"juan@email.com\",\n \"role\": \"user\"\n },\n \"token\": \"1|abc123def456...\",\n \"next_steps\": {\n \"create_business\": \"POST \/api\/business - Crear su empresa\",\n \"profile\": \"GET \/api\/auth\/me - Ver perfil\"\n }\n }\n}", "name": "Registro exitoso" } ] }, { "name": "Verificar disponibilidad de email", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/auth\/check-email", "query": [], "raw": "{{baseUrl}}\/api\/auth\/check-email" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"email\":\"gbailey@example.net\"}" }, "description": "Verifica si un email ya est\u00e1 registrado en el sistema.", "auth": { "type": "noauth" } }, "response": [ { "header": [], "code": 200, "body": "{\n \"success\": true,\n \"data\": {\n \"email\": \"juan@email.com\",\n \"available\": true\n }\n}", "name": "" } ] }, { "name": "Cerrar sesi\u00f3n", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/auth\/logout", "query": [], "raw": "{{baseUrl}}\/api\/auth\/logout" }, "method": "POST", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Revoca el token actual del usuario autenticado." }, "response": [ { "header": [], "code": 200, "body": "{\n \"success\": true,\n \"message\": \"Sesi\u00f3n cerrada exitosamente\"\n}", "name": "" } ] }, { "name": "Obtener usuario actual", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/auth\/me", "query": [], "raw": "{{baseUrl}}\/api\/auth\/me" }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Devuelve la informaci\u00f3n del usuario autenticado incluyendo su empresa asociada." }, "response": [ { "header": [], "code": 200, "body": "{\n \"success\": true,\n \"data\": {\n \"id\": 1,\n \"name\": \"Juan P\u00e9rez\",\n \"email\": \"usuario@empresa.com\",\n \"ruc\": \"1793190102001\",\n \"role\": \"user\",\n \"phone\": \"0999999999\",\n \"is_active\": true,\n \"last_login_at\": \"2025-12-29T10:30:00.000000Z\",\n \"business\": {\n \"id\": 1,\n \"name\": \"Mi Empresa S.A.\",\n \"ruc\": \"1793190102001\"\n }\n }\n}", "name": "" } ] }, { "name": "Cambiar contrase\u00f1a", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/auth\/change-password", "query": [], "raw": "{{baseUrl}}\/api\/auth\/change-password" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"current_password\":\"architecto\",\"new_password\":\"ngzmiyvdljnikhwaykcmyuwpwl\"}" }, "description": "Permite al usuario cambiar su contrase\u00f1a actual." }, "response": [ { "header": [], "code": 200, "body": "{\n \"success\": true,\n \"message\": \"Contrase\u00f1a actualizada exitosamente\"\n}", "name": "" }, { "header": [], "code": 422, "body": "{\n \"message\": \"La contrase\u00f1a actual es incorrecta.\",\n \"errors\": {\n \"current_password\": [\"La contrase\u00f1a actual es incorrecta.\"]\n }\n}", "name": "Contrase\u00f1a actual incorrecta" } ] } ] }, { "name": "02. Emisi\u00f3n de Facturas", "description": "\nEndpoints para la creaci\u00f3n, firma y autorizaci\u00f3n de facturas electr\u00f3nicas.\nEl proceso completo incluye:\n1. Validaci\u00f3n de datos\n2. Generaci\u00f3n de XML seg\u00fan esquema SRI\n3. Firma digital con certificado .p12\n4. Env\u00edo al SRI para autorizaci\u00f3n\n5. Generaci\u00f3n de RIDE (PDF)\n6. Env\u00edo por email al cliente", "item": [ { "name": "Crear y autorizar factura", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/factura\/create", "query": [], "raw": "{{baseUrl}}\/api\/factura\/create" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"dataEmpresa\":{\"ambiente\":16,\"emision\":16,\"razonSocial\":\"architecto\",\"nombreComercial\":\"architecto\",\"ruc\":\"architecto\",\"direccion\":\"architecto\",\"obligadoContabilidad\":\"architecto\",\"agenteRetenedor\":\"architecto\",\"resolucionAgenteRetenedor\":\"architecto\",\"contribuyenteRimpe\":\"architecto\",\"contribuyenteEspecial\":\"architecto\",\"email\":\"zbailey@example.net\"},\"dataVenta\":{\"numeroDocumento\":\"architecto\",\"direccionBodega\":\"architecto\",\"fecha\":\"11-10-2026\",\"email1\":\"zbailey@example.net\",\"email2\":\"gulgowski.asia@example.com\",\"email3\":\"idickens@example.org\",\"codigoCliente\":\"architecto\",\"direccion\":\"architecto\",\"telefono\":\"architecto\",\"idTipoIdentificacion\":\"architecto\",\"razonSocial\":\"architecto\",\"identificacion\":\"architecto\",\"subtotal\":4326.41688,\"descuento\":4326.41688,\"baseGravableIva\":4326.41688,\"baseNoGravableIva\":4326.41688,\"montoIva\":4326.41688,\"montoRecargo\":4326.41688,\"flete\":4326.41688,\"montoNeto\":4326.41688,\"moneda\":\"architecto\",\"clave\":\"architecto\"},\"dataTipoImpuesto\":{\"codigoSriAts\":\"architecto\",\"codigoSriDocumentoElectronico\":\"architecto\",\"porcentaje\":4326.41688},\"dataTipoImpuesto_0\":{\"codigoSriAts\":\"architecto\",\"codigoSriDocumentoElectronico\":\"architecto\",\"porcentaje\":4326.41688},\"dataPago\":[{\"codigoSriDocumentoElectronico\":\"architecto\",\"monto\":4326.41688,\"cantidadDias\":4326.41688}],\"dataItem\":[{\"codigoPrincipal\":\"architecto\",\"codigoAuxiliar\":\"architecto\",\"descripcionProducto\":\"architecto\",\"notaProducto\":\"architecto\",\"cantidad\":4326.41688,\"precioUnitario\":4326.41688,\"subtotalProducto\":4326.41688,\"descuentoProducto\":4326.41688,\"montoIvaProducto\":4326.41688}],\"dataItemAdicional\":[{\"campo\":\"architecto\"}],\"dataInfoAdicional\":[{\"campo\":\"architecto\",\"contenido\":\"architecto\"}]}" }, "description": "Crea una factura electr\u00f3nica, la firma digitalmente y la env\u00eda al SRI para autorizaci\u00f3n.\nSi es autorizada, genera el RIDE (PDF) y lo env\u00eda por email al cliente.", "auth": { "type": "noauth" } }, "response": [ { "header": [], "code": 200, "body": "{\n \"estado\": \"AUTORIZADO\",\n \"clave_acceso\": \"2912202501179319010200110010010000001251234567813\",\n \"numero_autorizacion\": \"2912202501179319010200110010010000001251234567813\",\n \"fecha_autorizacion\": \"2025-12-29T11:30:00-05:00\",\n \"ambiente\": \"PRODUCCI\u00d3N\",\n \"xml_autorizado\": \"documentos\/1793190102001\/2025\/12\/facturas\/xml\/2912202501..._autorizado.xml\",\n \"ride_pdf\": \"documentos\/1793190102001\/2025\/12\/facturas\/pdf\/2912202501..._ride.pdf\",\n \"email_enviado\": true\n}", "name": "Factura autorizada" }, { "header": [], "code": 200, "body": "{\n \"estado\": \"RECHAZADO\",\n \"clave_acceso\": \"2912202501179319010200110010010000001251234567813\",\n \"errores\": [\n {\n \"codigo\": \"35\",\n \"mensaje\": \"DOCUMENTO DUPLICADO\"\n }\n ]\n}", "name": "Factura rechazada" }, { "header": [], "code": 422, "body": "{\n \"success\": false,\n \"message\": \"Error de validaci\u00f3n\",\n \"errors\": {\n \"dataEmpresa.ruc\": [\"El campo dataEmpresa.ruc es obligatorio.\"]\n }\n}", "name": "Error de validaci\u00f3n" } ] }, { "name": "GET api\/check-certificate", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/check-certificate", "query": [], "raw": "{{baseUrl}}\/api\/check-certificate" }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] } ] }, { "name": "06. Consulta de Documentos", "description": "\nEndpoints para consultar, filtrar y descargar documentos emitidos.\nPermite obtener estad\u00edsticas, buscar documentos y descargar XML\/PDF.", "item": [ { "name": "Listar documentos emitidos", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/documents", "query": [], "raw": "{{baseUrl}}\/api\/documents" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"business_ruc\":\"bngzmiyvdljni\",\"business_id\":16,\"start_date\":\"2026-10-11T20:45:46\",\"end_date\":\"2052-11-03\",\"document_type\":1,\"status\":\"ERROR\",\"customer_identification\":\"architecto\",\"page\":22,\"per_page\":7}" }, "description": "Obtiene una lista paginada de documentos emitidos con filtros opcionales.", "auth": { "type": "noauth" } }, "response": [ { "header": [], "code": 200, "body": "{\n \"success\": true,\n \"message\": \"Documentos obtenidos exitosamente\",\n \"data\": {\n \"documents\": [\n {\n \"id\": 1,\n \"access_key\": \"2912202501179319010200110010010000001251234567813\",\n \"document_type\": \"01\",\n \"document_number\": \"001-001-000000125\",\n \"status\": \"AUTORIZADO\",\n \"total_amount\": 115.00,\n \"customer_name\": \"Juan P\u00e9rez\",\n \"emission_date\": \"2025-12-29\",\n \"authorization_date\": \"2025-12-29T11:30:00\"\n }\n ],\n \"pagination\": {\n \"current_page\": 1,\n \"last_page\": 5,\n \"per_page\": 20,\n \"total\": 100\n }\n }\n}", "name": "" } ] }, { "name": "Obtener estad\u00edsticas de documentos emitidos", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/documents\/statistics", "query": [], "raw": "{{baseUrl}}\/api\/documents\/statistics" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"business_ruc\":\"bngzmiyvdljni\",\"business_id\":16,\"start_date\":\"2026-10-11T20:45:46\",\"end_date\":\"2052-11-03\"}" }, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Buscar documentos por m\u00faltiples criterios", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/documents\/search", "query": [], "raw": "{{baseUrl}}\/api\/documents\/search" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"query\":\"bngzmiyvdljnikhwaykcmyuwpwlvqwrsitcpscqldzsnrwtujwvlxjklqppwqbewtnnoqitpxn\",\"search_in\":[\"document_number\"],\"business_ruc\":\"tltcvipojsaus\",\"document_type\":1,\"status\":\"ENVIADO\",\"limit\":19}" }, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Exportar documentos a CSV", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/documents\/export\/csv", "query": [], "raw": "{{baseUrl}}\/api\/documents\/export\/csv" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"business_ruc\":\"bngzmiyvdljni\",\"start_date\":\"2026-10-11T20:45:46\",\"end_date\":\"2052-11-03\",\"document_type\":5,\"status\":\"FIRMADO\"}" }, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Descargar XML autorizado por clave de acceso", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/documents\/xml\/:accessKey", "query": [], "raw": "{{baseUrl}}\/api\/documents\/xml\/:accessKey", "variable": [ { "id": "accessKey", "key": "accessKey", "value": "architecto", "description": "" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Descargar PDF RIDE por clave de acceso", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/documents\/pdf\/:accessKey", "query": [], "raw": "{{baseUrl}}\/api\/documents\/pdf\/:accessKey", "variable": [ { "id": "accessKey", "key": "accessKey", "value": "architecto", "description": "" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Consultar estado de documento con archivos comprimidos", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/documents\/status\/:accessKey\/files", "query": [], "raw": "{{baseUrl}}\/api\/documents\/status\/:accessKey\/files", "variable": [ { "id": "accessKey", "key": "accessKey", "value": "architecto", "description": "" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Endpoint optimizado para sistemas de facturaci\u00f3n masiva.\nDevuelve el estado del documento junto con XML y PDF comprimidos y codificados en base64.", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Consultar estado de m\u00faltiples documentos (batch)", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/documents\/status\/batch", "query": [], "raw": "{{baseUrl}}\/api\/documents\/status\/batch" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"access_keys\":[\"bngzmiyvdljnikhwaykcmyuwpwlvqwrsitcpscqldzsnrwtuj\"],\"include_files\":false}" }, "description": "Permite consultar el estado de hasta 50 documentos en una sola petici\u00f3n.", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Descargar archivo de documento (XML o PDF)", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/documents\/:emission\/files\/:file\/download", "query": [], "raw": "{{baseUrl}}\/api\/documents\/:emission\/files\/:file\/download", "variable": [ { "id": "emission", "key": "emission", "value": "architecto", "description": "" }, { "id": "file", "key": "file", "value": "architecto", "description": "The file." } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Obtener detalles de un documento espec\u00edfico", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/documents\/:id", "query": [], "raw": "{{baseUrl}}\/api\/documents\/:id", "variable": [ { "id": "id", "key": "id", "value": "architecto", "description": "The ID of the document." } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] } ] }, { "name": "07. Reintentos y Recuperaci\u00f3n", "description": "", "item": [ { "name": "Continuar autorizaci\u00f3n de documento en estado ENVIADO o FIRMADO", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/documents\/continue-authorization", "query": [], "raw": "{{baseUrl}}\/api\/documents\/continue-authorization" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"access_key\":\"bngzmiyvdljnikhwaykcmyuwpwlvqwrsitcpscqldzsnrwtuj\",\"email\":\"schultz.audrey@example.org\"}" }, "description": "Este endpoint toma un documento que se qued\u00f3 en estado intermedio (ENVIADO\/FIRMADO)\ny contin\u00faa el proceso de autorizaci\u00f3n con el SRI usando el XML firmado existente.", "auth": { "type": "noauth" } }, "response": [ { "header": [], "code": 200, "body": "{\n \"status\": \"SUCCESS\",\n \"message\": \"Documento autorizado exitosamente\",\n \"data\": {\n \"status\": \"AUTORIZADO\",\n \"numero_autorizacion\": \"0601202604171719678400110010010000000091234567814\",\n \"ride_generated\": true,\n \"email_sent\": true\n }\n}", "name": "" } ] }, { "name": "Regenerar RIDE (PDF) de un documento ya autorizado", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/documents\/retry-ride", "query": [], "raw": "{{baseUrl}}\/api\/documents\/retry-ride" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"access_key\":\"bngzmiyvdljnikhwaykcmyuwpwlvqwrsitcpscqldzsnrwtuj\"}" }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "header": [], "code": 200, "body": "{\n \"status\": \"SUCCESS\",\n \"message\": \"RIDE regenerado exitosamente\",\n \"data\": {\"pdf_path\": \"...\"}\n}", "name": "" } ] }, { "name": "Reintento completo: autorizaci\u00f3n + RIDE + email", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/documents\/retry-complete", "query": [], "raw": "{{baseUrl}}\/api\/documents\/retry-complete" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"access_key\":\"bngzmiyvdljnikhwaykcmyuwpwlvqwrsitcpscqldzsnrwtuj\",\"email\":\"schultz.audrey@example.org\"}" }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "header": [], "code": 200, "body": "{\n \"status\": \"SUCCESS\",\n \"message\": \"Proceso completo ejecutado\",\n \"data\": {\"authorization\": \"...\", \"ride\": \"...\", \"email\": \"...\"}\n}", "name": "" } ] }, { "name": "Consultar estado de un documento directamente en el SRI", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/documents\/check-sri-status", "query": [], "raw": "{{baseUrl}}\/api\/documents\/check-sri-status" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"access_key\":\"bngzmiyvdljnikhwaykcmyuwpwlvqwrsitcpscqldzsnrwtuj\",\"ambiente\":2}" }, "description": "Este endpoint consulta el estado de autorizaci\u00f3n directamente en los\nweb services del SRI, \u00fatil cuando el documento est\u00e1 \"EN PROCESAMIENTO\"\no cuando se necesita verificar el estado real en el SRI.", "auth": { "type": "noauth" } }, "response": [ { "header": [], "code": 200, "body": "{\n \"status\": \"SUCCESS\",\n \"data\": {\n \"access_key\": \"2502202601171719678400110010010000000527961390210\",\n \"sri_status\": \"AUTORIZADO\",\n \"numero_autorizacion\": \"2502202601171719678400110010010000000527961390210\",\n \"fecha_autorizacion\": \"2026-02-25T10:30:00-05:00\",\n \"ambiente\": \"PRUEBAS\",\n \"can_continue\": false,\n \"message\": \"Documento autorizado por el SRI\"\n }\n}", "name": "" }, { "header": [], "code": 200, "body": "{\n \"status\": \"SUCCESS\",\n \"data\": {\n \"access_key\": \"2502202601171719678400110010010000000527961390210\",\n \"sri_status\": \"EN_PROCESAMIENTO\",\n \"message\": \"La clave de acceso est\u00e1 en procesamiento en el SRI\",\n \"can_continue\": true,\n \"retry_after_seconds\": 30\n }\n}", "name": "" } ] }, { "name": "Consultar estado de un documento por clave de acceso", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/documents\/status\/:accessKey", "query": [], "raw": "{{baseUrl}}\/api\/documents\/status\/:accessKey", "variable": [ { "id": "accessKey", "key": "accessKey", "value": "architecto", "description": "" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Este endpoint permite a sistemas externos (como POS) verificar el estado\nactual de un documento y saber qu\u00e9 acciones pueden tomar.", "auth": { "type": "noauth" } }, "response": [ { "header": [], "code": 200, "body": "{\n \"status\": \"SUCCESS\",\n \"data\": {\n \"access_key\": \"0601202604...\",\n \"document_status\": \"ENVIADO\",\n \"document_type\": \"nota_credito\",\n \"is_final_status\": false,\n \"can_continue_authorization\": true,\n \"actions_available\": [\"continue_authorization\"],\n \"next_action\": {\n \"endpoint\": \"\/api\/documents\/continue-authorization\",\n \"method\": \"POST\",\n \"params\": {\"access_key\": \"...\"}\n }\n }\n}", "name": "" } ] } ] }, { "name": "09. Administraci\u00f3n de Usuarios", "description": "\nEndpoints para gesti\u00f3n de usuarios del sistema (solo administradores).\nPermite crear, editar, eliminar y gestionar usuarios y sus permisos.", "item": [ { "name": "Listar usuarios", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/admin\/users", "query": [], "raw": "{{baseUrl}}\/api\/admin\/users" }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Obtiene lista paginada de usuarios con filtros opcionales." }, "response": [ { "header": [], "code": 200, "body": "{\n \"success\": true,\n \"data\": {\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Juan P\u00e9rez\",\n \"email\": \"juan@empresa.com\",\n \"ruc\": \"1793190102001\",\n \"role\": \"user\",\n \"is_active\": true,\n \"business\": {\"id\": 1, \"name\": \"Mi Empresa S.A.\"}\n }\n ],\n \"current_page\": 1,\n \"total\": 10\n }\n}", "name": "" } ] }, { "name": "Crear usuario", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/admin\/users", "query": [], "raw": "{{baseUrl}}\/api\/admin\/users" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"b\",\"email\":\"zbailey@example.net\",\"password\":\"-0pBNvYgxw\",\"ruc\":\"aykcmyuwpwlvq\",\"role\":\"viewer\",\"phone\":\"wrsitcpscqldzsnr\",\"is_active\":true}" }, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Mostrar usuario", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/admin\/users\/:id", "query": [], "raw": "{{baseUrl}}\/api\/admin\/users\/:id", "variable": [ { "id": "id", "key": "id", "value": "architecto", "description": "The ID of the user." } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Actualizar usuario", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/admin\/users\/:id", "query": [], "raw": "{{baseUrl}}\/api\/admin\/users\/:id", "variable": [ { "id": "id", "key": "id", "value": "architecto", "description": "The ID of the user." } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"b\",\"email\":\"zbailey@example.net\",\"password\":\"-0pBNvYgxw\",\"ruc\":\"aykcmyuwpwlvq\",\"role\":\"viewer\",\"phone\":\"wrsitcpscqldzsnr\",\"is_active\":false}" }, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Eliminar usuario", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/admin\/users\/:id", "query": [], "raw": "{{baseUrl}}\/api\/admin\/users\/:id", "variable": [ { "id": "id", "key": "id", "value": "architecto", "description": "The ID of the user." } ] }, "method": "DELETE", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Activar\/Desactivar usuario", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/admin\/users\/:id\/toggle-status", "query": [], "raw": "{{baseUrl}}\/api\/admin\/users\/:id\/toggle-status", "variable": [ { "id": "id", "key": "id", "value": "architecto", "description": "The ID of the user." } ] }, "method": "POST", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Obtener empresas disponibles para asignar", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/admin\/businesses-list", "query": [], "raw": "{{baseUrl}}\/api\/admin\/businesses-list" }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] } ] }, { "name": "10. Mis Documentos", "description": "\nEndpoints para que usuarios autenticados consulten y descarguen sus documentos.\nLos documentos se filtran autom\u00e1ticamente por el RUC asignado al usuario.", "item": [ { "name": "Listar mis documentos", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/my-documents", "query": [], "raw": "{{baseUrl}}\/api\/my-documents" }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Obtiene los documentos del usuario autenticado, filtrados por su RUC asignado.\nAdministradores pueden ver todos los documentos." }, "response": [ { "header": [], "code": 200, "body": "{\n \"success\": true,\n \"data\": {\n \"data\": [{\"id\": 1, \"access_key\": \"291220250117...\", \"status\": \"AUTORIZADO\"}],\n \"total\": 50\n }\n}", "name": "" } ] }, { "name": "Estad\u00edsticas de documentos del usuario", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/my-documents\/statistics", "query": [], "raw": "{{baseUrl}}\/api\/my-documents\/statistics" }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Obtener lista de documentos disponibles para descarga por lotes", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/my-documents\/downloadable", "query": [], "raw": "{{baseUrl}}\/api\/my-documents\/downloadable" }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Mostrar detalle de un documento", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/my-documents\/:accessKey", "query": [], "raw": "{{baseUrl}}\/api\/my-documents\/:accessKey", "variable": [ { "id": "accessKey", "key": "accessKey", "value": "architecto", "description": "" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Descargar XML de un documento", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/my-documents\/:accessKey\/xml", "query": [], "raw": "{{baseUrl}}\/api\/my-documents\/:accessKey\/xml", "variable": [ { "id": "accessKey", "key": "accessKey", "value": "architecto", "description": "" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Descargar PDF de un documento", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/my-documents\/:accessKey\/pdf", "query": [], "raw": "{{baseUrl}}\/api\/my-documents\/:accessKey\/pdf", "variable": [ { "id": "accessKey", "key": "accessKey", "value": "architecto", "description": "" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Descarga por lotes (m\u00faltiples documentos)", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/my-documents\/download-batch", "query": [], "raw": "{{baseUrl}}\/api\/my-documents\/download-batch" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"access_keys\":[\"bngzmiyvdljnikhwaykcmyuwpwlvqwrsitcpscqldzsnrwtuj\"],\"file_types\":[\"XML_AUTHORIZED\"]}" }, "description": "", "auth": { "type": "noauth" } }, "response": [] } ] }, { "name": "Emisi\u00f3n de Documentos", "description": "Endpoints para la emisi\u00f3n y procesamiento de documentos electr\u00f3nicos.", "item": [ { "name": "Crear Factura Electr\u00f3nica", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v2\/factura", "query": [], "raw": "{{baseUrl}}\/api\/v2\/factura" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"incluirDocumentos\":false,\"dataEmpresa\":{\"ambiente\":2,\"emision\":16,\"razonSocial\":\"n\",\"nombreComercial\":\"g\",\"ruc\":\"zmiyvdljnikhw\",\"direccion\":\"a\",\"obligadoContabilidad\":\"S\",\"agenteRetenedor\":\"S\",\"resolucionAgenteRetenedor\":\"architecto\",\"contribuyenteRimpe\":\"S\",\"contribuyenteEspecial\":\"S\",\"idContribuyenteEspecial\":\"architecto\",\"email\":\"zbailey@example.net\"},\"dataVenta\":{\"numeroDocumento\":\"425-593-142326822\",\"direccionBodega\":\"m\",\"fecha\":\"11-10-2026\",\"email1\":\"marquardt.noah@example.com\",\"email2\":\"emelie.baumbach@example.net\",\"email3\":\"ferne52@example.com\",\"codigoCliente\":\"architecto\",\"direccion\":\"n\",\"telefono\":\"architecto\",\"idTipoIdentificacion\":4,\"razonSocial\":\"n\",\"identificacion\":\"gzmiyvdljnikhway\",\"subtotal\":62,\"descuento\":54,\"baseGravableIva\":38,\"baseNoGravableIva\":50,\"montoIva\":72,\"montoRecargo\":61,\"flete\":67,\"montoNeto\":61,\"moneda\":\"architecto\",\"clave\":\"ngzmiyvdljnikhwaykcmyuwpwlvqwrsitcpscqldzsnrwtujw\"},\"dataTipoImpuesto\":{\"codigoSriAts\":\"architecto\",\"codigoSriDocumentoElectronico\":\"architecto\",\"porcentaje\":4326.41688},\"dataTipoImpuesto_0\":{\"codigoSriAts\":\"architecto\",\"codigoSriDocumentoElectronico\":\"architecto\",\"porcentaje\":4326.41688},\"dataPago\":[{\"codigoSriDocumentoElectronico\":\"architecto\",\"monto\":39,\"cantidadDias\":84}],\"dataItem\":[{\"codigoPrincipal\":\"z\",\"codigoAuxiliar\":\"m\",\"descripcionProducto\":\"i\",\"notaProducto\":\"architecto\",\"cantidad\":39,\"precioUnitario\":84,\"subtotalProducto\":12,\"descuentoProducto\":77,\"montoIvaProducto\":8}],\"dataItemAdicional\":[{\"campo\":\"architecto\"}],\"dataInfoAdicional\":[{\"campo\":\"architecto\",\"contenido\":\"architecto\"}]}" }, "description": "Env\u00eda una factura para su procesamiento s\u00edncrono. El sistema intentar\u00e1 autorizarla inmediatamente con el SRI." }, "response": [ { "header": [], "code": 200, "body": "{\n \"success\": true,\n \"message\": \"COMPROBANTE AUTORIZADO\",\n \"data\": {\n \"claveAcceso\": \"0502202601179001122300110010100000123451234567812\",\n \"estado\": \"AUTORIZADO\",\n \"numeroAutorizacion\": \"0502202601179001122300110010100000123451234567812\",\n \"fechaAutorizacion\": \"2026-02-05 15:30:00\",\n \"xml\": \"http:\/\/api.midominio.com\/documents\/xml\/...\",\n \"pdf\": \"http:\/\/api.midominio.com\/documents\/pdf\/...\"\n }\n}", "name": "" }, { "header": [], "code": 422, "body": "{\n \"success\": false,\n \"message\": \"Error de validaci\u00f3n\",\n \"errors\": {\n \"dataVenta.numeroDocumento\": [\"El formato es inv\u00e1lido\"]\n }\n}", "name": "" } ] }, { "name": "Crear Nota de Cr\u00e9dito", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v2\/nota-credito", "query": [], "raw": "{{baseUrl}}\/api\/v2\/nota-credito" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"incluirDocumentos\":true,\"dataEmpresa\":{\"ambiente\":1,\"emision\":16,\"razonSocial\":\"n\",\"nombreComercial\":\"g\",\"ruc\":\"zmiyvdljnikhw\",\"direccion\":\"a\",\"obligadoContabilidad\":\"N\",\"agenteRetenedor\":\"S\",\"resolucionAgenteRetenedor\":\"architecto\",\"contribuyenteRimpe\":\"N\",\"contribuyenteEspecial\":\"N\",\"idContribuyenteEspecial\":\"architecto\",\"email\":\"zbailey@example.net\"},\"dataInfo\":{\"numeroDocumento\":\"425-593-142326822\",\"direccionBodega\":\"m\",\"fecha\":\"11-10-2026\",\"email1\":\"marquardt.noah@example.com\",\"email2\":\"emelie.baumbach@example.net\",\"email3\":\"ferne52@example.com\",\"codigoCliente\":\"architecto\",\"direccion\":\"n\",\"telefono\":\"architecto\",\"idTipoIdentificacion\":4,\"razonSocial\":\"n\",\"identificacion\":\"gzmiyvdljnikhway\",\"subtotal\":62,\"descuento\":54,\"baseGravableIva\":38,\"baseNoGravableIva\":50,\"montoIva\":72,\"montoNeto\":61,\"moneda\":\"architecto\",\"clave\":\"ngzmiyvdljnikhwaykcmyuwpwlvqwrsitcpscqldzsnrwtujw\",\"codDocModificado\":\"architecto\",\"numDocModificado\":\"425-593-142326822\",\"motivo\":\"m\",\"fechaEmisionDocSustento\":\"11-10-2026\"},\"dataTipoImpuesto\":{\"codigoSriAts\":\"architecto\",\"codigoSriDocumentoElectronico\":\"architecto\",\"porcentaje\":4326.41688},\"dataTipoImpuesto_0\":{\"codigoSriAts\":\"architecto\",\"codigoSriDocumentoElectronico\":\"architecto\",\"porcentaje\":4326.41688},\"dataPago\":[{\"codigoSriDocumentoElectronico\":\"architecto\",\"monto\":39,\"cantidadDias\":84}],\"dataItem\":[{\"codigoPrincipal\":\"z\",\"codigoAuxiliar\":\"m\",\"descripcionProducto\":\"i\",\"notaProducto\":\"architecto\",\"cantidad\":39,\"precioUnitario\":84,\"subtotalProducto\":12,\"descuentoProducto\":77,\"montoIvaProducto\":8}],\"dataItemAdicional\":[{\"campo\":\"architecto\"}],\"dataInfoAdicional\":[{\"campo\":\"architecto\",\"contenido\":\"architecto\"}]}" }, "description": "Env\u00eda una nota de cr\u00e9dito para su procesamiento s\u00edncrono." }, "response": [ { "header": [], "code": 200, "body": "{\n \"success\": true,\n \"message\": \"COMPROBANTE AUTORIZADO\"\n}", "name": "" } ] }, { "name": "Crear Factura As\u00edncrona (Background)", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v2\/factura\/async", "query": [], "raw": "{{baseUrl}}\/api\/v2\/factura\/async" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"incluirDocumentos\":true,\"dataEmpresa\":{\"ambiente\":2,\"emision\":16,\"razonSocial\":\"n\",\"nombreComercial\":\"g\",\"ruc\":\"zmiyvdljnikhw\",\"direccion\":\"a\",\"obligadoContabilidad\":\"N\",\"agenteRetenedor\":\"N\",\"resolucionAgenteRetenedor\":\"architecto\",\"contribuyenteRimpe\":\"N\",\"contribuyenteEspecial\":\"N\",\"idContribuyenteEspecial\":\"architecto\",\"email\":\"zbailey@example.net\"},\"dataVenta\":{\"numeroDocumento\":\"425-593-142326822\",\"direccionBodega\":\"m\",\"fecha\":\"11-10-2026\",\"email1\":\"marquardt.noah@example.com\",\"email2\":\"emelie.baumbach@example.net\",\"email3\":\"ferne52@example.com\",\"codigoCliente\":\"architecto\",\"direccion\":\"n\",\"telefono\":\"architecto\",\"idTipoIdentificacion\":4,\"razonSocial\":\"n\",\"identificacion\":\"gzmiyvdljnikhway\",\"subtotal\":62,\"descuento\":54,\"baseGravableIva\":38,\"baseNoGravableIva\":50,\"montoIva\":72,\"montoRecargo\":61,\"flete\":67,\"montoNeto\":61,\"moneda\":\"architecto\",\"clave\":\"ngzmiyvdljnikhwaykcmyuwpwlvqwrsitcpscqldzsnrwtujw\"},\"dataTipoImpuesto\":{\"codigoSriAts\":\"architecto\",\"codigoSriDocumentoElectronico\":\"architecto\",\"porcentaje\":4326.41688},\"dataTipoImpuesto_0\":{\"codigoSriAts\":\"architecto\",\"codigoSriDocumentoElectronico\":\"architecto\",\"porcentaje\":4326.41688},\"dataPago\":[{\"codigoSriDocumentoElectronico\":\"architecto\",\"monto\":39,\"cantidadDias\":84}],\"dataItem\":[{\"codigoPrincipal\":\"z\",\"codigoAuxiliar\":\"m\",\"descripcionProducto\":\"i\",\"notaProducto\":\"architecto\",\"cantidad\":39,\"precioUnitario\":84,\"subtotalProducto\":12,\"descuentoProducto\":77,\"montoIvaProducto\":8}],\"dataItemAdicional\":[{\"campo\":\"architecto\"}],\"dataInfoAdicional\":[{\"campo\":\"architecto\",\"contenido\":\"architecto\"}]}" }, "description": "Encola una factura para su procesamiento en segundo plano. Ideal para alta concurrencia.\nRetorna inmediatamente con estado \"ENCOLADO\"." }, "response": [ { "header": [], "code": 200, "body": "{\n \"success\": true,\n \"message\": \"Documento encolado exitosamente\",\n \"data\": {\n \"status\": \"ENCOLADO\",\n \"access_key\": \"0502202601179001122300110010100000123451234567812\"\n }\n}", "name": "" } ] }, { "name": "Crear Nota de Cr\u00e9dito As\u00edncrona", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v2\/nota-credito\/async", "query": [], "raw": "{{baseUrl}}\/api\/v2\/nota-credito\/async" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"incluirDocumentos\":false,\"dataEmpresa\":{\"ambiente\":2,\"emision\":16,\"razonSocial\":\"n\",\"nombreComercial\":\"g\",\"ruc\":\"zmiyvdljnikhw\",\"direccion\":\"a\",\"obligadoContabilidad\":\"S\",\"agenteRetenedor\":\"N\",\"resolucionAgenteRetenedor\":\"architecto\",\"contribuyenteRimpe\":\"S\",\"contribuyenteEspecial\":\"S\",\"idContribuyenteEspecial\":\"architecto\",\"email\":\"zbailey@example.net\"},\"dataInfo\":{\"numeroDocumento\":\"425-593-142326822\",\"direccionBodega\":\"m\",\"fecha\":\"11-10-2026\",\"email1\":\"marquardt.noah@example.com\",\"email2\":\"emelie.baumbach@example.net\",\"email3\":\"ferne52@example.com\",\"codigoCliente\":\"architecto\",\"direccion\":\"n\",\"telefono\":\"architecto\",\"idTipoIdentificacion\":7,\"razonSocial\":\"n\",\"identificacion\":\"gzmiyvdljnikhway\",\"subtotal\":62,\"descuento\":54,\"baseGravableIva\":38,\"baseNoGravableIva\":50,\"montoIva\":72,\"montoNeto\":61,\"moneda\":\"architecto\",\"clave\":\"ngzmiyvdljnikhwaykcmyuwpwlvqwrsitcpscqldzsnrwtujw\",\"codDocModificado\":\"architecto\",\"numDocModificado\":\"425-593-142326822\",\"motivo\":\"m\",\"fechaEmisionDocSustento\":\"11-10-2026\"},\"dataTipoImpuesto\":{\"codigoSriAts\":\"architecto\",\"codigoSriDocumentoElectronico\":\"architecto\",\"porcentaje\":4326.41688},\"dataTipoImpuesto_0\":{\"codigoSriAts\":\"architecto\",\"codigoSriDocumentoElectronico\":\"architecto\",\"porcentaje\":4326.41688},\"dataPago\":[{\"codigoSriDocumentoElectronico\":\"architecto\",\"monto\":39,\"cantidadDias\":84}],\"dataItem\":[{\"codigoPrincipal\":\"z\",\"codigoAuxiliar\":\"m\",\"descripcionProducto\":\"i\",\"notaProducto\":\"architecto\",\"cantidad\":39,\"precioUnitario\":84,\"subtotalProducto\":12,\"descuentoProducto\":77,\"montoIvaProducto\":8}],\"dataItemAdicional\":[{\"campo\":\"architecto\"}],\"dataInfoAdicional\":[{\"campo\":\"architecto\",\"contenido\":\"architecto\"}]}" }, "description": "" }, "response": [] }, { "name": "Consultar estado de un documento por clave de acceso", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v2\/documento\/:accessKey", "query": [], "raw": "{{baseUrl}}\/api\/v2\/documento\/:accessKey", "variable": [ { "id": "accessKey", "key": "accessKey", "value": "architecto", "description": "" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [] }, { "name": "Verificar si un documento existe (idempotencia)", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v2\/documento\/exists", "query": [], "raw": "{{baseUrl}}\/api\/v2\/documento\/exists" }, "method": "POST", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [] }, { "name": "Recuperar documentos (XML autorizado + RIDE) por clave de acceso", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v2\/documento\/:accessKey\/archivos", "query": [], "raw": "{{baseUrl}}\/api\/v2\/documento\/:accessKey\/archivos", "variable": [ { "id": "accessKey", "key": "accessKey", "value": "architecto", "description": "" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Pensado para sistemas que emiten con la bandera `incluirDocumentos: false`\ny descargan los documentos bajo demanda usando la clave de acceso\n(que coincide con el n\u00famero de autorizaci\u00f3n en el esquema offline del SRI).\n\nSi los archivos no existen localmente, se intentan recuperar autom\u00e1ticamente\ndesde el SRI. El XML y el RIDE se devuelven comprimidos con gzip y codificados\nen base64." }, "response": [ { "header": [], "code": 200, "body": "{\n \"success\": true,\n \"message\": \"Documento obtenido exitosamente\",\n \"data\": {\n \"access_key\": \"0502202601179001122300110010100000123451234567812\",\n \"status\": \"AUTORIZADO\",\n \"document_number\": \"001-010-000012345\",\n \"authorization_number\": \"0502202601179001122300110010100000123451234567812\",\n \"authorization_date\": \"2026-02-05 15:30:00\",\n \"xml_authorized\": \"H4sIAAAA... (base64 de gzip)\",\n \"pdf_ride\": \"H4sIAAAA... (base64 de gzip)\",\n \"recovered_from_sri\": false\n }\n}", "name": "" }, { "header": [], "code": 404, "body": "{\n \"success\": false,\n \"message\": \"No se pudo obtener el documento\"\n}", "name": "" } ] }, { "name": "Descargar XML autorizado (archivo directo) por clave de acceso", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v2\/documento\/:accessKey\/xml", "query": [], "raw": "{{baseUrl}}\/api\/v2\/documento\/:accessKey\/xml", "variable": [ { "id": "accessKey", "key": "accessKey", "value": "architecto", "description": "" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Devuelve el XML como archivo descargable (Content-Disposition: attachment).\nSirve como \"URL de descarga\" para enlazar directamente desde el sistema externo.\nSi no existe localmente, intenta recuperarlo del SRI." }, "response": [] }, { "name": "Descargar RIDE (PDF) por clave de acceso", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v2\/documento\/:accessKey\/pdf", "query": [], "raw": "{{baseUrl}}\/api\/v2\/documento\/:accessKey\/pdf", "variable": [ { "id": "accessKey", "key": "accessKey", "value": "architecto", "description": "" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Devuelve el RIDE como archivo PDF descargable. Si no existe localmente,\nintenta recuperarlo\/regenerarlo a partir de los datos del SRI." }, "response": [] } ] }, { "name": "Gesti\u00f3n de Empresas", "description": "Endpoints para la administraci\u00f3n de empresas emisoras.", "item": [ { "name": "Listar empresas seg\u00fan permisos del usuario\n- Admins: ven todas las empresas\n- Usuarios normales: solo ven las empresas asignadas a su RUC", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/business", "query": [], "raw": "{{baseUrl}}\/api\/business" }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [] }, { "name": "Registrar nueva empresa", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/business", "query": [], "raw": "{{baseUrl}}\/api\/business" }, "method": "POST", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Permite a un administrador registrar una nueva empresa emisora.\nRequiere firma digital (.p12) y logo opcional." }, "response": [ { "header": [], "code": 201, "body": "{\n \"success\": true,\n \"message\": \"Empresa registrada exitosamente\",\n \"data\": {\n \"id\": 1,\n \"name\": \"MI EMPRESA S.A.\",\n \"ruc\": \"1790011223001\"\n }\n}", "name": "" } ] }, { "name": "Obtener una empresa espec\u00edfica\n- Admins: pueden ver cualquier empresa\n- Usuarios normales: solo pueden ver su empresa asignada", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/business\/:id", "query": [], "raw": "{{baseUrl}}\/api\/business\/:id", "variable": [ { "id": "id", "key": "id", "value": "architecto", "description": "The ID of the business." } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [] }, { "name": "Buscar empresa por RUC\n- Admins: pueden buscar cualquier RUC\n- Usuarios normales: solo pueden buscar su RUC asignado", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/business\/ruc\/:ruc", "query": [], "raw": "{{baseUrl}}\/api\/business\/ruc\/:ruc", "variable": [ { "id": "ruc", "key": "ruc", "value": "architecto", "description": "The ruc." } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [] }, { "name": "Actualizar empresa existente\n- Admins: pueden actualizar cualquier empresa\n- Usuarios normales: solo pueden actualizar su empresa asignada", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/business\/:id", "query": [], "raw": "{{baseUrl}}\/api\/business\/:id", "variable": [ { "id": "id", "key": "id", "value": "architecto", "description": "The ID of the business." } ] }, "method": "POST", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [] }, { "name": "Eliminar empresa (soft delete)\nSolo administradores pueden eliminar empresas", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/business\/:id", "query": [], "raw": "{{baseUrl}}\/api\/business\/:id", "variable": [ { "id": "id", "key": "id", "value": "architecto", "description": "The ID of the business." } ] }, "method": "DELETE", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [] }, { "name": "Obtener informaci\u00f3n del certificado digital de una empresa\n- Admins: pueden ver certificado de cualquier empresa\n- Usuarios normales: solo pueden ver certificado de su empresa", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/business\/:id\/certificate", "query": [], "raw": "{{baseUrl}}\/api\/business\/:id\/certificate", "variable": [ { "id": "id", "key": "id", "value": "architecto", "description": "The ID of the business." } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [] } ] }, { "name": "Otros Endpoints", "description": "", "item": [ { "name": "GET api\/user", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/user", "query": [], "raw": "{{baseUrl}}\/api\/user" }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "POST api\/liquidacion\/create", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/liquidacion\/create", "query": [], "raw": "{{baseUrl}}\/api\/liquidacion\/create" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"dataEmpresa\":{\"ambiente\":16,\"emision\":16,\"razonSocial\":\"architecto\",\"nombreComercial\":\"architecto\",\"ruc\":\"architecto\",\"direccion\":\"architecto\",\"obligadoContabilidad\":\"architecto\",\"agenteRetenedor\":\"architecto\",\"resolucionAgenteRetenedor\":\"architecto\",\"contribuyenteRimpe\":\"architecto\",\"contribuyenteEspecial\":\"architecto\",\"email\":\"zbailey@example.net\"},\"dataInfo\":{\"numeroDocumento\":\"architecto\",\"direccionBodega\":\"architecto\",\"fecha\":\"11-10-2026\",\"email1\":\"zbailey@example.net\",\"email2\":\"gulgowski.asia@example.com\",\"email3\":\"idickens@example.org\",\"codigoCliente\":\"architecto\",\"direccion\":\"architecto\",\"telefono\":\"architecto\",\"idTipoIdentificacion\":\"architecto\",\"razonSocial\":\"architecto\",\"identificacion\":\"architecto\",\"subtotal\":4326.41688,\"descuento\":4326.41688,\"baseGravableIva\":4326.41688,\"baseNoGravableIva\":4326.41688,\"montoIva\":4326.41688,\"montoNeto\":4326.41688,\"moneda\":\"architecto\",\"clave\":\"architecto\"},\"dataTipoImpuesto\":{\"codigoSriAts\":\"architecto\",\"codigoSriDocumentoElectronico\":\"architecto\",\"porcentaje\":4326.41688},\"dataTipoImpuesto_0\":{\"codigoSriAts\":\"architecto\",\"codigoSriDocumentoElectronico\":\"architecto\",\"porcentaje\":4326.41688},\"dataPago\":[{\"codigoSriDocumentoElectronico\":\"architecto\",\"monto\":4326.41688,\"cantidadDias\":4326.41688}],\"dataItem\":[{\"codigoPrincipal\":\"architecto\",\"codigoAuxiliar\":\"architecto\",\"descripcionProducto\":\"architecto\",\"notaProducto\":\"architecto\",\"cantidad\":4326.41688,\"precioUnitario\":4326.41688,\"subtotalProducto\":4326.41688,\"descuentoProducto\":4326.41688,\"montoIvaProducto\":4326.41688}],\"dataItemAdicional\":[{\"campo\":\"architecto\"}],\"dataInfoAdicional\":[{\"campo\":\"architecto\",\"contenido\":\"architecto\"}]}" }, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "POST api\/notacredito\/create", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/notacredito\/create", "query": [], "raw": "{{baseUrl}}\/api\/notacredito\/create" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"dataEmpresa\":{\"ambiente\":16,\"emision\":16,\"razonSocial\":\"architecto\",\"nombreComercial\":\"architecto\",\"ruc\":\"architecto\",\"direccion\":\"architecto\",\"obligadoContabilidad\":\"architecto\",\"agenteRetenedor\":\"architecto\",\"resolucionAgenteRetenedor\":\"architecto\",\"contribuyenteRimpe\":\"architecto\",\"contribuyenteEspecial\":\"architecto\",\"email\":\"zbailey@example.net\"},\"dataInfo\":{\"numeroDocumento\":\"architecto\",\"direccionBodega\":\"architecto\",\"fecha\":\"11-10-2026\",\"email1\":\"zbailey@example.net\",\"email2\":\"gulgowski.asia@example.com\",\"email3\":\"idickens@example.org\",\"codigoCliente\":\"architecto\",\"direccion\":\"architecto\",\"telefono\":\"architecto\",\"idTipoIdentificacion\":\"architecto\",\"razonSocial\":\"architecto\",\"identificacion\":\"architecto\",\"subtotal\":4326.41688,\"descuento\":4326.41688,\"baseGravableIva\":4326.41688,\"baseNoGravableIva\":4326.41688,\"montoIva\":4326.41688,\"montoNeto\":4326.41688,\"moneda\":\"architecto\",\"clave\":\"architecto\",\"codDocModificado\":\"architecto\",\"numDocModificado\":\"architecto\",\"motivo\":\"architecto\",\"fechaEmisionDocSustento\":\"11-10-2026\"},\"dataTipoImpuesto\":{\"codigoSriAts\":\"architecto\",\"codigoSriDocumentoElectronico\":\"architecto\",\"porcentaje\":4326.41688},\"dataTipoImpuesto_0\":{\"codigoSriAts\":\"architecto\",\"codigoSriDocumentoElectronico\":\"architecto\",\"porcentaje\":4326.41688},\"dataPago\":[{\"codigoSriDocumentoElectronico\":\"architecto\",\"monto\":4326.41688,\"cantidadDias\":4326.41688}],\"dataItem\":[{\"codigoPrincipal\":\"architecto\",\"codigoAuxiliar\":\"architecto\",\"descripcionProducto\":\"architecto\",\"notaProducto\":\"architecto\",\"cantidad\":4326.41688,\"precioUnitario\":4326.41688,\"subtotalProducto\":4326.41688,\"descuentoProducto\":4326.41688,\"montoIvaProducto\":4326.41688}],\"dataItemAdicional\":[{\"campo\":\"architecto\"}],\"dataInfoAdicional\":[{\"campo\":\"architecto\",\"contenido\":\"architecto\"}]}" }, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "POST api\/notadebito\/create", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/notadebito\/create", "query": [], "raw": "{{baseUrl}}\/api\/notadebito\/create" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"dataEmpresa\":{\"ambiente\":16,\"emision\":16,\"razonSocial\":\"architecto\",\"nombreComercial\":\"architecto\",\"ruc\":\"architecto\",\"direccion\":\"architecto\",\"obligadoContabilidad\":\"architecto\",\"agenteRetenedor\":\"architecto\",\"resolucionAgenteRetenedor\":\"architecto\",\"contribuyenteRimpe\":\"architecto\",\"contribuyenteEspecial\":\"architecto\",\"email\":\"zbailey@example.net\"},\"dataInfo\":{\"numeroDocumento\":\"architecto\",\"direccionBodega\":\"architecto\",\"fecha\":\"11-10-2026\",\"email1\":\"zbailey@example.net\",\"email2\":\"gulgowski.asia@example.com\",\"email3\":\"idickens@example.org\",\"codigoCliente\":\"architecto\",\"direccion\":\"architecto\",\"telefono\":\"architecto\",\"idTipoIdentificacion\":\"architecto\",\"razonSocial\":\"architecto\",\"identificacion\":\"architecto\",\"subtotal\":4326.41688,\"descuento\":4326.41688,\"baseGravableIva\":4326.41688,\"baseNoGravableIva\":4326.41688,\"montoIva\":4326.41688,\"montoNeto\":4326.41688,\"moneda\":\"architecto\",\"clave\":\"architecto\",\"codDocModificado\":\"architecto\",\"numDocModificado\":\"architecto\",\"motivo\":\"architecto\",\"fechaEmisionDocSustento\":\"11-10-2026\"},\"dataTipoImpuesto\":{\"codigoSriAts\":\"architecto\",\"codigoSriDocumentoElectronico\":\"architecto\",\"porcentaje\":4326.41688},\"dataTipoImpuesto_0\":{\"codigoSriAts\":\"architecto\",\"codigoSriDocumentoElectronico\":\"architecto\",\"porcentaje\":4326.41688},\"dataPago\":[{\"codigoSriDocumentoElectronico\":\"architecto\",\"monto\":4326.41688,\"cantidadDias\":4326.41688}],\"dataDetalle\":[{\"razon\":\"architecto\",\"valor\":4326.41688}],\"dataItemAdicional\":[{\"campo\":\"architecto\"}],\"dataInfoAdicional\":[{\"campo\":\"architecto\",\"contenido\":\"architecto\"}]}" }, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "POST api\/guiaremision\/create", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/guiaremision\/create", "query": [], "raw": "{{baseUrl}}\/api\/guiaremision\/create" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"dataEmpresa\":{\"ambiente\":16,\"emision\":16,\"razonSocial\":\"architecto\",\"nombreComercial\":\"architecto\",\"ruc\":\"architecto\",\"direccion\":\"architecto\",\"obligadoContabilidad\":\"architecto\",\"agenteRetenedor\":\"architecto\",\"resolucionAgenteRetenedor\":\"architecto\",\"contribuyenteRimpe\":\"architecto\",\"contribuyenteEspecial\":\"architecto\",\"email\":\"zbailey@example.net\"},\"dataInfo\":{\"numeroDocumento\":\"architecto\",\"direccionBodega\":\"architecto\",\"fecha\":\"11-10-2026\",\"email1\":\"zbailey@example.net\",\"email2\":\"gulgowski.asia@example.com\",\"email3\":\"idickens@example.org\",\"codigoCliente\":\"architecto\",\"direccion\":\"architecto\",\"telefono\":\"architecto\",\"idTipoIdentificacion\":\"architecto\",\"razonSocial\":\"architecto\",\"identificacion\":\"architecto\",\"moneda\":\"architecto\",\"clave\":\"architecto\",\"codDocModificado\":\"architecto\",\"numDocModificado\":\"architecto\",\"motivo\":\"architecto\",\"fechaEmisionDocSustento\":\"11-10-2026\"},\"dataItem\":[{\"codigoPrincipal\":\"architecto\",\"codigoAuxiliar\":\"architecto\",\"descripcionProducto\":\"architecto\",\"notaProducto\":\"architecto\",\"cantidad\":4326.41688,\"precioUnitario\":4326.41688,\"subtotalProducto\":4326.41688,\"descuentoProducto\":4326.41688,\"montoIvaProducto\":4326.41688}],\"dataTransportista\":{\"razonSocialTransportista\":\"architecto\",\"tipoIdentificacionTransportista\":\"architecto\",\"rucTransportista\":\"architecto\",\"dirPartida\":\"architecto\",\"fechaIniTransporte\":\"11-10-2026\",\"fechaFinTransporte\":\"11-10-2026\",\"placa\":\"architecto\"},\"dataItemAdicional\":[{\"campo\":\"architecto\"}],\"dataInfoAdicional\":[{\"campo\":\"architecto\",\"contenido\":\"architecto\"}]}" }, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "POST api\/retencion\/create", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/retencion\/create", "query": [], "raw": "{{baseUrl}}\/api\/retencion\/create" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"dataEmpresa\":{\"ambiente\":16,\"emision\":16,\"razonSocial\":\"architecto\",\"nombreComercial\":\"architecto\",\"ruc\":\"architecto\",\"direccion\":\"architecto\",\"obligadoContabilidad\":\"architecto\",\"agenteRetenedor\":\"architecto\",\"resolucionAgenteRetenedor\":\"architecto\",\"contribuyenteRimpe\":\"architecto\",\"contribuyenteEspecial\":\"architecto\",\"email\":\"zbailey@example.net\"},\"dataInfo\":{\"numeroDocumento\":\"architecto\",\"direccionBodega\":\"architecto\",\"fecha\":\"11-10-2026\",\"email1\":\"zbailey@example.net\",\"email2\":\"gulgowski.asia@example.com\",\"email3\":\"idickens@example.org\",\"codigoCliente\":\"architecto\",\"direccion\":\"architecto\",\"telefono\":\"architecto\",\"idTipoIdentificacion\":\"architecto\",\"razonSocial\":\"architecto\",\"identificacion\":\"architecto\",\"subtotal\":4326.41688,\"descuento\":4326.41688,\"baseGravableIva\":4326.41688,\"baseNoGravableIva\":4326.41688,\"montoIva\":4326.41688,\"montoNeto\":4326.41688,\"moneda\":\"architecto\",\"clave\":\"architecto\",\"parteRel\":\"architecto\",\"periodoFiscal\":\"architecto\",\"codSustento\":\"architecto\",\"codDocSustento\":\"architecto\",\"numDocSustento\":\"architecto\",\"fechaEmisionDocSustento\":\"11-10-2026\",\"fechaRegistroContable\":\"11-10-2026\",\"numAutDocSustento\":\"architecto\",\"pagoLocExt\":\"architecto\"},\"dataRetencion\":[{\"codigo\":16,\"codigoRetencion\":16,\"baseImponible\":4326.41688,\"porcentajeRetener\":4326.41688,\"valorRetenido\":4326.41688}],\"dataTipoImpuesto\":{\"codigoSriAts\":\"architecto\",\"codigoSriDocumentoElectronico\":\"architecto\",\"porcentaje\":4326.41688},\"dataTipoImpuesto_0\":{\"codigoSriAts\":\"architecto\",\"codigoSriDocumentoElectronico\":\"architecto\",\"porcentaje\":4326.41688},\"dataPago\":[{\"codigoSriDocumentoElectronico\":\"architecto\",\"monto\":4326.41688,\"cantidadDias\":4326.41688}],\"dataItemAdicional\":[{\"campo\":\"architecto\"}],\"dataInfoAdicional\":[{\"campo\":\"architecto\",\"contenido\":\"architecto\"}]}" }, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "POST api\/verififacion-documento", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/verififacion-documento", "query": [], "raw": "{{baseUrl}}\/api\/verififacion-documento" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"claveAcceso\":\"architecto\",\"ruc\":\"architecto\",\"documento\":\"architecto\",\"ambiente\":16,\"fecha\":\"11-10-2026\"}" }, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "GET api\/generate-ride\/{claveAcceso}\/{ruc}\/{anio}\/{mes}", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/generate-ride\/:claveAcceso\/:ruc\/:anio\/:mes", "query": [], "raw": "{{baseUrl}}\/api\/generate-ride\/:claveAcceso\/:ruc\/:anio\/:mes", "variable": [ { "id": "claveAcceso", "key": "claveAcceso", "value": "architecto", "description": "" }, { "id": "ruc", "key": "ruc", "value": "architecto", "description": "" }, { "id": "anio", "key": "anio", "value": "architecto", "description": "" }, { "id": "mes", "key": "mes", "value": "architecto", "description": "" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Reenv\u00eda el correo electr\u00f3nico de un documento ya procesado", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/documents\/retry-email", "query": [], "raw": "{{baseUrl}}\/api\/documents\/retry-email" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"clave_acceso\":\"b\",\"tipo_documento\":\"guiaremision\",\"ruc\":\"ng\",\"email\":\"rowan.gulgowski@example.com\",\"cc_emails\":[\"jdach@example.org\"]}" }, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Reintentar autorizaci\u00f3n de un documento espec\u00edfico", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/documents\/retry-authorization", "query": [], "raw": "{{baseUrl}}\/api\/documents\/retry-authorization" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"access_key\":\"bngzmiyvdljnikhwaykcmyuwpwlvqwrsitcpscqldzsnrwtuj\"}" }, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Habilitar reintentos autom\u00e1ticos para un documento", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/documents\/enable-auto-retry", "query": [], "raw": "{{baseUrl}}\/api\/documents\/enable-auto-retry" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"access_key\":\"bngzmiyvdljnikhwaykcmyuwpwlvqwrsitcpscqldzsnrwtuj\"}" }, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Deshabilitar reintentos autom\u00e1ticos para un documento", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/documents\/disable-auto-retry", "query": [], "raw": "{{baseUrl}}\/api\/documents\/disable-auto-retry" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"access_key\":\"bngzmiyvdljnikhwaykcmyuwpwlvqwrsitcpscqldzsnrwtuj\"}" }, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Obtener estad\u00edsticas de reintentos", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/documents\/retry-statistics", "query": [], "raw": "{{baseUrl}}\/api\/documents\/retry-statistics" }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Listar documentos pendientes de reintento", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/documents\/pending-retries", "query": [], "raw": "{{baseUrl}}\/api\/documents\/pending-retries" }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Obtener XML autorizado y RIDE (PDF) de un documento.", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/documents\/retrieve\/:accessKey", "query": [], "raw": "{{baseUrl}}\/api\/documents\/retrieve\/:accessKey", "variable": [ { "id": "accessKey", "key": "accessKey", "value": "architecto", "description": "" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Si los archivos no existen localmente, consulta al SRI y los recupera autom\u00e1ticamente.\nDise\u00f1ado para que el sistema externo obtenga los documentos despu\u00e9s de la emisi\u00f3n.", "auth": { "type": "noauth" } }, "response": [ { "header": [], "code": 200, "body": "{\n \"success\": true,\n \"data\": {\n \"access_key\": \"1703202601...\",\n \"status\": \"AUTORIZADO\",\n \"document_number\": \"001-001-000000117\",\n \"authorization_number\": \"1703202601...\",\n \"authorization_date\": \"2026-03-17T10:00:00\",\n \"xml_authorized\": \"base64+gzip del XML autorizado\",\n \"pdf_ride\": \"base64+gzip del PDF RIDE\",\n \"recovered_from_sri\": false\n },\n \"message\": \"Documento obtenido exitosamente\"\n}", "name": "" } ] }, { "name": "Recuperar en batch m\u00faltiples documentos desde el SRI.", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/documents\/recover-batch", "query": [], "raw": "{{baseUrl}}\/api\/documents\/recover-batch" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"access_keys\":[\"bngzmiyvdljnikhwaykcmyuwpwlvqwrsitcpscqldzsnrwtuj\"],\"send_email\":true}" }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "header": [], "code": 200, "body": "{\n \"success\": true,\n \"data\": {\n \"total\": 12,\n \"recovered\": 10,\n \"failed\": 2,\n \"results\": [...]\n }\n}", "name": "" } ] }, { "name": "Endpoint para verificar el estado de los servicios del SRI.", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/sri-status", "query": [], "raw": "{{baseUrl}}\/api\/sri-status" }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Acepta un par\u00e1metro 'ambiente' ('prueba' o 'produccion').", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Registrar un nuevo usuario en el sistema", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/register", "query": [], "raw": "{{baseUrl}}\/api\/register" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"b\",\"email\":\"zbailey@example.net\",\"password\":\"|]|{+-\",\"password_confirmation\":\"architecto\"}" }, "description": "Este endpoint requiere un token maestro de aplicaci\u00f3n para autorizar el registro.\nUna vez registrado, el usuario puede iniciar sesi\u00f3n y crear su empresa usando\nlos endpoints existentes.", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Verificar si un email ya est\u00e1 registrado", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/register\/check-email", "query": [], "raw": "{{baseUrl}}\/api\/register\/check-email" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"email\":\"gbailey@example.net\"}" }, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Verificar si un RUC ya est\u00e1 registrado", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/register\/check-ruc", "query": [], "raw": "{{baseUrl}}\/api\/register\/check-ruc" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"ruc\":\"bngzmiyvdljni\"}" }, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Obtener informaci\u00f3n p\u00fablica de una empresa (para verificaci\u00f3n)", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/register\/business\/:ruc", "query": [], "raw": "{{baseUrl}}\/api\/register\/business\/:ruc", "variable": [ { "id": "ruc", "key": "ruc", "value": "architecto", "description": "" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Listar todas las empresas con informaci\u00f3n de tokens", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/admin\/tokens", "query": [], "raw": "{{baseUrl}}\/api\/admin\/tokens" }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Generar token de API para una empresa\nSolo administradores pueden generar tokens", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/admin\/tokens\/generate", "query": [], "raw": "{{baseUrl}}\/api\/admin\/tokens\/generate" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"ruc\":\"bngzmiyvdljni\"}" }, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Regenerar token de API para una empresa\nInvalida el token anterior", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/admin\/tokens\/regenerate", "query": [], "raw": "{{baseUrl}}\/api\/admin\/tokens\/regenerate" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"ruc\":\"bngzmiyvdljni\"}" }, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Revocar token de API de una empresa", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/admin\/tokens\/revoke", "query": [], "raw": "{{baseUrl}}\/api\/admin\/tokens\/revoke" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"ruc\":\"bngzmiyvdljni\"}" }, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Ver informaci\u00f3n del token de una empresa (sin mostrar el token)", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/admin\/tokens\/info", "query": [], "raw": "{{baseUrl}}\/api\/admin\/tokens\/info" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"ruc\":\"bngzmiyvdljni\"}" }, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Verificar el estado del certificado de una empresa por RUC\nEndpoint p\u00fablico para que las aplicaciones consulten diariamente", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/certificate\/status\/:ruc", "query": [], "raw": "{{baseUrl}}\/api\/certificate\/status\/:ruc", "variable": [ { "id": "ruc", "key": "ruc", "value": "architecto", "description": "" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Obtener informaci\u00f3n detallada del certificado (solo admin)", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/certificate\/details\/:ruc", "query": [], "raw": "{{baseUrl}}\/api\/certificate\/details\/:ruc", "variable": [ { "id": "ruc", "key": "ruc", "value": "architecto", "description": "" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Listar estado de certificados de todas las empresas (solo admin)", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/certificate\/all-status", "query": [], "raw": "{{baseUrl}}\/api\/certificate\/all-status" }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Verificar el estado del certificado usando API Token\nPara uso autenticado desde sistemas externos", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/my-certificate\/status", "query": [], "raw": "{{baseUrl}}\/api\/my-certificate\/status" }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Obtener informaci\u00f3n de mi empresa\nGET \/api\/my-business", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/my-business", "query": [], "raw": "{{baseUrl}}\/api\/my-business" }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Actualizar informaci\u00f3n b\u00e1sica de mi empresa\nPUT \/api\/my-business", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/my-business", "query": [], "raw": "{{baseUrl}}\/api\/my-business" }, "method": "PUT", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Actualizar logo de mi empresa\nPOST \/api\/my-business\/logo", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/my-business\/logo", "query": [], "raw": "{{baseUrl}}\/api\/my-business\/logo" }, "method": "POST", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Actualizar firma digital de mi empresa\nPOST \/api\/my-business\/signature", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/my-business\/signature", "query": [], "raw": "{{baseUrl}}\/api\/my-business\/signature" }, "method": "POST", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Obtener estado del certificado de mi empresa\nGET \/api\/my-business\/certificate", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/my-business\/certificate", "query": [], "raw": "{{baseUrl}}\/api\/my-business\/certificate" }, "method": "GET", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "POST api\/clave-acceso\/factura", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/clave-acceso\/factura", "query": [], "raw": "{{baseUrl}}\/api\/clave-acceso\/factura" }, "method": "POST", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "POST api\/clave-acceso\/nota-credito", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/clave-acceso\/nota-credito", "query": [], "raw": "{{baseUrl}}\/api\/clave-acceso\/nota-credito" }, "method": "POST", "header": [ { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] } ] } ], "auth": { "type": "bearer", "bearer": [ { "key": "Authorization", "type": "string" } ] } }