{ "info": { "_postman_id": "b1e7c0a2-3f4d-4c8a-9e21-facturator0001", "name": "Facturator API", "description": "Colección oficial de la API REST de Facturación Electrónica (One Soft / Facturator).\n\nTodos los endpoints cuelgan de la URL base del entorno (incluye el prefijo /api) y se autentican con el header X-API-Key, configurado a nivel de colección.\n\nAntes de usarla:\n1. Selecciona un Environment (Sandbox o Producción) o edita la variable `baseUrl`.\n2. Coloca tu clave en la variable `apiKey`.\n3. Ajusta los IDs de ejemplo (`businessId`, `customerId`, etc.) a los de tu cuenta.\n\nDocumentación completa: https://www.factura-tor.com/docs", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://www.facturator.xyz/api", "type": "string" }, { "key": "apiKey", "value": "", "type": "string" }, { "key": "userId", "value": "1", "type": "string" }, { "key": "businessId", "value": "1", "type": "string" }, { "key": "establishmentId", "value": "1", "type": "string" }, { "key": "emissionPointId", "value": "1", "type": "string" }, { "key": "sequenceId", "value": "10", "type": "string" }, { "key": "customerId", "value": "1", "type": "string" }, { "key": "providerId", "value": "1", "type": "string" }, { "key": "carrierId", "value": "1", "type": "string" }, { "key": "itemId", "value": "1", "type": "string" }, { "key": "documentId", "value": "1", "type": "string" }, { "key": "identification", "value": "0993372022001", "type": "string" }, { "key": "catalog", "value": "document-types", "type": "string" }, { "key": "catalogItemId", "value": "1", "type": "string" } ], "item": [ { "name": "Salud", "item": [ { "name": "Root / Health check", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/", "host": [ "{{baseUrl}}" ], "path": [ "" ] } } } ] }, { "name": "Negocios", "item": [ { "name": "Listar negocios", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/businesses?userId={{userId}}", "host": [ "{{baseUrl}}" ], "path": [ "businesses" ], "query": [ { "key": "userId", "value": "{{userId}}" } ] } } }, { "name": "Obtener negocio", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/businesses/{{businessId}}?userId={{userId}}", "host": [ "{{baseUrl}}" ], "path": [ "businesses", "{{businessId}}" ], "query": [ { "key": "userId", "value": "{{userId}}" } ] } } }, { "name": "Crear negocio", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"userId\": 1,\n \"environmentId\": 1,\n \"ruc\": \"0105678901001\",\n \"businessName\": \"Mi Empresa S.A.\",\n \"tradename\": \"Mi Empresa\",\n \"email\": \"contacto@miempresa.com\",\n \"phone\": \"0991234567\",\n \"issuancePointCode\": \"001\",\n \"accounting\": true,\n \"rimpe\": false\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/businesses", "host": [ "{{baseUrl}}" ], "path": [ "businesses" ] } } }, { "name": "Actualizar negocio", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"userId\": 1,\n \"tradename\": \"Mi Empresa Actualizada\",\n \"email\": \"nuevo@miempresa.com\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/businesses/{{businessId}}", "host": [ "{{baseUrl}}" ], "path": [ "businesses", "{{businessId}}" ] } } }, { "name": "Subir firma / logo", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "body": { "mode": "formdata", "formdata": [ { "key": "sign", "type": "file", "src": [], "description": "Archivo .p12 con la firma electronica vigente." }, { "key": "logo", "type": "file", "src": [], "description": "Imagen PNG o JPG del logotipo." } ] }, "url": { "raw": "{{baseUrl}}/businesses/{{businessId}}/files", "host": [ "{{baseUrl}}" ], "path": [ "businesses", "{{businessId}}", "files" ] } } }, { "name": "Verificar firma electronica", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/businesses/{{businessId}}/signature:verify", "host": [ "{{baseUrl}}" ], "path": [ "businesses", "{{businessId}}", "signature:verify" ] } } }, { "name": "Eliminar negocio", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{ \"userId\": 1 }", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/businesses/{{businessId}}", "host": [ "{{baseUrl}}" ], "path": [ "businesses", "{{businessId}}" ] } } } ] }, { "name": "Establecimientos", "item": [ { "name": "Listar establecimientos", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/establishments?businessId={{businessId}}", "host": [ "{{baseUrl}}" ], "path": [ "establishments" ], "query": [ { "key": "businessId", "value": "{{businessId}}" } ] } } }, { "name": "Obtener establecimiento", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/establishments/{{establishmentId}}?businessId={{businessId}}", "host": [ "{{baseUrl}}" ], "path": [ "establishments", "{{establishmentId}}" ], "query": [ { "key": "businessId", "value": "{{businessId}}" } ] } } }, { "name": "Crear establecimiento", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"businessId\": 1,\n \"code\": \"001\",\n \"address\": \"Av. 10 de Agosto N34-123, Quito\",\n \"open\": true,\n \"main\": true\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/establishments", "host": [ "{{baseUrl}}" ], "path": [ "establishments" ] } } }, { "name": "Actualizar establecimiento", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"address\": \"Calle Bolivar 456, Guayaquil\",\n \"open\": false\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/establishments/{{establishmentId}}", "host": [ "{{baseUrl}}" ], "path": [ "establishments", "{{establishmentId}}" ] } } }, { "name": "Eliminar establecimiento", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/establishments/{{establishmentId}}", "host": [ "{{baseUrl}}" ], "path": [ "establishments", "{{establishmentId}}" ] } } } ] }, { "name": "Puntos de Emision", "item": [ { "name": "Listar puntos de emision", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/emission-points?businessId={{businessId}}&establishmentId={{establishmentId}}", "host": [ "{{baseUrl}}" ], "path": [ "emission-points" ], "query": [ { "key": "businessId", "value": "{{businessId}}" }, { "key": "establishmentId", "value": "{{establishmentId}}" } ] } } }, { "name": "Obtener punto de emision", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/emission-points/{{emissionPointId}}?businessId={{businessId}}", "host": [ "{{baseUrl}}" ], "path": [ "emission-points", "{{emissionPointId}}" ], "query": [ { "key": "businessId", "value": "{{businessId}}" } ] } } }, { "name": "Crear punto de emision", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"businessId\": 1,\n \"establishmentId\": 1,\n \"code\": \"002\",\n \"description\": \"Caja 2 - ventanilla norte\",\n \"active\": true\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/emission-points", "host": [ "{{baseUrl}}" ], "path": [ "emission-points" ] } } }, { "name": "Actualizar punto de emision", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"description\": \"Caja 2 - reubicada\",\n \"active\": false\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/emission-points/{{emissionPointId}}", "host": [ "{{baseUrl}}" ], "path": [ "emission-points", "{{emissionPointId}}" ] } } }, { "name": "Desactivar punto de emision", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/emission-points/{{emissionPointId}}", "host": [ "{{baseUrl}}" ], "path": [ "emission-points", "{{emissionPointId}}" ] } } } ] }, { "name": "Secuenciales", "item": [ { "name": "Listar secuenciales", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sequences?businessId={{businessId}}", "host": [ "{{baseUrl}}" ], "path": [ "sequences" ], "query": [ { "key": "businessId", "value": "{{businessId}}" } ] } } }, { "name": "Obtener secuencial", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sequences/{{sequenceId}}?businessId={{businessId}}", "host": [ "{{baseUrl}}" ], "path": [ "sequences", "{{sequenceId}}" ], "query": [ { "key": "businessId", "value": "{{businessId}}" } ] } } }, { "name": "Actualizar valor del secuencial", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{ \"value\": 100 }", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/sequences/{{sequenceId}}", "host": [ "{{baseUrl}}" ], "path": [ "sequences", "{{sequenceId}}" ] } } } ] }, { "name": "Clientes", "item": [ { "name": "Listar clientes", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/customers?businessId={{businessId}}", "host": [ "{{baseUrl}}" ], "path": [ "customers" ], "query": [ { "key": "businessId", "value": "{{businessId}}" }, { "key": "page", "value": "1", "description": "Numero de pagina. Por defecto 1.", "disabled": true }, { "key": "perPage", "value": "25", "description": "Tamano de pagina. Por defecto 25, maximo 100. Alias: limit.", "disabled": true }, { "key": "sortBy", "value": "", "description": "Campo de ordenamiento (whitelist por recurso). Ver /docs/pagination-filtering.", "disabled": true }, { "key": "sortDir", "value": "desc", "description": "Sentido: asc o desc.", "disabled": true }, { "key": "search", "value": "", "description": "Busqueda parcial sobre identificacion, razon social y correo.", "disabled": true }, { "key": "identificationTypeId", "value": "", "description": "Filtra por tipo de identificacion.", "disabled": true }, { "key": "ids", "value": "", "description": "Lista de IDs separados por coma.", "disabled": true } ] }, "description": "\n\nColeccion paginada: sin page ni perPage devuelve la primera pagina de 25 registros y un bloque meta { currentPage, perPage, total, lastPage }. Los parametros deshabilitados de abajo son los filtros disponibles." } }, { "name": "Obtener cliente", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/customers/{{customerId}}?businessId={{businessId}}", "host": [ "{{baseUrl}}" ], "path": [ "customers", "{{customerId}}" ], "query": [ { "key": "businessId", "value": "{{businessId}}" } ] } } }, { "name": "Buscar cliente por identificacion", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/customers/search/{{identification}}", "host": [ "{{baseUrl}}" ], "path": [ "customers", "search", "{{identification}}" ] } } }, { "name": "Crear cliente", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"businessId\": 1,\n \"identificationTypeId\": 1,\n \"identification\": \"0105678901\",\n \"businessName\": \"Juan Perez\",\n \"address\": \"Av. Principal 123, Quito\",\n \"phoneNumber\": \"022345678\",\n \"cellphone\": \"0991234567\",\n \"email\": \"juan.perez@email.com\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/customers", "host": [ "{{baseUrl}}" ], "path": [ "customers" ] } } }, { "name": "Actualizar cliente", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"businessName\": \"Juan Carlos Perez\",\n \"email\": \"jcperez@email.com\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/customers/{{customerId}}", "host": [ "{{baseUrl}}" ], "path": [ "customers", "{{customerId}}" ] } } }, { "name": "Eliminar cliente", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{ \"businessId\": 1 }", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/customers/{{customerId}}", "host": [ "{{baseUrl}}" ], "path": [ "customers", "{{customerId}}" ] } } } ] }, { "name": "Proveedores", "item": [ { "name": "Listar proveedores", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/providers?businessId={{businessId}}", "host": [ "{{baseUrl}}" ], "path": [ "providers" ], "query": [ { "key": "businessId", "value": "{{businessId}}" }, { "key": "page", "value": "1", "description": "Numero de pagina. Por defecto 1.", "disabled": true }, { "key": "perPage", "value": "25", "description": "Tamano de pagina. Por defecto 25, maximo 100. Alias: limit.", "disabled": true }, { "key": "sortBy", "value": "", "description": "Campo de ordenamiento (whitelist por recurso). Ver /docs/pagination-filtering.", "disabled": true }, { "key": "sortDir", "value": "desc", "description": "Sentido: asc o desc.", "disabled": true }, { "key": "search", "value": "", "description": "Busqueda parcial sobre identificacion, razon social y correo.", "disabled": true }, { "key": "identificationTypeId", "value": "", "description": "Filtra por tipo de identificacion.", "disabled": true }, { "key": "ids", "value": "", "description": "Lista de IDs separados por coma.", "disabled": true } ] }, "description": "\n\nColeccion paginada: sin page ni perPage devuelve la primera pagina de 25 registros y un bloque meta { currentPage, perPage, total, lastPage }. Los parametros deshabilitados de abajo son los filtros disponibles." } }, { "name": "Obtener proveedor", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/providers/{{providerId}}?businessId={{businessId}}", "host": [ "{{baseUrl}}" ], "path": [ "providers", "{{providerId}}" ], "query": [ { "key": "businessId", "value": "{{businessId}}" } ] } } }, { "name": "Buscar proveedor por identificacion", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/providers/search/{{identification}}", "host": [ "{{baseUrl}}" ], "path": [ "providers", "search", "{{identification}}" ] } } }, { "name": "Crear proveedor", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"businessId\": 1,\n \"identificationTypeId\": 1,\n \"identification\": \"0105678901\",\n \"businessName\": \"Proveedor S.A.\",\n \"address\": \"Av. Principal 123, Quito\",\n \"cellphone\": \"0991234567\",\n \"email\": \"ventas@proveedor.com\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/providers", "host": [ "{{baseUrl}}" ], "path": [ "providers" ] } } }, { "name": "Actualizar proveedor", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"businessName\": \"Proveedor Andino S.A.\",\n \"email\": \"facturacion@proveedor.com\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/providers/{{providerId}}", "host": [ "{{baseUrl}}" ], "path": [ "providers", "{{providerId}}" ] } } }, { "name": "Eliminar proveedor", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{ \"businessId\": 1 }", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/providers/{{providerId}}", "host": [ "{{baseUrl}}" ], "path": [ "providers", "{{providerId}}" ] } } } ] }, { "name": "Transportistas", "item": [ { "name": "Listar transportistas", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/carriers?businessId={{businessId}}", "host": [ "{{baseUrl}}" ], "path": [ "carriers" ], "query": [ { "key": "businessId", "value": "{{businessId}}" }, { "key": "page", "value": "1", "description": "Numero de pagina. Por defecto 1.", "disabled": true }, { "key": "perPage", "value": "25", "description": "Tamano de pagina. Por defecto 25, maximo 100. Alias: limit.", "disabled": true }, { "key": "sortBy", "value": "", "description": "Campo de ordenamiento (whitelist por recurso). Ver /docs/pagination-filtering.", "disabled": true }, { "key": "sortDir", "value": "desc", "description": "Sentido: asc o desc.", "disabled": true }, { "key": "search", "value": "", "description": "Busqueda parcial sobre identificacion, razon social y correo.", "disabled": true }, { "key": "identificationTypeId", "value": "", "description": "Filtra por tipo de identificacion.", "disabled": true }, { "key": "ids", "value": "", "description": "Lista de IDs separados por coma.", "disabled": true } ] }, "description": "\n\nColeccion paginada: sin page ni perPage devuelve la primera pagina de 25 registros y un bloque meta { currentPage, perPage, total, lastPage }. Los parametros deshabilitados de abajo son los filtros disponibles." } }, { "name": "Obtener transportista", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/carriers/{{carrierId}}?businessId={{businessId}}", "host": [ "{{baseUrl}}" ], "path": [ "carriers", "{{carrierId}}" ], "query": [ { "key": "businessId", "value": "{{businessId}}" } ] } } }, { "name": "Buscar transportista por identificacion", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/carriers/search/{{identification}}", "host": [ "{{baseUrl}}" ], "path": [ "carriers", "search", "{{identification}}" ] } } }, { "name": "Crear transportista", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"businessId\": 1,\n \"identificationTypeId\": 1,\n \"identification\": \"0105678901\",\n \"businessName\": \"Logistica Andina\",\n \"address\": \"Via Daule km 14, Guayaquil\",\n \"cellphone\": \"0991234567\",\n \"email\": \"operaciones@logisticaandina.com\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/carriers", "host": [ "{{baseUrl}}" ], "path": [ "carriers" ] } } }, { "name": "Actualizar transportista", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"businessName\": \"Logistica Andina Cia. Ltda.\",\n \"email\": \"contacto@logisticaandina.com\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/carriers/{{carrierId}}", "host": [ "{{baseUrl}}" ], "path": [ "carriers", "{{carrierId}}" ] } } }, { "name": "Eliminar transportista", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{ \"businessId\": 1 }", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/carriers/{{carrierId}}", "host": [ "{{baseUrl}}" ], "path": [ "carriers", "{{carrierId}}" ] } } } ] }, { "name": "Productos / Servicios", "item": [ { "name": "Listar items", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/items?businessId={{businessId}}", "host": [ "{{baseUrl}}" ], "path": [ "items" ], "query": [ { "key": "businessId", "value": "{{businessId}}" }, { "key": "page", "value": "1", "description": "Numero de pagina. Por defecto 1.", "disabled": true }, { "key": "perPage", "value": "25", "description": "Tamano de pagina. Por defecto 25, maximo 100. Alias: limit.", "disabled": true }, { "key": "sortBy", "value": "", "description": "Campo de ordenamiento (whitelist por recurso). Ver /docs/pagination-filtering.", "disabled": true }, { "key": "sortDir", "value": "desc", "description": "Sentido: asc o desc.", "disabled": true }, { "key": "search", "value": "", "description": "Busqueda parcial sobre nombre, codigo y codigo auxiliar.", "disabled": true }, { "key": "itemTypeId", "value": "", "description": "Filtra por tipo de producto/servicio.", "disabled": true }, { "key": "ids", "value": "", "description": "Lista de IDs separados por coma.", "disabled": true } ] }, "description": "\n\nColeccion paginada: sin page ni perPage devuelve la primera pagina de 25 registros y un bloque meta { currentPage, perPage, total, lastPage }. Los parametros deshabilitados de abajo son los filtros disponibles." } }, { "name": "Obtener item", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/items/{{itemId}}?businessId={{businessId}}", "host": [ "{{baseUrl}}" ], "path": [ "items", "{{itemId}}" ], "query": [ { "key": "businessId", "value": "{{businessId}}" } ] } } }, { "name": "Crear item", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"businessId\": 1,\n \"itemTypeId\": 1,\n \"taxId\": 1,\n \"name\": \"Servicio de Consultoria\",\n \"defaultTax\": true,\n \"code\": \"SRV001\",\n \"auxCode\": \"AUX001\",\n \"unitPrice\": 150.00\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/items", "host": [ "{{baseUrl}}" ], "path": [ "items" ] } } }, { "name": "Actualizar item", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"Servicio de Auditoria\",\n \"unitPrice\": 200.00\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/items/{{itemId}}", "host": [ "{{baseUrl}}" ], "path": [ "items", "{{itemId}}" ] } } }, { "name": "Eliminar item", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/items/{{itemId}}", "host": [ "{{baseUrl}}" ], "path": [ "items", "{{itemId}}" ] } } } ] }, { "name": "Comprobantes", "item": [ { "name": "Listar documentos", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/documents?businessId={{businessId}}", "host": [ "{{baseUrl}}" ], "path": [ "documents" ], "query": [ { "key": "businessId", "value": "{{businessId}}" }, { "key": "page", "value": "1", "description": "Numero de pagina. Por defecto 1.", "disabled": true }, { "key": "perPage", "value": "25", "description": "Tamano de pagina. Por defecto 25, maximo 100. Alias: limit.", "disabled": true }, { "key": "sortBy", "value": "", "description": "Campo de ordenamiento (whitelist por recurso). Ver /docs/pagination-filtering.", "disabled": true }, { "key": "sortDir", "value": "desc", "description": "Sentido: asc o desc.", "disabled": true }, { "key": "search", "value": "", "description": "Busqueda parcial sobre numero, clave de acceso y cliente.", "disabled": true }, { "key": "number", "value": "", "description": "Coincidencia parcial por numero.", "disabled": true }, { "key": "accessKey", "value": "", "description": "Coincidencia exacta por clave de acceso.", "disabled": true }, { "key": "documentTypeCode", "value": "", "description": "Codigo del tipo de comprobante (01,03,04,05,06,07).", "disabled": true }, { "key": "documentStateAcronym", "value": "", "description": "Estado: CRD, PPR, SND, REC, DVL, AUT, NAT.", "disabled": true }, { "key": "establishmentId", "value": "", "description": "Filtra por establecimiento.", "disabled": true }, { "key": "emissionPointId", "value": "", "description": "Filtra por punto de emision.", "disabled": true }, { "key": "entityId", "value": "", "description": "Filtra por cliente.", "disabled": true }, { "key": "dateFrom", "value": "", "description": "Fecha desde, formato Y-m-d.", "disabled": true }, { "key": "dateTo", "value": "", "description": "Fecha hasta, formato Y-m-d.", "disabled": true }, { "key": "view", "value": "summary", "description": "Usa summary para una proyeccion liviana sin items ni impuestos.", "disabled": true } ] }, "description": "\n\nColeccion paginada: sin page ni perPage devuelve la primera pagina de 25 registros y un bloque meta { currentPage, perPage, total, lastPage }. Los parametros deshabilitados de abajo son los filtros disponibles." } }, { "name": "Obtener documento", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/documents/{{documentId}}?businessId={{businessId}}", "host": [ "{{baseUrl}}" ], "path": [ "documents", "{{documentId}}" ], "query": [ { "key": "businessId", "value": "{{businessId}}" } ] } } }, { "name": "Crear Factura (01) y emitir", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"business_id\": 1,\n \"customer_id\": 1,\n \"document_type_id\": 1,\n \"document_type_code\": \"01\",\n \"emission_type_id\": 1,\n \"establishment_id\": 1,\n \"emission_point_id\": 2,\n \"payment_method_id\": 1,\n \"date\": \"2026-02-20\",\n \"detail\": \"Factura de servicios profesionales\",\n \"items\": [\n { \"item_id\": 1, \"discount\": 0, \"amount\": 2, \"price\": 500.00, \"detail\": \"Servicio de consultoria mensual\" }\n ],\n \"emit\": true\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/documents", "host": [ "{{baseUrl}}" ], "path": [ "documents" ] } } }, { "name": "Crear Factura (01) borrador", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"business_id\": 1,\n \"customer_id\": 1,\n \"document_type_id\": 1,\n \"document_type_code\": \"01\",\n \"emission_type_id\": 1,\n \"establishment_id\": 1,\n \"payment_method_id\": 1,\n \"date\": \"2026-02-20\",\n \"detail\": \"Factura borrador\",\n \"items\": [\n { \"item_id\": 1, \"amount\": 1, \"price\": 500.00 }\n ],\n \"emit\": false\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/documents", "host": [ "{{baseUrl}}" ], "path": [ "documents" ] } } }, { "name": "Crear Nota de Credito (04)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"business_id\": 1,\n \"customer_id\": 1,\n \"document_type_id\": 2,\n \"document_type_code\": \"04\",\n \"emission_type_id\": 1,\n \"establishment_id\": 1,\n \"payment_method_id\": 1,\n \"date\": \"2026-02-20\",\n \"detail\": \"Anulacion parcial de factura\",\n \"modified_document_code\": \"01\",\n \"modified_document_number\": \"001-001-000000045\",\n \"modified_document_date\": \"2026-02-15\",\n \"reason\": \"Devolucion de producto defectuoso\",\n \"items\": [\n { \"item_id\": 1, \"amount\": 1, \"price\": 200.00, \"detail\": \"Producto devuelto\" }\n ],\n \"emit\": true\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/documents", "host": [ "{{baseUrl}}" ], "path": [ "documents" ] } } }, { "name": "Crear Nota de Debito (05)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"business_id\": 1,\n \"customer_id\": 1,\n \"document_type_id\": 3,\n \"document_type_code\": \"05\",\n \"emission_type_id\": 1,\n \"establishment_id\": 1,\n \"payment_method_id\": 1,\n \"date\": \"2026-02-20\",\n \"detail\": \"Cobro adicional por intereses\",\n \"modified_document_code\": \"01\",\n \"modified_document_number\": \"001-001-000000045\",\n \"modified_document_date\": \"2026-02-15\",\n \"reason\": \"Cobro de intereses por mora\",\n \"items\": [\n { \"item_id\": 1, \"amount\": 1, \"price\": 50.00, \"detail\": \"Intereses por mora\", \"debit_reason\": \"Intereses por mora\", \"debit_value\": 50.00 }\n ],\n \"emit\": true\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/documents", "host": [ "{{baseUrl}}" ], "path": [ "documents" ] } } }, { "name": "Crear Liquidacion de Compra (03)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"business_id\": 1,\n \"customer_id\": 1,\n \"document_type_id\": 6,\n \"document_type_code\": \"03\",\n \"emission_type_id\": 1,\n \"establishment_id\": 1,\n \"payment_method_id\": 1,\n \"date\": \"2026-02-20\",\n \"detail\": \"Compra a persona natural no obligada a llevar contabilidad\",\n \"provider_entity_id\": 1,\n \"items\": [\n { \"item_id\": 1, \"amount\": 10, \"price\": 10.00, \"detail\": \"Sacos de abono\" }\n ],\n \"emit\": true\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/documents", "host": [ "{{baseUrl}}" ], "path": [ "documents" ] } } }, { "name": "Crear Guia de Remision (06)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"business_id\": 1,\n \"customer_id\": 1,\n \"document_type_id\": 4,\n \"document_type_code\": \"06\",\n \"emission_type_id\": 1,\n \"establishment_id\": 1,\n \"payment_method_id\": 1,\n \"date\": \"2026-02-20\",\n \"detail\": \"Traslado de mercaderia a sucursal Guayaquil\",\n \"departure_address\": \"Av. Amazonas N24-150, Quito\",\n \"carrier_entity_id\": 1,\n \"transport_start_date\": \"2026-02-21\",\n \"transport_end_date\": \"2026-02-22\",\n \"vehicle_plate\": \"ABC-1234\",\n \"transfer_reason\": \"Traslado entre sucursales\",\n \"items\": [\n { \"item_id\": 1, \"amount\": 50, \"price\": 10.00, \"detail\": \"Cajas de producto\" }\n ],\n \"emit\": true\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/documents", "host": [ "{{baseUrl}}" ], "path": [ "documents" ] } } }, { "name": "Crear Comprobante de Retencion (07)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"business_id\": 1,\n \"customer_id\": 1,\n \"document_type_id\": 5,\n \"document_type_code\": \"07\",\n \"emission_type_id\": 1,\n \"establishment_id\": 1,\n \"payment_method_id\": 1,\n \"date\": \"2026-02-20\",\n \"detail\": \"Retencion en la fuente e IVA\",\n \"related_party\": false,\n \"payment_location_id\": 1,\n \"items\": [\n {\n \"item_id\": 1, \"amount\": 1, \"price\": 1000,\n \"detail\": \"Retencion IR 1%\",\n \"retention_tax_type_id\": 1,\n \"retention_code_id\": 15,\n \"retention_percentage\": 2.00,\n \"retention_value\": 20.00,\n \"support_document_type_id\": 1,\n \"support_document_number\": \"001-001-000000045\",\n \"support_document_date\": \"2026-02-15\",\n \"sustain_code_id\": 1,\n \"support_document_subtotal\": 1000.00,\n \"support_document_tax_id\": 4,\n \"support_document_tax_value\": 150.00\n }\n ],\n \"emit\": true\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/documents", "host": [ "{{baseUrl}}" ], "path": [ "documents" ] } } }, { "name": "Emitir borrador existente", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{ \"emit\": true }", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/documents/{{documentId}}", "host": [ "{{baseUrl}}" ], "path": [ "documents", "{{documentId}}" ] } } }, { "name": "Verificar estado en el SRI", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{ \"verify\": true }", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/documents/{{documentId}}", "host": [ "{{baseUrl}}" ], "path": [ "documents", "{{documentId}}" ] } } }, { "name": "Eliminar documento (borrador)", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/documents/{{documentId}}", "host": [ "{{baseUrl}}" ], "path": [ "documents", "{{documentId}}" ] } } }, { "name": "Descargar comprobante (PDF / XML)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/documents/{{documentId}}/download?format=pdf", "host": [ "{{baseUrl}}" ], "path": [ "documents", "{{documentId}}", "download" ], "query": [ { "key": "format", "value": "pdf", "description": "pdf (por defecto) o xml." } ] } } }, { "name": "Enviar comprobante por email", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/documents/{{documentId}}/email:send", "host": [ "{{baseUrl}}" ], "path": [ "documents", "{{documentId}}", "email:send" ] } } } ] }, { "name": "Catalogos SRI", "item": [ { "name": "Listar catalogo", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/catalogs/{{catalog}}", "host": [ "{{baseUrl}}" ], "path": [ "catalogs", "{{catalog}}" ] } } }, { "name": "Obtener item de catalogo", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/catalogs/{{catalog}}/{{catalogItemId}}", "host": [ "{{baseUrl}}" ], "path": [ "catalogs", "{{catalog}}", "{{catalogItemId}}" ] } } } ] } ] }