{ "item": [ { "name": "v1", "description": "", "item": [ { "name": "developer", "description": "Endpoints de Factuplan Developer API. Emite, firma, autoriza y gestiona comprobantes electrónicos desde tu propia aplicación usando tu API key.", "item": [ { "name": "invoices", "description": "Flujo completo de emisión (Modo A): crea el XML, fírmalo con tu certificado P12, autorízalo ante el SRI, genera el PDF (RIDE) y envía el correo al cliente automáticamente. También permite importar comprobantes ya autorizados por clave de acceso.", "item": [ { "id": "f443d90e-ed78-49d8-957e-df12a2254736", "name": "Emitir comprobante electrónico", "request": { "name": "Emitir comprobante electrónico", "description": { "content": "Modo A — flujo completo: crea el XML, lo firma con tu certificado P12, lo autoriza ante el SRI, genera el PDF (RIDE) y envía el correo al cliente automáticamente.", "type": "text/plain" }, "url": { "path": [ "v1", "developer", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-taxpayer-ruc", "value": "{{taxpayerRuc}}" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"customer\": {\n \"customerId\": \" (opcional)\",\n \"identificationType\": \"FINAL_CONSUMER\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"address\": \" (opcional)\",\n \"phone\": \" (opcional)\",\n \"saveToContacts\": \" (opcional)\"\n },\n \"items\": [\n {\n \"quantity\": \"\",\n \"productId\": \" (opcional)\",\n \"code\": \"\",\n \"auxiliaryCode\": \" (opcional)\",\n \"description\": \"\",\n \"unitPrice\": \"\",\n \"discount\": \" (opcional)\",\n \"taxType\": \"IVA_RATE (opcional: IVA_0|IVA_RATE|NOT_TAXABLE|EXEMPT)\",\n \"tax\": \"\",\n \"saveToProducts\": \" (opcional)\"\n },\n {\n \"quantity\": \"\",\n \"productId\": \" (opcional)\",\n \"code\": \"\",\n \"auxiliaryCode\": \" (opcional)\",\n \"description\": \"\",\n \"unitPrice\": \"\",\n \"discount\": \" (opcional)\",\n \"taxType\": \"IVA_RATE (opcional: IVA_0|IVA_RATE|NOT_TAXABLE|EXEMPT)\",\n \"tax\": \"\",\n \"saveToProducts\": \" (opcional)\"\n }\n ],\n \"emissionPointId\": \" (opcional)\",\n \"establishment\": \" (opcional)\",\n \"emissionPoint\": \" (opcional)\",\n \"additionalInfo\": {},\n \"sendEmail\": true\n \"payments\": [\n {\n \"method\": \"01 (SRI: 01, 15, 16, 17, 18, 19, 20, 21)\",\n \"amount\": \"\",\n \"term\": \"0 (opcional)\",\n \"timeUnit\": \"dias (opcional: dias|meses|anios)\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "303dbeaf-9bd1-45fb-85b1-6c9a02bf6aa9", "name": "Resource created successfully", "originalRequest": { "url": { "path": [ "v1", "developer", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"customer\": {\n \"customerId\": \" (opcional)\",\n \"identificationType\": \"FINAL_CONSUMER\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"address\": \" (opcional)\",\n \"phone\": \" (opcional)\",\n \"saveToContacts\": \" (opcional)\"\n },\n \"items\": [\n {\n \"quantity\": \"\",\n \"productId\": \" (opcional)\",\n \"code\": \"\",\n \"auxiliaryCode\": \" (opcional)\",\n \"description\": \"\",\n \"unitPrice\": \"\",\n \"discount\": \" (opcional)\",\n \"taxType\": \"IVA_RATE (opcional: IVA_0|IVA_RATE|NOT_TAXABLE|EXEMPT)\",\n \"tax\": \"\",\n \"saveToProducts\": \" (opcional)\"\n },\n {\n \"quantity\": \"\",\n \"productId\": \" (opcional)\",\n \"code\": \"\",\n \"auxiliaryCode\": \" (opcional)\",\n \"description\": \"\",\n \"unitPrice\": \"\",\n \"discount\": \" (opcional)\",\n \"taxType\": \"IVA_RATE (opcional: IVA_0|IVA_RATE|NOT_TAXABLE|EXEMPT)\",\n \"tax\": \"\",\n \"saveToProducts\": \" (opcional)\"\n }\n ],\n \"emissionPointId\": \" (opcional)\",\n \"establishment\": \" (opcional)\",\n \"emissionPoint\": \" (opcional)\",\n \"additionalInfo\": {},\n \"payments\": [\n {\n \"method\": \"01 (SRI: 01, 15, 16, 17, 18, 19, 20, 21)\",\n \"amount\": \"\",\n \"term\": \"0 (opcional)\",\n \"timeUnit\": \"dias (opcional: dias|meses|anios)\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"\",\n \"accessKey\": \"\",\n \"sequential\": \"\",\n \"status\": \"\",\n \"total\": \"\",\n \"source\": \"\",\n \"apiKeyId\": {}\n },\n \"meta\": {\n \"requestId\": \"\",\n \"timestamp\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "831b6f6c-e416-47b2-bd0d-463b07dc7b06", "name": "Validation error", "originalRequest": { "url": { "path": [ "v1", "developer", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"customer\": {\n \"customerId\": \" (opcional)\",\n \"identificationType\": \"FINAL_CONSUMER\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"address\": \" (opcional)\",\n \"phone\": \" (opcional)\",\n \"saveToContacts\": \" (opcional)\"\n },\n \"items\": [\n {\n \"quantity\": \"\",\n \"productId\": \" (opcional)\",\n \"code\": \"\",\n \"auxiliaryCode\": \" (opcional)\",\n \"description\": \"\",\n \"unitPrice\": \"\",\n \"discount\": \" (opcional)\",\n \"taxType\": \"IVA_RATE (opcional: IVA_0|IVA_RATE|NOT_TAXABLE|EXEMPT)\",\n \"tax\": \"\",\n \"saveToProducts\": \" (opcional)\"\n },\n {\n \"quantity\": \"\",\n \"productId\": \" (opcional)\",\n \"code\": \"\",\n \"auxiliaryCode\": \" (opcional)\",\n \"description\": \"\",\n \"unitPrice\": \"\",\n \"discount\": \" (opcional)\",\n \"taxType\": \"IVA_RATE (opcional: IVA_0|IVA_RATE|NOT_TAXABLE|EXEMPT)\",\n \"tax\": \"\",\n \"saveToProducts\": \" (opcional)\"\n }\n ],\n \"emissionPointId\": \" (opcional)\",\n \"establishment\": \" (opcional)\",\n \"emissionPoint\": \" (opcional)\",\n \"additionalInfo\": {},\n \"payments\": [\n {\n \"method\": \"01 (SRI: 01, 15, 16, 17, 18, 19, 20, 21)\",\n \"amount\": \"\",\n \"term\": \"0 (opcional)\",\n \"timeUnit\": \"dias (opcional: dias|meses|anios)\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "53bffdb0-2789-4d83-9477-fb44de470d29", "name": "Authentication required", "originalRequest": { "url": { "path": [ "v1", "developer", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"customer\": {\n \"customerId\": \" (opcional)\",\n \"identificationType\": \"FINAL_CONSUMER\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"address\": \" (opcional)\",\n \"phone\": \" (opcional)\",\n \"saveToContacts\": \" (opcional)\"\n },\n \"items\": [\n {\n \"quantity\": \"\",\n \"productId\": \" (opcional)\",\n \"code\": \"\",\n \"auxiliaryCode\": \" (opcional)\",\n \"description\": \"\",\n \"unitPrice\": \"\",\n \"discount\": \" (opcional)\",\n \"taxType\": \"IVA_RATE (opcional: IVA_0|IVA_RATE|NOT_TAXABLE|EXEMPT)\",\n \"tax\": \"\",\n \"saveToProducts\": \" (opcional)\"\n },\n {\n \"quantity\": \"\",\n \"productId\": \" (opcional)\",\n \"code\": \"\",\n \"auxiliaryCode\": \" (opcional)\",\n \"description\": \"\",\n \"unitPrice\": \"\",\n \"discount\": \" (opcional)\",\n \"taxType\": \"IVA_RATE (opcional: IVA_0|IVA_RATE|NOT_TAXABLE|EXEMPT)\",\n \"tax\": \"\",\n \"saveToProducts\": \" (opcional)\"\n }\n ],\n \"emissionPointId\": \" (opcional)\",\n \"establishment\": \" (opcional)\",\n \"emissionPoint\": \" (opcional)\",\n \"additionalInfo\": {},\n \"payments\": [\n {\n \"method\": \"01 (SRI: 01, 15, 16, 17, 18, 19, 20, 21)\",\n \"amount\": \"\",\n \"term\": \"0 (opcional)\",\n \"timeUnit\": \"dias (opcional: dias|meses|anios)\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cf14cae4-3cb8-48b0-a699-25869e9a9c44", "name": "Insufficient permissions", "originalRequest": { "url": { "path": [ "v1", "developer", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"customer\": {\n \"customerId\": \" (opcional)\",\n \"identificationType\": \"FINAL_CONSUMER\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"address\": \" (opcional)\",\n \"phone\": \" (opcional)\",\n \"saveToContacts\": \" (opcional)\"\n },\n \"items\": [\n {\n \"quantity\": \"\",\n \"productId\": \" (opcional)\",\n \"code\": \"\",\n \"auxiliaryCode\": \" (opcional)\",\n \"description\": \"\",\n \"unitPrice\": \"\",\n \"discount\": \" (opcional)\",\n \"taxType\": \"IVA_RATE (opcional: IVA_0|IVA_RATE|NOT_TAXABLE|EXEMPT)\",\n \"tax\": \"\",\n \"saveToProducts\": \" (opcional)\"\n },\n {\n \"quantity\": \"\",\n \"productId\": \" (opcional)\",\n \"code\": \"\",\n \"auxiliaryCode\": \" (opcional)\",\n \"description\": \"\",\n \"unitPrice\": \"\",\n \"discount\": \" (opcional)\",\n \"taxType\": \"IVA_RATE (opcional: IVA_0|IVA_RATE|NOT_TAXABLE|EXEMPT)\",\n \"tax\": \"\",\n \"saveToProducts\": \" (opcional)\"\n }\n ],\n \"emissionPointId\": \" (opcional)\",\n \"establishment\": \" (opcional)\",\n \"emissionPoint\": \" (opcional)\",\n \"additionalInfo\": {},\n \"payments\": [\n {\n \"method\": \"01 (SRI: 01, 15, 16, 17, 18, 19, 20, 21)\",\n \"amount\": \"\",\n \"term\": \"0 (opcional)\",\n \"timeUnit\": \"dias (opcional: dias|meses|anios)\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9b0ac9e5-914c-46fc-89ff-4939504ad55e", "name": "Resource not found", "originalRequest": { "url": { "path": [ "v1", "developer", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"customer\": {\n \"customerId\": \" (opcional)\",\n \"identificationType\": \"FINAL_CONSUMER\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"address\": \" (opcional)\",\n \"phone\": \" (opcional)\",\n \"saveToContacts\": \" (opcional)\"\n },\n \"items\": [\n {\n \"quantity\": \"\",\n \"productId\": \" (opcional)\",\n \"code\": \"\",\n \"auxiliaryCode\": \" (opcional)\",\n \"description\": \"\",\n \"unitPrice\": \"\",\n \"discount\": \" (opcional)\",\n \"taxType\": \"IVA_RATE (opcional: IVA_0|IVA_RATE|NOT_TAXABLE|EXEMPT)\",\n \"tax\": \"\",\n \"saveToProducts\": \" (opcional)\"\n },\n {\n \"quantity\": \"\",\n \"productId\": \" (opcional)\",\n \"code\": \"\",\n \"auxiliaryCode\": \" (opcional)\",\n \"description\": \"\",\n \"unitPrice\": \"\",\n \"discount\": \" (opcional)\",\n \"taxType\": \"IVA_RATE (opcional: IVA_0|IVA_RATE|NOT_TAXABLE|EXEMPT)\",\n \"tax\": \"\",\n \"saveToProducts\": \" (opcional)\"\n }\n ],\n \"emissionPointId\": \" (opcional)\",\n \"establishment\": \" (opcional)\",\n \"emissionPoint\": \" (opcional)\",\n \"additionalInfo\": {},\n \"payments\": [\n {\n \"method\": \"01 (SRI: 01, 15, 16, 17, 18, 19, 20, 21)\",\n \"amount\": \"\",\n \"term\": \"0 (opcional)\",\n \"timeUnit\": \"dias (opcional: dias|meses|anios)\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2f9d25c1-1ccc-4342-8792-2c456a2c4c68", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v1", "developer", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"customer\": {\n \"customerId\": \" (opcional)\",\n \"identificationType\": \"FINAL_CONSUMER\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"address\": \" (opcional)\",\n \"phone\": \" (opcional)\",\n \"saveToContacts\": \" (opcional)\"\n },\n \"items\": [\n {\n \"quantity\": \"\",\n \"productId\": \" (opcional)\",\n \"code\": \"\",\n \"auxiliaryCode\": \" (opcional)\",\n \"description\": \"\",\n \"unitPrice\": \"\",\n \"discount\": \" (opcional)\",\n \"taxType\": \"IVA_RATE (opcional: IVA_0|IVA_RATE|NOT_TAXABLE|EXEMPT)\",\n \"tax\": \"\",\n \"saveToProducts\": \" (opcional)\"\n },\n {\n \"quantity\": \"\",\n \"productId\": \" (opcional)\",\n \"code\": \"\",\n \"auxiliaryCode\": \" (opcional)\",\n \"description\": \"\",\n \"unitPrice\": \"\",\n \"discount\": \" (opcional)\",\n \"taxType\": \"IVA_RATE (opcional: IVA_0|IVA_RATE|NOT_TAXABLE|EXEMPT)\",\n \"tax\": \"\",\n \"saveToProducts\": \" (opcional)\"\n }\n ],\n \"emissionPointId\": \" (opcional)\",\n \"establishment\": \" (opcional)\",\n \"emissionPoint\": \" (opcional)\",\n \"additionalInfo\": {},\n \"payments\": [\n {\n \"method\": \"01 (SRI: 01, 15, 16, 17, 18, 19, 20, 21)\",\n \"amount\": \"\",\n \"term\": \"0 (opcional)\",\n \"timeUnit\": \"dias (opcional: dias|meses|anios)\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "import", "description": "Importa una factura ya autorizada por el SRI usando su clave de acceso de 49 dígitos. Útil para sincronizar comprobantes emitidos fuera de Factuplan.", "item": [ { "id": "ced58bd5-125b-4e01-9950-f55d58fbd344", "name": "Importar comprobante por clave de acceso", "request": { "name": "Importar comprobante por clave de acceso", "description": { "content": "Importa una factura ya autorizada por el SRI usando su clave de acceso de 49 dígitos. Útil para sincronizar comprobantes emitidos fuera de Factuplan.", "type": "text/plain" }, "url": { "path": [ "v1", "developer", "invoices", "import" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-taxpayer-ruc", "value": "{{taxpayerRuc}}" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accessKey\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "0201d969-f848-442b-ae1d-391f14de0d2c", "name": "Resource created successfully", "originalRequest": { "url": { "path": [ "v1", "developer", "invoices", "import" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accessKey\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"\",\n \"accessKey\": \"\",\n \"sequential\": \"\",\n \"status\": \"\",\n \"total\": \"\",\n \"source\": \"\",\n \"apiKeyId\": {}\n },\n \"meta\": {\n \"requestId\": \"\",\n \"timestamp\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2c358efc-8b7b-4c04-bdc0-efd2e9a95a2f", "name": "Validation error", "originalRequest": { "url": { "path": [ "v1", "developer", "invoices", "import" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accessKey\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "741ba138-4d0d-4955-bd42-1ee78054d545", "name": "Authentication required", "originalRequest": { "url": { "path": [ "v1", "developer", "invoices", "import" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accessKey\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ff0fd6b4-13e1-455d-96e4-efbcd880cb42", "name": "Insufficient permissions", "originalRequest": { "url": { "path": [ "v1", "developer", "invoices", "import" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accessKey\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ebbc3b9f-4898-4e2d-9852-af4cfcc277f8", "name": "Resource not found", "originalRequest": { "url": { "path": [ "v1", "developer", "invoices", "import" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accessKey\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2aff4930-1cce-4478-8c64-951544b7b765", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v1", "developer", "invoices", "import" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accessKey\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "sign-and-authorize", "description": "Modo B — recibe tu XML sin firmar, lo firma con tu certificado P12 y lo envía al SRI para autorización. El sistema genera el PDF y envía el correo al cliente automáticamente.", "item": [ { "id": "72644892-c9df-4f48-8e19-cde3521a6a2b", "name": "Firmar y autorizar XML (Modo B)", "request": { "name": "Firmar y autorizar XML (Modo B)", "description": { "content": "Modo B — recibe un XML sin firmar generado por ti, lo firma con tu certificado P12 y lo envía al SRI para autorización. El sistema genera el PDF y envía el correo.", "type": "text/plain" }, "url": { "path": [ "v1", "developer", "sign-and-authorize" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-taxpayer-ruc", "value": "{{taxpayerRuc}}" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"xml\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "c483b088-6007-41f6-b6a9-2bbf2bcae9ac", "name": "Successful response", "originalRequest": { "url": { "path": [ "v1", "developer", "sign-and-authorize" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"xml\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"authorized\": \"\",\n \"authorizationNumber\": {},\n \"authorizationDate\": {},\n \"authorizedXml\": {}\n },\n \"meta\": {\n \"requestId\": \"\",\n \"timestamp\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "36375a69-0b34-4f1d-9545-3f6b11bf5bf1", "name": "Validation error", "originalRequest": { "url": { "path": [ "v1", "developer", "sign-and-authorize" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"xml\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "792f032d-ae58-4364-a3a5-fe89d4696d45", "name": "Authentication required", "originalRequest": { "url": { "path": [ "v1", "developer", "sign-and-authorize" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"xml\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ec35e1b3-fbc1-4d10-abc0-4016001bd091", "name": "Insufficient permissions", "originalRequest": { "url": { "path": [ "v1", "developer", "sign-and-authorize" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"xml\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "58ed723b-2500-4889-8444-960b9a2cd697", "name": "Resource not found", "originalRequest": { "url": { "path": [ "v1", "developer", "sign-and-authorize" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"xml\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "65e36fb4-b29b-4739-851f-3ff0f77c14b7", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v1", "developer", "sign-and-authorize" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"xml\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "sign", "description": "Modo C — firma el XML con tu certificado P12 de forma síncrona sin enviarlo al SRI. Útil si necesitas controlar el envío al SRI por tu cuenta.", "item": [ { "id": "c3759633-80df-41d3-ad8c-6b1f06dc441d", "name": "Firmar XML (Modo C)", "request": { "name": "Firmar XML (Modo C)", "description": { "content": "Modo C — firma el XML con tu certificado P12 de forma síncrona sin enviarlo al SRI. Útil si necesitas controlar el envío al SRI por tu cuenta.", "type": "text/plain" }, "url": { "path": [ "v1", "developer", "sign" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-taxpayer-ruc", "value": "{{taxpayerRuc}}" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"xml\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "95df8313-465b-413b-941e-6b72849b405c", "name": "Successful response", "originalRequest": { "url": { "path": [ "v1", "developer", "sign" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"xml\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"signedXml\": \"\"\n },\n \"meta\": {\n \"requestId\": \"\",\n \"timestamp\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "43df60f9-94cc-46ba-80ea-f57f0c972b38", "name": "Validation error", "originalRequest": { "url": { "path": [ "v1", "developer", "sign" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"xml\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "84695263-7866-4716-b370-4947fd5e0e34", "name": "Authentication required", "originalRequest": { "url": { "path": [ "v1", "developer", "sign" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"xml\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "15cba9ad-d99d-405c-86e9-11de31e51789", "name": "Insufficient permissions", "originalRequest": { "url": { "path": [ "v1", "developer", "sign" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"xml\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "820d3267-df9f-4323-b271-b149f8babd76", "name": "Resource not found", "originalRequest": { "url": { "path": [ "v1", "developer", "sign" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"xml\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e1f25036-5e92-4c9b-ab62-724f3b4132a2", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v1", "developer", "sign" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"xml\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "validate-xml", "description": "Valida que el XML tenga la estructura correcta según el esquema del SRI sin procesarlo ni enviarlo. Devuelve la lista de errores de validación encontrados.", "item": [ { "id": "09da62bc-e8d2-436f-9ee1-76ba80ee0822", "name": "Validar estructura de XML", "request": { "name": "Validar estructura de XML", "description": { "content": "Valida que el XML tenga la estructura correcta según el esquema del SRI sin procesarlo ni enviarlo. Devuelve los errores de validación encontrados.", "type": "text/plain" }, "url": { "path": [ "v1", "developer", "validate-xml" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-taxpayer-ruc", "value": "{{taxpayerRuc}}" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"xml\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "61a0528c-8084-4580-94ce-76e4bd232db8", "name": "Successful response", "originalRequest": { "url": { "path": [ "v1", "developer", "validate-xml" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"xml\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"valid\": \"\",\n \"errors\": [\n \"\",\n \"\"\n ]\n },\n \"meta\": {\n \"requestId\": \"\",\n \"timestamp\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "14438614-1048-47e3-8e73-245b8b214b30", "name": "Validation error", "originalRequest": { "url": { "path": [ "v1", "developer", "validate-xml" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"xml\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f4a81de4-e7e9-45b7-b934-fd6879b35727", "name": "Authentication required", "originalRequest": { "url": { "path": [ "v1", "developer", "validate-xml" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"xml\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ec16de03-92e9-4aec-9fb1-8e8a1a78b90e", "name": "Insufficient permissions", "originalRequest": { "url": { "path": [ "v1", "developer", "validate-xml" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"xml\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "330a56c7-657f-4947-8fe1-abc362269159", "name": "Resource not found", "originalRequest": { "url": { "path": [ "v1", "developer", "validate-xml" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"xml\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "14d09ed4-19fc-4f8f-9412-501a8a95636c", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v1", "developer", "validate-xml" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"xml\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "verify", "description": "Consulta en tiempo real el estado de autorización de un comprobante directamente ante el SRI usando su clave de acceso de 49 dígitos.", "item": [ { "name": "{accessKey}", "description": "Parámetro de ruta: clave de acceso SRI de 49 dígitos del comprobante a verificar.", "item": [ { "id": "ed130bfd-c937-4318-848a-13bd2bc0d8e8", "name": "Verificar autorización en el SRI", "request": { "name": "Verificar autorización en el SRI", "description": { "content": "Consulta en tiempo real el estado de autorización de un comprobante directamente ante el SRI usando su clave de acceso de 49 dígitos.", "type": "text/plain" }, "url": { "path": [ "v1", "developer", "verify", ":accessKey" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "accessKey", "disabled": false, "description": { "content": "(Required) Clave de acceso SRI (49 dígitos)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-taxpayer-ruc", "value": "{{taxpayerRuc}}" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "bb2e3ab7-a406-489c-8c6d-2f05e83e7690", "name": "Successful response", "originalRequest": { "url": { "path": [ "v1", "developer", "verify", ":accessKey" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Clave de acceso SRI (49 dígitos)", "type": "text/plain" }, "type": "any", "value": "", "key": "accessKey" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"found\": \"\",\n \"source\": \"local\",\n \"accessKey\": \"\",\n \"receiptId\": \"\",\n \"status\": \"\",\n \"authorizationNumber\": {},\n \"authorizationDate\": {},\n \"messages\": {},\n \"type\": \"\",\n \"authorized\": \"\",\n \"message\": \"\"\n },\n \"meta\": {\n \"requestId\": \"\",\n \"timestamp\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fd461a80-e15a-4224-853e-b934a5e91762", "name": "Validation error", "originalRequest": { "url": { "path": [ "v1", "developer", "verify", ":accessKey" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Clave de acceso SRI (49 dígitos)", "type": "text/plain" }, "type": "any", "value": "", "key": "accessKey" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9a46f7c4-eb36-427c-a282-f1eff4f112a9", "name": "Authentication required", "originalRequest": { "url": { "path": [ "v1", "developer", "verify", ":accessKey" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Clave de acceso SRI (49 dígitos)", "type": "text/plain" }, "type": "any", "value": "", "key": "accessKey" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aec7b9f1-9a5f-41b2-a085-da5f4bca3b2d", "name": "Insufficient permissions", "originalRequest": { "url": { "path": [ "v1", "developer", "verify", ":accessKey" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Clave de acceso SRI (49 dígitos)", "type": "text/plain" }, "type": "any", "value": "", "key": "accessKey" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b799313c-98dd-453b-b851-8c3c050711d5", "name": "Resource not found", "originalRequest": { "url": { "path": [ "v1", "developer", "verify", ":accessKey" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Clave de acceso SRI (49 dígitos)", "type": "text/plain" }, "type": "any", "value": "", "key": "accessKey" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4067b772-5df7-4a9a-b065-fd101ac66520", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v1", "developer", "verify", ":accessKey" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Clave de acceso SRI (49 dígitos)", "type": "text/plain" }, "type": "any", "value": "", "key": "accessKey" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "receipts", "description": "Consulta y descarga comprobantes emitidos. Obtén el detalle completo, el estado de procesamiento, el XML autorizado y el PDF (RIDE) de tus facturas. Recuerda que las URL que se muestran tienen un periodo de expiración, puedes tambien obtener una URL publica para compartir con tus clientes con la propiedad previewUrl que accederas a nuestra plataforma para poder observar la factura y poder ver el PDF y XML", "item": [ { "id": "b7e2a1c3-d4f5-4e6a-8b90-c1d2e3f4a5b6", "name": "Consultar comprobante externo por clave de acceso", "request": { "name": "Consultar comprobante externo por clave de acceso", "description": { "content": "Consulta un comprobante ya autorizado por el SRI emitido desde cualquier sistema de facturación. El contribuyente emisor se crea automáticamente en el workspace (con firma vacía) si no existe. Soporta Facturas (01), Notas de Crédito (04) y Guías de Remisión (06). Si save=false, solo verifica el comprobante y descuenta el contador sin guardar registros en la BD.", "type": "text/plain" }, "url": { "path": [ "v1", "developer", "receipts", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accessKey\": \"\",\n \"save\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "{id}", "description": "Parámetro de ruta: ID único del comprobante emitido.", "item": [ { "id": "2594ded4-eb7f-4f56-9075-2d74503a5d5b", "name": "Obtener detalle del comprobante", "request": { "name": "Obtener detalle del comprobante", "description": { "content": "Devuelve todos los datos del comprobante: estado de procesamiento, clave de acceso SRI, número secuencial, totales y fechas.", "type": "text/plain" }, "url": { "path": [ "v1", "developer", "receipts", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-taxpayer-ruc", "value": "{{taxpayerRuc}}" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "7b51703e-ec6f-4731-af35-6998cbac4ce5", "name": "Successful response", "originalRequest": { "url": { "path": [ "v1", "developer", "receipts", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"\",\n \"accessKey\": \"\",\n \"sequential\": \"\",\n \"status\": \"\",\n \"total\": \"\",\n \"source\": \"\",\n \"apiKeyId\": {}\n },\n \"meta\": {\n \"requestId\": \"\",\n \"timestamp\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c99c1d8f-5180-4a70-86bd-de473e5c0bf3", "name": "Validation error", "originalRequest": { "url": { "path": [ "v1", "developer", "receipts", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9ba79e7b-2878-4d2e-ad15-e34732f8b4fb", "name": "Authentication required", "originalRequest": { "url": { "path": [ "v1", "developer", "receipts", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7a12cc49-da71-4ef2-97ad-82ab588a3f9f", "name": "Insufficient permissions", "originalRequest": { "url": { "path": [ "v1", "developer", "receipts", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6657446f-ec66-46af-89ad-0fcd6c9754a3", "name": "Resource not found", "originalRequest": { "url": { "path": [ "v1", "developer", "receipts", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ab31ef1e-7997-4b35-a05c-89cb41208870", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v1", "developer", "receipts", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "status", "description": "Consulta el estado actual del comprobante: PROCESSING (en proceso), AUTHORIZED (autorizado por SRI), COMPLETED (completado), ERROR o REJECTED.", "item": [ { "id": "7c02c09b-bf75-4b40-990f-d88de0192d85", "name": "Consultar estado del comprobante", "request": { "name": "Consultar estado del comprobante", "description": { "content": "Devuelve el estado actual del comprobante: PROCESSING (en proceso), AUTHORIZED (autorizado por SRI), COMPLETED (completado), ERROR o REJECTED.", "type": "text/plain" }, "url": { "path": [ "v1", "developer", "receipts", ":id", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-taxpayer-ruc", "value": "{{taxpayerRuc}}" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "c63861a2-593c-4a33-98c9-526c1ef38763", "name": "Successful response", "originalRequest": { "url": { "path": [ "v1", "developer", "receipts", ":id", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"status\": \"\",\n \"authorizationNumber\": {},\n \"messages\": {}\n },\n \"meta\": {\n \"requestId\": \"\",\n \"timestamp\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4c5d89fc-83d6-490d-8c54-8690055a3341", "name": "Validation error", "originalRequest": { "url": { "path": [ "v1", "developer", "receipts", ":id", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0d93f7a4-8ea9-44f9-b866-378073f02539", "name": "Authentication required", "originalRequest": { "url": { "path": [ "v1", "developer", "receipts", ":id", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5aaa54ce-1ba1-410c-948b-3e4908a00033", "name": "Insufficient permissions", "originalRequest": { "url": { "path": [ "v1", "developer", "receipts", ":id", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d874645b-5e9d-4d43-9d8a-160f1c7aae2e", "name": "Resource not found", "originalRequest": { "url": { "path": [ "v1", "developer", "receipts", ":id", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7ba5b9f5-5e17-4b61-ab99-a33013384944", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v1", "developer", "receipts", ":id", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "xml", "description": "Descarga el XML autorizado por el SRI. Devuelve una URL pre-firmada que expira en 5 minutos y una URL permanente (previewUrl) para visualización.", "item": [ { "id": "f74de4d5-871d-4fc3-867f-1d1a1233a405", "name": "Descargar XML autorizado", "request": { "name": "Descargar XML autorizado", "description": { "content": "Devuelve una URL pre-firmada del XML autorizado por el SRI (expira en 5 minutos) y una URL permanente de visualización (previewUrl) que no expira.", "type": "text/plain" }, "url": { "path": [ "v1", "developer", "receipts", ":id", "xml" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-taxpayer-ruc", "value": "{{taxpayerRuc}}" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "42c26026-941c-492c-b070-f64f3ef94164", "name": "Successful response", "originalRequest": { "url": { "path": [ "v1", "developer", "receipts", ":id", "xml" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"url\": \"\",\n \"previewUrl\": \"\"\n },\n \"meta\": {\n \"requestId\": \"\",\n \"timestamp\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3a3da020-ce08-4a18-b456-89735aaf666e", "name": "Validation error", "originalRequest": { "url": { "path": [ "v1", "developer", "receipts", ":id", "xml" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cd00e22a-ec48-4d72-a410-2bab6b8bf499", "name": "Authentication required", "originalRequest": { "url": { "path": [ "v1", "developer", "receipts", ":id", "xml" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4bd50502-d0af-4741-a959-ba0dc772da35", "name": "Insufficient permissions", "originalRequest": { "url": { "path": [ "v1", "developer", "receipts", ":id", "xml" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9af08117-0aa2-41f6-b444-157199ec8cef", "name": "Resource not found", "originalRequest": { "url": { "path": [ "v1", "developer", "receipts", ":id", "xml" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b8f74ca4-c070-4a0a-ba3a-5222c034ab07", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v1", "developer", "receipts", ":id", "xml" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "pdf", "description": "Descarga el PDF (RIDE) del comprobante. Devuelve una URL pre-firmada que expira en 5 minutos y una URL permanente (previewUrl) para visualización.", "item": [ { "id": "9c10cf9f-8ecc-4a38-8173-33c25cb2d2e1", "name": "Descargar PDF (RIDE)", "request": { "name": "Descargar PDF (RIDE)", "description": { "content": "Devuelve una URL pre-firmada del PDF (RIDE) del comprobante (expira en 5 minutos) y una URL permanente de visualización (previewUrl) que no expira.", "type": "text/plain" }, "url": { "path": [ "v1", "developer", "receipts", ":id", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-taxpayer-ruc", "value": "{{taxpayerRuc}}" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "361c5404-3f63-427e-94bc-59c8ef2c9ad6", "name": "Successful response", "originalRequest": { "url": { "path": [ "v1", "developer", "receipts", ":id", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"url\": \"\",\n \"previewUrl\": \"\"\n },\n \"meta\": {\n \"requestId\": \"\",\n \"timestamp\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "402a8b91-b42e-419a-b1e2-6acd1448d62c", "name": "Validation error", "originalRequest": { "url": { "path": [ "v1", "developer", "receipts", ":id", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bb431133-7f7a-4b9d-9d56-55eeef0a31a7", "name": "Authentication required", "originalRequest": { "url": { "path": [ "v1", "developer", "receipts", ":id", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "794f52b8-c351-479b-8886-78df83f9fcce", "name": "Insufficient permissions", "originalRequest": { "url": { "path": [ "v1", "developer", "receipts", ":id", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9aaeb7ea-1784-44a6-bd7b-435696766682", "name": "Resource not found", "originalRequest": { "url": { "path": [ "v1", "developer", "receipts", ":id", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cc69d472-8db2-4882-92a6-de761c491692", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v1", "developer", "receipts", ":id", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del comprobante", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] } ] }, { "name": "usage", "description": "Consulta el consumo de documentos del mes actual, el límite de tu plan y el costo estimado.", "item": [ { "id": "21f21dc9-0071-46c0-b7d8-7498fc2fba6f", "name": "Consultar uso del API", "request": { "name": "Consultar uso del API", "description": { "content": "Devuelve el consumo de documentos del mes actual, el límite de tu plan y el costo estimado.", "type": "text/plain" }, "url": { "path": [ "v1", "developer", "usage" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "a3f86d05-e0cd-43d1-8ee6-6d5f0484b9e6", "name": "Successful response", "originalRequest": { "url": { "path": [ "v1", "developer", "usage" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"currentMonth\": {},\n \"plan\": {},\n \"monthlyQuota\": {},\n \"monthlyUsed\": {}\n },\n \"meta\": {\n \"requestId\": \"\",\n \"timestamp\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8bebe2b6-08e9-45e7-8211-46c6cbe3cb7f", "name": "Validation error", "originalRequest": { "url": { "path": [ "v1", "developer", "usage" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4c88bdf4-bd9b-46c9-b52b-d4ce0c792ea8", "name": "Authentication required", "originalRequest": { "url": { "path": [ "v1", "developer", "usage" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "71aa7883-760d-41f8-9702-4cac423509a0", "name": "Insufficient permissions", "originalRequest": { "url": { "path": [ "v1", "developer", "usage" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2f1438bb-c6c3-4d98-87f2-bdb60dd95757", "name": "Resource not found", "originalRequest": { "url": { "path": [ "v1", "developer", "usage" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "11c97006-8bd3-4b7e-ba51-f6e517a9b4f5", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v1", "developer", "usage" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "certificate", "description": "Verifica el estado del certificado digital P12 configurado en tu cuenta. Indica si está vigente, su fecha de vencimiento y el RUC del titular.", "item": [ { "name": "status", "description": "Consulta el estado actual del comprobante: PROCESSING (en proceso), AUTHORIZED (autorizado por SRI), COMPLETED (completado), ERROR o REJECTED.", "item": [ { "id": "abce645f-f503-414f-9696-b2aedc0981d7", "name": "Estado del certificado digital", "request": { "name": "Estado del certificado digital", "description": { "content": "Indica si el certificado P12 configurado en tu cuenta está vigente, su fecha de vencimiento y el RUC del titular. Si no está vigente, los comprobantes no podrán firmarse.", "type": "text/plain" }, "url": { "path": [ "v1", "developer", "certificate", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-taxpayer-ruc", "value": "{{taxpayerRuc}}" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "fd02d342-e720-4a3e-9da3-62b11c8510ce", "name": "Successful response", "originalRequest": { "url": { "path": [ "v1", "developer", "certificate", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"hasCertificate\": \"\",\n \"isExpired\": \"\",\n \"daysUntilExpiry\": {},\n \"ruc\": {},\n \"legalName\": {},\n \"issuedAt\": {},\n \"expiresAt\": {},\n \"issuer\": {}\n },\n \"meta\": {\n \"requestId\": \"\",\n \"timestamp\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1ad3c7f4-376a-4295-b70b-1f71f472d29b", "name": "Validation error", "originalRequest": { "url": { "path": [ "v1", "developer", "certificate", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ad0b86f8-494b-426a-808c-d06987fe1f10", "name": "Authentication required", "originalRequest": { "url": { "path": [ "v1", "developer", "certificate", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7f9da4ea-b0e9-4f1e-8e00-253ae5fce323", "name": "Insufficient permissions", "originalRequest": { "url": { "path": [ "v1", "developer", "certificate", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fb517bb1-9c91-44eb-8f23-173963d9a7fb", "name": "Resource not found", "originalRequest": { "url": { "path": [ "v1", "developer", "certificate", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7dda587a-ca3e-4f98-8fca-8cb5010ff10b", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v1", "developer", "certificate", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "customers", "description": "Gestiona tu directorio de clientes. Crea, consulta, actualiza y elimina los contactos a quienes emites comprobantes electrónicos.", "item": [ { "id": "b0ffb416-624f-4586-a81c-271ac89b01f4", "name": "Crear cliente", "request": { "name": "Crear cliente", "description": { "content": "Crea un nuevo cliente en tu directorio de contactos. Puedes usar RUC (13 dígitos), cédula (10 dígitos), pasaporte o consumidor final.", "type": "text/plain" }, "url": { "path": [ "v1", "developer", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-taxpayer-ruc", "value": "{{taxpayerRuc}}" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"identificationType\": \"RUC\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"address\": \" (opcional)\",\n \"phone\": \" (opcional)\",\n \"additionalEmail\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "746d4ef7-d792-4dcc-9a27-bf24ad7730ac", "name": "Resource created successfully", "originalRequest": { "url": { "path": [ "v1", "developer", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"identificationType\": \"RUC\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"address\": \" (opcional)\",\n \"phone\": \" (opcional)\",\n \"additionalEmail\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"\",\n \"taxpayerId\": \"\",\n \"identificationType\": \"CEDULA\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"isActive\": \"\",\n \"createdAt\": \"\",\n \"updatedAt\": \"\",\n \"address\": {},\n \"phone\": {},\n \"additionalEmail\": {},\n \"deletedAt\": {}\n },\n \"meta\": {\n \"requestId\": \"\",\n \"timestamp\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c01b56fc-e3b8-43bc-abc0-8bced8536664", "name": "Validation error", "originalRequest": { "url": { "path": [ "v1", "developer", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"identificationType\": \"RUC\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"address\": \" (opcional)\",\n \"phone\": \" (opcional)\",\n \"additionalEmail\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6c9dcae6-67aa-4f58-991c-5ca85ac462c5", "name": "Authentication required", "originalRequest": { "url": { "path": [ "v1", "developer", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"identificationType\": \"RUC\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"address\": \" (opcional)\",\n \"phone\": \" (opcional)\",\n \"additionalEmail\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a6924d69-0d36-48e5-9dd5-2887cb04f458", "name": "Insufficient permissions", "originalRequest": { "url": { "path": [ "v1", "developer", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"identificationType\": \"RUC\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"address\": \" (opcional)\",\n \"phone\": \" (opcional)\",\n \"additionalEmail\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e764caa8-07bc-4dfd-9e9f-ae51d7594826", "name": "Resource not found", "originalRequest": { "url": { "path": [ "v1", "developer", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"identificationType\": \"RUC\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"address\": \" (opcional)\",\n \"phone\": \" (opcional)\",\n \"additionalEmail\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c12d2e1d-62a7-4c69-b9ab-8e2b2856f5be", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v1", "developer", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"identificationType\": \"RUC\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"address\": \" (opcional)\",\n \"phone\": \" (opcional)\",\n \"additionalEmail\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9000a9e8-6dec-43a7-888b-22f67e3d4a9b", "name": "Listar clientes", "request": { "name": "Listar clientes", "description": { "content": "Lista todos tus clientes con paginación. Puedes buscar por nombre o número de identificación.", "type": "text/plain" }, "url": { "path": [ "v1", "developer", "customers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Page number", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "Items per page", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Search by name, identification, or email", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "Filter by identification type (This can only be one of RUC,CEDULA,PASSPORT,FINAL_CONSUMER)", "type": "text/plain" }, "key": "identificationType", "value": "FINAL_CONSUMER" }, { "disabled": false, "description": { "content": "Filter by active status", "type": "text/plain" }, "key": "isActive", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-taxpayer-ruc", "value": "{{taxpayerRuc}}" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "6d5fd747-f1d2-40ec-9d43-9137167be953", "name": "Paginated list response", "originalRequest": { "url": { "path": [ "v1", "developer", "customers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Page number", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "Items per page", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Search by name, identification, or email", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "Filter by identification type (This can only be one of RUC,CEDULA,PASSPORT,FINAL_CONSUMER)", "type": "text/plain" }, "key": "identificationType", "value": "FINAL_CONSUMER" }, { "disabled": false, "description": { "content": "Filter by active status", "type": "text/plain" }, "key": "isActive", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"\",\n \"taxpayerId\": \"\",\n \"identificationType\": \"RUC\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"isActive\": \"\",\n \"createdAt\": \"\",\n \"updatedAt\": \"\",\n \"address\": {},\n \"phone\": {},\n \"additionalEmail\": {},\n \"deletedAt\": {}\n },\n {\n \"id\": \"\",\n \"taxpayerId\": \"\",\n \"identificationType\": \"CEDULA\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"isActive\": \"\",\n \"createdAt\": \"\",\n \"updatedAt\": \"\",\n \"address\": {},\n \"phone\": {},\n \"additionalEmail\": {},\n \"deletedAt\": {}\n }\n ],\n \"meta\": {\n \"requestId\": \"\",\n \"timestamp\": \"\",\n \"pagination\": {\n \"total\": \"\",\n \"page\": \"\",\n \"limit\": \"\",\n \"totalPages\": \"\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1d626c61-7d01-43d0-8bf7-ed0be86dd2dd", "name": "Validation error", "originalRequest": { "url": { "path": [ "v1", "developer", "customers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Page number", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "Items per page", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Search by name, identification, or email", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "Filter by identification type (This can only be one of RUC,CEDULA,PASSPORT,FINAL_CONSUMER)", "type": "text/plain" }, "key": "identificationType", "value": "FINAL_CONSUMER" }, { "disabled": false, "description": { "content": "Filter by active status", "type": "text/plain" }, "key": "isActive", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4c868853-50e7-4257-8282-e6eb2c4376b5", "name": "Authentication required", "originalRequest": { "url": { "path": [ "v1", "developer", "customers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Page number", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "Items per page", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Search by name, identification, or email", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "Filter by identification type (This can only be one of RUC,CEDULA,PASSPORT,FINAL_CONSUMER)", "type": "text/plain" }, "key": "identificationType", "value": "FINAL_CONSUMER" }, { "disabled": false, "description": { "content": "Filter by active status", "type": "text/plain" }, "key": "isActive", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8be6e4d1-e21f-426b-a935-a8be6ac90611", "name": "Insufficient permissions", "originalRequest": { "url": { "path": [ "v1", "developer", "customers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Page number", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "Items per page", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Search by name, identification, or email", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "Filter by identification type (This can only be one of RUC,CEDULA,PASSPORT,FINAL_CONSUMER)", "type": "text/plain" }, "key": "identificationType", "value": "FINAL_CONSUMER" }, { "disabled": false, "description": { "content": "Filter by active status", "type": "text/plain" }, "key": "isActive", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c08b3785-086e-4601-8823-fcae0158df11", "name": "Resource not found", "originalRequest": { "url": { "path": [ "v1", "developer", "customers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Page number", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "Items per page", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Search by name, identification, or email", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "Filter by identification type (This can only be one of RUC,CEDULA,PASSPORT,FINAL_CONSUMER)", "type": "text/plain" }, "key": "identificationType", "value": "FINAL_CONSUMER" }, { "disabled": false, "description": { "content": "Filter by active status", "type": "text/plain" }, "key": "isActive", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5e380092-4b80-459c-aaeb-e5ef511d71c9", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v1", "developer", "customers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Page number", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "Items per page", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Search by name, identification, or email", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "Filter by identification type (This can only be one of RUC,CEDULA,PASSPORT,FINAL_CONSUMER)", "type": "text/plain" }, "key": "identificationType", "value": "FINAL_CONSUMER" }, { "disabled": false, "description": { "content": "Filter by active status", "type": "text/plain" }, "key": "isActive", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "{id}", "description": "Parámetro de ruta: ID único del comprobante emitido.", "item": [ { "id": "6ddd2d76-7efe-406b-95f3-fd98b5bf7e0f", "name": "Obtener cliente", "request": { "name": "Obtener cliente", "description": { "content": "Devuelve el detalle completo de un cliente específico por su ID.", "type": "text/plain" }, "url": { "path": [ "v1", "developer", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) ID del cliente", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-taxpayer-ruc", "value": "{{taxpayerRuc}}" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "f622571d-c38e-4346-8f2a-e5885c4bae2d", "name": "Successful response", "originalRequest": { "url": { "path": [ "v1", "developer", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del cliente", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"\",\n \"taxpayerId\": \"\",\n \"identificationType\": \"CEDULA\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"isActive\": \"\",\n \"createdAt\": \"\",\n \"updatedAt\": \"\",\n \"address\": {},\n \"phone\": {},\n \"additionalEmail\": {},\n \"deletedAt\": {}\n },\n \"meta\": {\n \"requestId\": \"\",\n \"timestamp\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d68eb00e-27eb-4139-b812-f665e88c73d4", "name": "Validation error", "originalRequest": { "url": { "path": [ "v1", "developer", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del cliente", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a21e5a8d-0bd2-49f8-a9b2-4ab5f3ee18d4", "name": "Authentication required", "originalRequest": { "url": { "path": [ "v1", "developer", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del cliente", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fb8970ba-9d94-44f6-a493-6ab91a61713e", "name": "Insufficient permissions", "originalRequest": { "url": { "path": [ "v1", "developer", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del cliente", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "47fb9707-f43d-4859-a3f8-af49931f26d4", "name": "Resource not found", "originalRequest": { "url": { "path": [ "v1", "developer", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del cliente", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "382e3d4b-f1ef-4d47-aef9-7520194d0eda", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v1", "developer", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del cliente", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8a6cc1a6-aa17-4623-b0c8-cbd0e927ba6b", "name": "Actualizar cliente", "request": { "name": "Actualizar cliente", "description": { "content": "Actualiza uno o más campos de un cliente existente. Solo se actualizan los campos enviados en el body.", "type": "text/plain" }, "url": { "path": [ "v1", "developer", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) ID del cliente", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-taxpayer-ruc", "value": "{{taxpayerRuc}}" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"identificationType\": \"FINAL_CONSUMER\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"address\": \" (opcional)\",\n \"phone\": \" (opcional)\",\n \"additionalEmail\": \"\",\n \"isActive\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "5df9a14c-8949-4c5e-a26e-0d4e9bcc35e7", "name": "Successful response", "originalRequest": { "url": { "path": [ "v1", "developer", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del cliente", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"identificationType\": \"FINAL_CONSUMER\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"address\": \" (opcional)\",\n \"phone\": \" (opcional)\",\n \"additionalEmail\": \"\",\n \"isActive\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"\",\n \"taxpayerId\": \"\",\n \"identificationType\": \"CEDULA\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"isActive\": \"\",\n \"createdAt\": \"\",\n \"updatedAt\": \"\",\n \"address\": {},\n \"phone\": {},\n \"additionalEmail\": {},\n \"deletedAt\": {}\n },\n \"meta\": {\n \"requestId\": \"\",\n \"timestamp\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f363ef9b-8a53-42e2-93b9-82a7462f5f5c", "name": "Validation error", "originalRequest": { "url": { "path": [ "v1", "developer", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del cliente", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"identificationType\": \"FINAL_CONSUMER\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"address\": \" (opcional)\",\n \"phone\": \" (opcional)\",\n \"additionalEmail\": \"\",\n \"isActive\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a40e8b47-3049-4bfe-bd9e-3ab2994e6f46", "name": "Authentication required", "originalRequest": { "url": { "path": [ "v1", "developer", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del cliente", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"identificationType\": \"FINAL_CONSUMER\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"address\": \" (opcional)\",\n \"phone\": \" (opcional)\",\n \"additionalEmail\": \"\",\n \"isActive\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "593ffcbe-e04a-4bf5-8914-5b3964ea7096", "name": "Insufficient permissions", "originalRequest": { "url": { "path": [ "v1", "developer", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del cliente", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"identificationType\": \"FINAL_CONSUMER\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"address\": \" (opcional)\",\n \"phone\": \" (opcional)\",\n \"additionalEmail\": \"\",\n \"isActive\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cbc69279-4a5c-4072-be88-a6c850adf50c", "name": "Resource not found", "originalRequest": { "url": { "path": [ "v1", "developer", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del cliente", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"identificationType\": \"FINAL_CONSUMER\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"address\": \" (opcional)\",\n \"phone\": \" (opcional)\",\n \"additionalEmail\": \"\",\n \"isActive\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fb90ab0c-9bd4-47ae-bdea-7c5f12d5608e", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v1", "developer", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del cliente", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"identificationType\": \"FINAL_CONSUMER\",\n \"identification\": \"\",\n \"legalName\": \"\",\n \"email\": \" (opcional)\",\n \"address\": \" (opcional)\",\n \"phone\": \" (opcional)\",\n \"additionalEmail\": \"\",\n \"isActive\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c9e48e39-f157-4095-a328-00abb14d3435", "name": "Eliminar cliente", "request": { "name": "Eliminar cliente", "description": { "content": "Elimina un cliente del directorio. Esta acción no afecta los comprobantes ya emitidos a ese cliente.", "type": "text/plain" }, "url": { "path": [ "v1", "developer", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) ID del cliente", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-taxpayer-ruc", "value": "{{taxpayerRuc}}" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "81661ad6-29f6-427a-9f1e-5adb61a3fe08", "name": "Successful response", "originalRequest": { "url": { "path": [ "v1", "developer", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del cliente", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"message\": \"\"\n },\n \"meta\": {\n \"requestId\": \"\",\n \"timestamp\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "79771d19-626b-4519-b4a9-3922298f3133", "name": "Validation error", "originalRequest": { "url": { "path": [ "v1", "developer", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del cliente", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aa2ddc0f-9e87-4b22-ab38-9448e533d879", "name": "Authentication required", "originalRequest": { "url": { "path": [ "v1", "developer", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del cliente", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "00b3b882-75ab-4ac5-8e00-012ae7cf2c73", "name": "Insufficient permissions", "originalRequest": { "url": { "path": [ "v1", "developer", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del cliente", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "85843c32-f9b3-491b-83ab-94ffb4d6f5b9", "name": "Resource not found", "originalRequest": { "url": { "path": [ "v1", "developer", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del cliente", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c1e286db-69fc-4684-a087-f0b0a87aefa8", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v1", "developer", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del cliente", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "products", "description": "Gestiona tu catálogo de productos y servicios. Define los ítems que utilizas en tus facturas con su código, precio unitario y tipo de IVA.", "item": [ { "id": "b9effaca-7190-4a3e-81b7-af4cb30cb94a", "name": "Crear producto o servicio", "request": { "name": "Crear producto o servicio", "description": { "content": "Crea un nuevo producto o servicio en tu catálogo. Define el código, nombre, precio unitario y tipo de IVA aplicable.", "type": "text/plain" }, "url": { "path": [ "v1", "developer", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-taxpayer-ruc", "value": "{{taxpayerRuc}}" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"type\": \"PRODUCT\",\n \"name\": \"\",\n \"unitPrice\": \"\",\n \"taxType\": \"IVA_RATE\",\n \"auxiliaryCode\": \" (opcional)\",\n \"description\": \"\",\n \"iceCode\": \"\",\n \"iceRate\": \"\",\n \"irbpnr\": false,\n \"unitOfMeasure\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "93b2cadd-5f07-4cc7-a96b-0fd7ab0df737", "name": "Resource created successfully", "originalRequest": { "url": { "path": [ "v1", "developer", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"type\": \"PRODUCT\",\n \"name\": \"\",\n \"unitPrice\": \"\",\n \"taxType\": \"IVA_RATE\",\n \"auxiliaryCode\": \" (opcional)\",\n \"description\": \"\",\n \"iceCode\": \"\",\n \"iceRate\": \"\",\n \"irbpnr\": false,\n \"unitOfMeasure\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"\",\n \"taxpayerId\": \"\",\n \"code\": \"\",\n \"type\": \"PRODUCT\",\n \"name\": \"\",\n \"unitPrice\": \"\",\n \"taxType\": \"IVA_RATE\",\n \"irbpnr\": \"\",\n \"isActive\": \"\",\n \"createdAt\": \"\",\n \"updatedAt\": \"\",\n \"auxiliaryCode\": {},\n \"description\": {},\n \"iceCode\": {},\n \"iceRate\": {},\n \"unitOfMeasure\": {},\n \"deletedAt\": {}\n },\n \"meta\": {\n \"requestId\": \"\",\n \"timestamp\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a919e798-c43c-4989-8582-c59c241a8b6c", "name": "Validation error", "originalRequest": { "url": { "path": [ "v1", "developer", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"type\": \"PRODUCT\",\n \"name\": \"\",\n \"unitPrice\": \"\",\n \"taxType\": \"IVA_RATE\",\n \"auxiliaryCode\": \" (opcional)\",\n \"description\": \"\",\n \"iceCode\": \"\",\n \"iceRate\": \"\",\n \"irbpnr\": false,\n \"unitOfMeasure\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c2f07e89-4162-4e79-b1a2-fefc9010ca83", "name": "Authentication required", "originalRequest": { "url": { "path": [ "v1", "developer", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"type\": \"PRODUCT\",\n \"name\": \"\",\n \"unitPrice\": \"\",\n \"taxType\": \"IVA_RATE\",\n \"auxiliaryCode\": \" (opcional)\",\n \"description\": \"\",\n \"iceCode\": \"\",\n \"iceRate\": \"\",\n \"irbpnr\": false,\n \"unitOfMeasure\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bb84c7e1-9c61-47c7-b608-71e5d7faf474", "name": "Insufficient permissions", "originalRequest": { "url": { "path": [ "v1", "developer", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"type\": \"PRODUCT\",\n \"name\": \"\",\n \"unitPrice\": \"\",\n \"taxType\": \"IVA_RATE\",\n \"auxiliaryCode\": \" (opcional)\",\n \"description\": \"\",\n \"iceCode\": \"\",\n \"iceRate\": \"\",\n \"irbpnr\": false,\n \"unitOfMeasure\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f93c30a9-9dc4-48a0-a38a-8a45cc4d1986", "name": "Resource not found", "originalRequest": { "url": { "path": [ "v1", "developer", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"type\": \"PRODUCT\",\n \"name\": \"\",\n \"unitPrice\": \"\",\n \"taxType\": \"IVA_RATE\",\n \"auxiliaryCode\": \" (opcional)\",\n \"description\": \"\",\n \"iceCode\": \"\",\n \"iceRate\": \"\",\n \"irbpnr\": false,\n \"unitOfMeasure\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "45ac89d0-4790-4200-b93b-64ce1dd3ff9a", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v1", "developer", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"type\": \"PRODUCT\",\n \"name\": \"\",\n \"unitPrice\": \"\",\n \"taxType\": \"IVA_RATE\",\n \"auxiliaryCode\": \" (opcional)\",\n \"description\": \"\",\n \"iceCode\": \"\",\n \"iceRate\": \"\",\n \"irbpnr\": false,\n \"unitOfMeasure\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a120df0e-3837-4758-a34d-4e044fd988e8", "name": "Listar productos", "request": { "name": "Listar productos", "description": { "content": "Lista todos tus productos y servicios con paginación. Puedes buscar por nombre o código.", "type": "text/plain" }, "url": { "path": [ "v1", "developer", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Page number", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "Items per page", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Search by name, code, or description", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "Filter by product type (This can only be one of PRODUCT,SERVICE)", "type": "text/plain" }, "key": "type", "value": "PRODUCT" }, { "disabled": false, "description": { "content": "Filter by tax type (This can only be one of IVA_0,IVA_RATE,NOT_TAXABLE,EXEMPT)", "type": "text/plain" }, "key": "taxType", "value": "EXEMPT" }, { "disabled": false, "description": { "content": "Filter by active status", "type": "text/plain" }, "key": "isActive", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-taxpayer-ruc", "value": "{{taxpayerRuc}}" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "c6e50ec2-80e4-4395-b74a-4f8a4ee401f3", "name": "Paginated list response", "originalRequest": { "url": { "path": [ "v1", "developer", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Page number", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "Items per page", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Search by name, code, or description", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "Filter by product type (This can only be one of PRODUCT,SERVICE)", "type": "text/plain" }, "key": "type", "value": "PRODUCT" }, { "disabled": false, "description": { "content": "Filter by tax type (This can only be one of IVA_0,IVA_RATE,NOT_TAXABLE,EXEMPT)", "type": "text/plain" }, "key": "taxType", "value": "EXEMPT" }, { "disabled": false, "description": { "content": "Filter by active status", "type": "text/plain" }, "key": "isActive", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"\",\n \"taxpayerId\": \"\",\n \"code\": \"\",\n \"type\": \"PRODUCT\",\n \"name\": \"\",\n \"unitPrice\": \"\",\n \"taxType\": \"EXEMPT\",\n \"irbpnr\": \"\",\n \"isActive\": \"\",\n \"createdAt\": \"\",\n \"updatedAt\": \"\",\n \"auxiliaryCode\": {},\n \"description\": {},\n \"iceCode\": {},\n \"iceRate\": {},\n \"unitOfMeasure\": {},\n \"deletedAt\": {}\n },\n {\n \"id\": \"\",\n \"taxpayerId\": \"\",\n \"code\": \"\",\n \"type\": \"PRODUCT\",\n \"name\": \"\",\n \"unitPrice\": \"\",\n \"taxType\": \"IVA_0\",\n \"irbpnr\": \"\",\n \"isActive\": \"\",\n \"createdAt\": \"\",\n \"updatedAt\": \"\",\n \"auxiliaryCode\": {},\n \"description\": {},\n \"iceCode\": {},\n \"iceRate\": {},\n \"unitOfMeasure\": {},\n \"deletedAt\": {}\n }\n ],\n \"meta\": {\n \"requestId\": \"\",\n \"timestamp\": \"\",\n \"pagination\": {\n \"total\": \"\",\n \"page\": \"\",\n \"limit\": \"\",\n \"totalPages\": \"\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5c19e6b2-208f-4b9e-bd34-adc8c77de217", "name": "Validation error", "originalRequest": { "url": { "path": [ "v1", "developer", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Page number", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "Items per page", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Search by name, code, or description", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "Filter by product type (This can only be one of PRODUCT,SERVICE)", "type": "text/plain" }, "key": "type", "value": "PRODUCT" }, { "disabled": false, "description": { "content": "Filter by tax type (This can only be one of IVA_0,IVA_RATE,NOT_TAXABLE,EXEMPT)", "type": "text/plain" }, "key": "taxType", "value": "EXEMPT" }, { "disabled": false, "description": { "content": "Filter by active status", "type": "text/plain" }, "key": "isActive", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4bfc1927-0ff2-4af1-b728-fc44d45c8896", "name": "Authentication required", "originalRequest": { "url": { "path": [ "v1", "developer", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Page number", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "Items per page", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Search by name, code, or description", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "Filter by product type (This can only be one of PRODUCT,SERVICE)", "type": "text/plain" }, "key": "type", "value": "PRODUCT" }, { "disabled": false, "description": { "content": "Filter by tax type (This can only be one of IVA_0,IVA_RATE,NOT_TAXABLE,EXEMPT)", "type": "text/plain" }, "key": "taxType", "value": "EXEMPT" }, { "disabled": false, "description": { "content": "Filter by active status", "type": "text/plain" }, "key": "isActive", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d15a14ee-d21a-4186-a3c1-19d7d8ae8189", "name": "Insufficient permissions", "originalRequest": { "url": { "path": [ "v1", "developer", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Page number", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "Items per page", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Search by name, code, or description", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "Filter by product type (This can only be one of PRODUCT,SERVICE)", "type": "text/plain" }, "key": "type", "value": "PRODUCT" }, { "disabled": false, "description": { "content": "Filter by tax type (This can only be one of IVA_0,IVA_RATE,NOT_TAXABLE,EXEMPT)", "type": "text/plain" }, "key": "taxType", "value": "EXEMPT" }, { "disabled": false, "description": { "content": "Filter by active status", "type": "text/plain" }, "key": "isActive", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9d2bd8fe-0ea0-422c-a6e7-b1030f81ef78", "name": "Resource not found", "originalRequest": { "url": { "path": [ "v1", "developer", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Page number", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "Items per page", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Search by name, code, or description", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "Filter by product type (This can only be one of PRODUCT,SERVICE)", "type": "text/plain" }, "key": "type", "value": "PRODUCT" }, { "disabled": false, "description": { "content": "Filter by tax type (This can only be one of IVA_0,IVA_RATE,NOT_TAXABLE,EXEMPT)", "type": "text/plain" }, "key": "taxType", "value": "EXEMPT" }, { "disabled": false, "description": { "content": "Filter by active status", "type": "text/plain" }, "key": "isActive", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c627213f-6dd5-4258-9211-bcdd4075893f", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v1", "developer", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Page number", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "Items per page", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "Search by name, code, or description", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "Filter by product type (This can only be one of PRODUCT,SERVICE)", "type": "text/plain" }, "key": "type", "value": "PRODUCT" }, { "disabled": false, "description": { "content": "Filter by tax type (This can only be one of IVA_0,IVA_RATE,NOT_TAXABLE,EXEMPT)", "type": "text/plain" }, "key": "taxType", "value": "EXEMPT" }, { "disabled": false, "description": { "content": "Filter by active status", "type": "text/plain" }, "key": "isActive", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "{id}", "description": "Parámetro de ruta: ID único del comprobante emitido.", "item": [ { "id": "0f21e91e-6924-45d2-a1ce-c9b6f00c49fe", "name": "Obtener producto", "request": { "name": "Obtener producto", "description": { "content": "Devuelve el detalle completo de un producto o servicio específico por su ID.", "type": "text/plain" }, "url": { "path": [ "v1", "developer", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) ID del producto", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-taxpayer-ruc", "value": "{{taxpayerRuc}}" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "321d7029-434a-4b05-826f-a04d1c74e214", "name": "Successful response", "originalRequest": { "url": { "path": [ "v1", "developer", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del producto", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"\",\n \"taxpayerId\": \"\",\n \"code\": \"\",\n \"type\": \"PRODUCT\",\n \"name\": \"\",\n \"unitPrice\": \"\",\n \"taxType\": \"IVA_RATE\",\n \"irbpnr\": \"\",\n \"isActive\": \"\",\n \"createdAt\": \"\",\n \"updatedAt\": \"\",\n \"auxiliaryCode\": {},\n \"description\": {},\n \"iceCode\": {},\n \"iceRate\": {},\n \"unitOfMeasure\": {},\n \"deletedAt\": {}\n },\n \"meta\": {\n \"requestId\": \"\",\n \"timestamp\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0b0030b9-ceaa-4ae4-a7b6-22a77f847067", "name": "Validation error", "originalRequest": { "url": { "path": [ "v1", "developer", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del producto", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e2674ca7-d7a1-43f0-9e30-d01f24dc5dd8", "name": "Authentication required", "originalRequest": { "url": { "path": [ "v1", "developer", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del producto", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a3fb45ca-876c-419c-b37e-7203d06b9556", "name": "Insufficient permissions", "originalRequest": { "url": { "path": [ "v1", "developer", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del producto", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d32f03e1-4fd1-4b2f-8081-21e37de0368b", "name": "Resource not found", "originalRequest": { "url": { "path": [ "v1", "developer", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del producto", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4dc66ab4-6357-4b3b-a17f-3772ca321320", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v1", "developer", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del producto", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8044afbc-796d-499f-a765-82aa816a1b4a", "name": "Actualizar producto", "request": { "name": "Actualizar producto", "description": { "content": "Actualiza uno o más campos de un producto o servicio existente. Solo se actualizan los campos enviados en el body.", "type": "text/plain" }, "url": { "path": [ "v1", "developer", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) ID del producto", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-taxpayer-ruc", "value": "{{taxpayerRuc}}" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"auxiliaryCode\": \" (opcional)\",\n \"type\": \"PRODUCT\",\n \"name\": \"\",\n \"description\": \"\",\n \"unitPrice\": \"\",\n \"taxType\": \"IVA_RATE\",\n \"iceCode\": \"\",\n \"iceRate\": \"\",\n \"irbpnr\": false,\n \"unitOfMeasure\": \"\",\n \"isActive\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "2306f267-84eb-4c54-8644-9aba71ee6210", "name": "Successful response", "originalRequest": { "url": { "path": [ "v1", "developer", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del producto", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"auxiliaryCode\": \" (opcional)\",\n \"type\": \"PRODUCT\",\n \"name\": \"\",\n \"description\": \"\",\n \"unitPrice\": \"\",\n \"taxType\": \"IVA_RATE\",\n \"iceCode\": \"\",\n \"iceRate\": \"\",\n \"irbpnr\": false,\n \"unitOfMeasure\": \"\",\n \"isActive\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"\",\n \"taxpayerId\": \"\",\n \"code\": \"\",\n \"type\": \"PRODUCT\",\n \"name\": \"\",\n \"unitPrice\": \"\",\n \"taxType\": \"IVA_RATE\",\n \"irbpnr\": \"\",\n \"isActive\": \"\",\n \"createdAt\": \"\",\n \"updatedAt\": \"\",\n \"auxiliaryCode\": {},\n \"description\": {},\n \"iceCode\": {},\n \"iceRate\": {},\n \"unitOfMeasure\": {},\n \"deletedAt\": {}\n },\n \"meta\": {\n \"requestId\": \"\",\n \"timestamp\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a13695c7-2c8b-4c85-8a4e-f3577ff0d4a1", "name": "Validation error", "originalRequest": { "url": { "path": [ "v1", "developer", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del producto", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"auxiliaryCode\": \" (opcional)\",\n \"type\": \"PRODUCT\",\n \"name\": \"\",\n \"description\": \"\",\n \"unitPrice\": \"\",\n \"taxType\": \"IVA_RATE\",\n \"iceCode\": \"\",\n \"iceRate\": \"\",\n \"irbpnr\": false,\n \"unitOfMeasure\": \"\",\n \"isActive\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "acc2d08b-9a02-4274-8a8e-5aa34e7b3230", "name": "Authentication required", "originalRequest": { "url": { "path": [ "v1", "developer", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del producto", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"auxiliaryCode\": \" (opcional)\",\n \"type\": \"PRODUCT\",\n \"name\": \"\",\n \"description\": \"\",\n \"unitPrice\": \"\",\n \"taxType\": \"IVA_RATE\",\n \"iceCode\": \"\",\n \"iceRate\": \"\",\n \"irbpnr\": false,\n \"unitOfMeasure\": \"\",\n \"isActive\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d514a48a-9297-47aa-b164-93de6861c97e", "name": "Insufficient permissions", "originalRequest": { "url": { "path": [ "v1", "developer", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del producto", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"auxiliaryCode\": \" (opcional)\",\n \"type\": \"PRODUCT\",\n \"name\": \"\",\n \"description\": \"\",\n \"unitPrice\": \"\",\n \"taxType\": \"IVA_RATE\",\n \"iceCode\": \"\",\n \"iceRate\": \"\",\n \"irbpnr\": false,\n \"unitOfMeasure\": \"\",\n \"isActive\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8275d19e-af15-4d91-b12d-6e2c205f7636", "name": "Resource not found", "originalRequest": { "url": { "path": [ "v1", "developer", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del producto", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"auxiliaryCode\": \" (opcional)\",\n \"type\": \"PRODUCT\",\n \"name\": \"\",\n \"description\": \"\",\n \"unitPrice\": \"\",\n \"taxType\": \"IVA_RATE\",\n \"iceCode\": \"\",\n \"iceRate\": \"\",\n \"irbpnr\": false,\n \"unitOfMeasure\": \"\",\n \"isActive\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eb8f0050-f1b7-45fa-bdc3-009bce2b92bc", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v1", "developer", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del producto", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"auxiliaryCode\": \" (opcional)\",\n \"type\": \"PRODUCT\",\n \"name\": \"\",\n \"description\": \"\",\n \"unitPrice\": \"\",\n \"taxType\": \"IVA_RATE\",\n \"iceCode\": \"\",\n \"iceRate\": \"\",\n \"irbpnr\": false,\n \"unitOfMeasure\": \"\",\n \"isActive\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5f6acb9c-62be-4b0c-8495-3f889497174e", "name": "Eliminar producto", "request": { "name": "Eliminar producto", "description": { "content": "Elimina un producto o servicio del catálogo. Esta acción no afecta los comprobantes ya emitidos con ese producto.", "type": "text/plain" }, "url": { "path": [ "v1", "developer", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) ID del producto", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-taxpayer-ruc", "value": "{{taxpayerRuc}}" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "fb7f52d2-6902-4311-b0e9-43e70d23f3bf", "name": "Successful response", "originalRequest": { "url": { "path": [ "v1", "developer", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del producto", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"message\": \"\"\n },\n \"meta\": {\n \"requestId\": \"\",\n \"timestamp\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "116a2428-18a6-47bd-9a92-09278aa224b0", "name": "Validation error", "originalRequest": { "url": { "path": [ "v1", "developer", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del producto", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "61b7abba-b581-4451-855d-700669aaaea8", "name": "Authentication required", "originalRequest": { "url": { "path": [ "v1", "developer", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del producto", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "83e6a882-b211-4581-8415-40ee1dcf73f0", "name": "Insufficient permissions", "originalRequest": { "url": { "path": [ "v1", "developer", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del producto", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7868d0c1-8992-4173-8166-a6fc737494b2", "name": "Resource not found", "originalRequest": { "url": { "path": [ "v1", "developer", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del producto", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f2b0c3a7-aeff-4202-b8d5-c70d69011167", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v1", "developer", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ID del producto", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": \"\",\n \"message\": \"\",\n \"code\": \"\",\n \"details\": [\n \"\",\n \"\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] } ] } ] } ], "event": [], "variable": [ { "key": "baseUrl", "value": "/" }, { "key": "taxpayerRuc", "value": "0950194407001", "type": "string" } ], "info": { "_postman_id": "ade1bedb-0c0a-4f68-8ec5-dff358fa55ea", "name": "Factuplan API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "Electronic Billing API for Ecuador (SRI)", "type": "text/plain" } } }