{ "info": { "name": "FactuLink API", "description": "Coleccion oficial de la API de FactuLink para facturacion electronica en Mexico (CFDI 4.0).\n\nBase URL: https://api.factulink.com.mx/api/v1\n\nEl prefijo de tu API Key determina el ambiente:\n- sk_test_ = sandbox\n- sk_live_ = produccion\n\nDocumentacion completa: https://docs.factulink.com.mx", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{api_key}}", "type": "string" } ] }, "variable": [ { "key": "base_url", "value": "https://api.factulink.com.mx/api/v1", "type": "string" }, { "key": "api_key", "value": "sk_test_your_key_here", "type": "string" }, { "key": "access_token", "value": "", "type": "string" } ], "item": [ { "name": "Auth", "description": "Endpoints para autenticacion con JWT y gestion de sesiones.", "item": [ { "name": "Login", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "const res = pm.response.json();", "if (res.access_token) {", " pm.collectionVariables.set('access_token', res.access_token);", " console.log('access_token saved to collection variables');", "}", "pm.test('Status code is 200', function () {", " pm.response.to.have.status(200);", "});" ] } } ], "request": { "auth": { "type": "noauth" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"email\": \"admin@example.com\",\n \"password\": \"your_password_here\"\n}" }, "url": { "raw": "{{base_url}}/auth/login", "host": ["{{base_url}}"], "path": ["auth", "login"] }, "description": "Autenticar con email y password. Retorna un access_token JWT y un refresh_token.\n\nEl test script guarda automaticamente el access_token en las variables de la coleccion." } }, { "name": "Refresh Token", "request": { "auth": { "type": "noauth" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"refresh_token\": \"your_refresh_token_here\"\n}" }, "url": { "raw": "{{base_url}}/auth/refresh", "host": ["{{base_url}}"], "path": ["auth", "refresh"] }, "description": "Renovar access token usando el refresh token." } }, { "name": "Get Current User", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{access_token}}" } ], "url": { "raw": "{{base_url}}/auth/me", "host": ["{{base_url}}"], "path": ["auth", "me"] }, "description": "Obtener el perfil del usuario autenticado." } } ] }, { "name": "API Keys", "description": "Endpoints para crear y gestionar API Keys. Requieren autenticacion JWT con rol ADMIN.", "item": [ { "name": "Create API Key", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{access_token}}" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"Mi API Key de prueba\",\n \"environment\": \"test\"\n}" }, "url": { "raw": "{{base_url}}/api-keys", "host": ["{{base_url}}"], "path": ["api-keys"] }, "description": "Crear una nueva API Key. Requiere rol ADMIN. La key completa solo se muestra una vez en la respuesta." } }, { "name": "List API Keys", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{access_token}}" } ], "url": { "raw": "{{base_url}}/api-keys", "host": ["{{base_url}}"], "path": ["api-keys"] }, "description": "Listar todas las API Keys del tenant." } }, { "name": "Revoke API Key", "request": { "method": "DELETE", "header": [ { "key": "Authorization", "value": "Bearer {{access_token}}" } ], "url": { "raw": "{{base_url}}/api-keys/:id", "host": ["{{base_url}}"], "path": ["api-keys", ":id"], "variable": [ { "key": "id", "value": "api_key_id_here", "description": "ID de la API Key a revocar" } ] }, "description": "Revocar una API Key existente." } } ] }, { "name": "CFDIs", "description": "Endpoints para emitir, consultar, cancelar y descargar comprobantes fiscales digitales (CFDI 4.0).", "item": [ { "name": "Emit CFDI", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "body": { "mode": "raw", "raw": "{\n \"tipo_comprobante\": \"I\",\n \"serie\": \"A\",\n \"moneda\": \"MXN\",\n \"forma_pago\": \"03\",\n \"metodo_pago\": \"PUE\",\n \"uso_cfdi\": \"G03\",\n \"receptor\": {\n \"rfc\": \"XAXX010101000\",\n \"nombre\": \"Cliente de Prueba SA de CV\",\n \"domicilio_fiscal_receptor\": \"06600\",\n \"regimen_fiscal_receptor\": \"601\"\n },\n \"conceptos\": [\n {\n \"clave_prod_serv\": \"84111506\",\n \"cantidad\": 1,\n \"clave_unidad\": \"E48\",\n \"descripcion\": \"Servicio de consultoria\",\n \"valor_unitario\": 1000.00,\n \"objeto_imp\": \"02\",\n \"impuestos\": {\n \"traslados\": [\n {\n \"base\": 1000.00,\n \"impuesto\": \"002\",\n \"tipo_factor\": \"Tasa\",\n \"tasa_o_cuota\": 0.160000,\n \"importe\": 160.00\n }\n ]\n }\n }\n ]\n}" }, "url": { "raw": "{{base_url}}/cfdis", "host": ["{{base_url}}"], "path": ["cfdis"] }, "description": "Emitir un nuevo CFDI (Ingreso, Egreso o Traslado). Ejemplo con tipo Ingreso (I) incluyendo IVA 16%." } }, { "name": "List CFDIs", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "url": { "raw": "{{base_url}}/cfdis?limit=20&status=vigente", "host": ["{{base_url}}"], "path": ["cfdis"], "query": [ { "key": "limit", "value": "20", "description": "Numero de resultados por pagina (max 100)" }, { "key": "status", "value": "vigente", "description": "Filtrar por status: vigente, cancelado, en_proceso" }, { "key": "tipo_comprobante", "value": "I", "description": "Filtrar por tipo: I (Ingreso), E (Egreso), T (Traslado)", "disabled": true }, { "key": "rfc_receptor", "value": "", "description": "Filtrar por RFC del receptor", "disabled": true }, { "key": "fecha_inicio", "value": "", "description": "Fecha inicio (ISO 8601)", "disabled": true }, { "key": "fecha_fin", "value": "", "description": "Fecha fin (ISO 8601)", "disabled": true }, { "key": "cursor", "value": "", "description": "Cursor para paginacion", "disabled": true } ] }, "description": "Listar CFDIs con cursor pagination. Soporta filtros por status, tipo, RFC receptor y rango de fechas." } }, { "name": "CFDI Detail", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "url": { "raw": "{{base_url}}/cfdis/:uuid", "host": ["{{base_url}}"], "path": ["cfdis", ":uuid"], "variable": [ { "key": "uuid", "value": "cfdi_uuid_here", "description": "UUID del CFDI" } ] }, "description": "Obtener el detalle completo de un CFDI por su UUID." } }, { "name": "Cancel CFDI", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "body": { "mode": "raw", "raw": "{\n \"motivo\": \"02\",\n \"folio_sustitucion\": \"\"\n}" }, "url": { "raw": "{{base_url}}/cfdis/:uuid/cancel", "host": ["{{base_url}}"], "path": ["cfdis", ":uuid", "cancel"], "variable": [ { "key": "uuid", "value": "cfdi_uuid_here", "description": "UUID del CFDI a cancelar" } ] }, "description": "Cancelar un CFDI vigente. Requiere motivo de cancelacion del catalogo SAT.\n\nMotivos:\n- 01: Comprobante emitido con errores con relacion\n- 02: Comprobante emitido con errores sin relacion\n- 03: No se llevo a cabo la operacion\n- 04: Operacion nominativa relacionada en la factura global" } }, { "name": "Download XML", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "url": { "raw": "{{base_url}}/cfdis/:uuid/xml", "host": ["{{base_url}}"], "path": ["cfdis", ":uuid", "xml"], "variable": [ { "key": "uuid", "value": "cfdi_uuid_here", "description": "UUID del CFDI" } ] }, "description": "Descargar el XML timbrado del CFDI." } }, { "name": "Download PDF", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "url": { "raw": "{{base_url}}/cfdis/:uuid/pdf", "host": ["{{base_url}}"], "path": ["cfdis", ":uuid", "pdf"], "variable": [ { "key": "uuid", "value": "cfdi_uuid_here", "description": "UUID del CFDI" } ] }, "description": "Descargar la representacion impresa (PDF) del CFDI." } }, { "name": "SAT Status", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "url": { "raw": "{{base_url}}/cfdis/:uuid/sat-status", "host": ["{{base_url}}"], "path": ["cfdis", ":uuid", "sat-status"], "variable": [ { "key": "uuid", "value": "cfdi_uuid_here", "description": "UUID del CFDI" } ] }, "description": "Consultar el estatus del CFDI directamente en el SAT." } }, { "name": "Validate CFDI", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "body": { "mode": "raw", "raw": "{\n \"tipo_comprobante\": \"I\",\n \"serie\": \"A\",\n \"moneda\": \"MXN\",\n \"forma_pago\": \"03\",\n \"metodo_pago\": \"PUE\",\n \"uso_cfdi\": \"G03\",\n \"receptor\": {\n \"rfc\": \"XAXX010101000\",\n \"nombre\": \"Cliente de Prueba SA de CV\",\n \"domicilio_fiscal_receptor\": \"06600\",\n \"regimen_fiscal_receptor\": \"601\"\n },\n \"conceptos\": [\n {\n \"clave_prod_serv\": \"84111506\",\n \"cantidad\": 1,\n \"clave_unidad\": \"E48\",\n \"descripcion\": \"Servicio de consultoria\",\n \"valor_unitario\": 1000.00,\n \"objeto_imp\": \"02\",\n \"impuestos\": {\n \"traslados\": [\n {\n \"base\": 1000.00,\n \"impuesto\": \"002\",\n \"tipo_factor\": \"Tasa\",\n \"tasa_o_cuota\": 0.160000,\n \"importe\": 160.00\n }\n ]\n }\n }\n ]\n}" }, "url": { "raw": "{{base_url}}/cfdis/validate", "host": ["{{base_url}}"], "path": ["cfdis", "validate"] }, "description": "Pre-validar un CFDI sin timbrarlo. Util para detectar errores antes de emitir." } } ] }, { "name": "Clients", "description": "Endpoints para gestionar el directorio de clientes (receptores de CFDIs).", "item": [ { "name": "Create Client", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "body": { "mode": "raw", "raw": "{\n \"rfc\": \"XAXX010101000\",\n \"nombre\": \"Cliente de Prueba SA de CV\",\n \"domicilio_fiscal\": \"06600\",\n \"regimen_fiscal\": \"601\",\n \"uso_cfdi\": \"G03\",\n \"email\": \"cliente@example.com\"\n}" }, "url": { "raw": "{{base_url}}/clients", "host": ["{{base_url}}"], "path": ["clients"] }, "description": "Crear un nuevo cliente con sus datos fiscales." } }, { "name": "List Clients", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "url": { "raw": "{{base_url}}/clients?limit=20", "host": ["{{base_url}}"], "path": ["clients"], "query": [ { "key": "limit", "value": "20", "description": "Numero de resultados por pagina" }, { "key": "search", "value": "", "description": "Buscar por RFC o nombre", "disabled": true } ] }, "description": "Listar clientes del tenant. Soporta busqueda por RFC y nombre." } }, { "name": "Client Detail", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "url": { "raw": "{{base_url}}/clients/:id", "host": ["{{base_url}}"], "path": ["clients", ":id"], "variable": [ { "key": "id", "value": "client_id_here", "description": "ID del cliente" } ] }, "description": "Obtener el detalle de un cliente." } }, { "name": "Update Client", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "body": { "mode": "raw", "raw": "{\n \"nombre\": \"Cliente Actualizado SA de CV\",\n \"email\": \"nuevo@example.com\"\n}" }, "url": { "raw": "{{base_url}}/clients/:id", "host": ["{{base_url}}"], "path": ["clients", ":id"], "variable": [ { "key": "id", "value": "client_id_here", "description": "ID del cliente" } ] }, "description": "Actualizar los datos de un cliente existente." } }, { "name": "Delete Client", "request": { "method": "DELETE", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "url": { "raw": "{{base_url}}/clients/:id", "host": ["{{base_url}}"], "path": ["clients", ":id"], "variable": [ { "key": "id", "value": "client_id_here", "description": "ID del cliente a eliminar" } ] }, "description": "Eliminar un cliente del directorio." } } ] }, { "name": "CSDs", "description": "Endpoints para gestionar los Certificados de Sello Digital (CSD) necesarios para firmar CFDIs.", "item": [ { "name": "Upload CSD", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "body": { "mode": "formdata", "formdata": [ { "key": "cer", "type": "file", "src": "", "description": "Archivo .cer del certificado" }, { "key": "key", "type": "file", "src": "", "description": "Archivo .key de la llave privada" }, { "key": "password", "value": "your_csd_password", "type": "text", "description": "Password de la llave privada" } ] }, "url": { "raw": "{{base_url}}/csds", "host": ["{{base_url}}"], "path": ["csds"] }, "description": "Subir un nuevo CSD (archivos .cer y .key via multipart/form-data). El password se usa para verificar y cifrar la llave privada." } }, { "name": "List CSDs", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "url": { "raw": "{{base_url}}/csds", "host": ["{{base_url}}"], "path": ["csds"] }, "description": "Listar los CSDs del tenant con su estado y vigencia." } }, { "name": "Update CSD", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "body": { "mode": "raw", "raw": "{\n \"active\": true\n}" }, "url": { "raw": "{{base_url}}/csds/:id", "host": ["{{base_url}}"], "path": ["csds", ":id"], "variable": [ { "key": "id", "value": "csd_id_here", "description": "ID del CSD" } ] }, "description": "Activar o desactivar un CSD." } }, { "name": "Delete CSD", "request": { "method": "DELETE", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "url": { "raw": "{{base_url}}/csds/:id", "host": ["{{base_url}}"], "path": ["csds", ":id"], "variable": [ { "key": "id", "value": "csd_id_here", "description": "ID del CSD a eliminar" } ] }, "description": "Eliminar un CSD del sistema." } } ] }, { "name": "Catalogs", "description": "Endpoints de solo lectura para consultar los catalogos oficiales del SAT.", "item": [ { "name": "Search Products", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "url": { "raw": "{{base_url}}/catalogs/claves-prod-serv?q=consultoria&limit=10", "host": ["{{base_url}}"], "path": ["catalogs", "claves-prod-serv"], "query": [ { "key": "q", "value": "consultoria", "description": "Busqueda full-text por descripcion" }, { "key": "limit", "value": "10", "description": "Numero de resultados" } ] }, "description": "Buscar claves de producto/servicio del SAT. Soporta busqueda full-text por descripcion." } }, { "name": "List Regimenes", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "url": { "raw": "{{base_url}}/catalogs/regimenes", "host": ["{{base_url}}"], "path": ["catalogs", "regimenes"] }, "description": "Listar regimenes fiscales vigentes del catalogo SAT." } }, { "name": "List Usos CFDI", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "url": { "raw": "{{base_url}}/catalogs/usos-cfdi", "host": ["{{base_url}}"], "path": ["catalogs", "usos-cfdi"] }, "description": "Listar usos de CFDI permitidos." } }, { "name": "List Formas de Pago", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "url": { "raw": "{{base_url}}/catalogs/formas-pago", "host": ["{{base_url}}"], "path": ["catalogs", "formas-pago"] }, "description": "Listar formas de pago (efectivo, transferencia, etc.)." } }, { "name": "List Metodos de Pago", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "url": { "raw": "{{base_url}}/catalogs/metodos-pago", "host": ["{{base_url}}"], "path": ["catalogs", "metodos-pago"] }, "description": "Listar metodos de pago (PUE, PPD)." } }, { "name": "List Monedas", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "url": { "raw": "{{base_url}}/catalogs/monedas", "host": ["{{base_url}}"], "path": ["catalogs", "monedas"] }, "description": "Listar monedas soportadas (MXN, USD, etc.)." } }, { "name": "List Claves Unidad", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "url": { "raw": "{{base_url}}/catalogs/claves-unidad", "host": ["{{base_url}}"], "path": ["catalogs", "claves-unidad"] }, "description": "Listar claves de unidad de medida." } }, { "name": "List Motivos Cancelacion", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "url": { "raw": "{{base_url}}/catalogs/motivos-cancelacion", "host": ["{{base_url}}"], "path": ["catalogs", "motivos-cancelacion"] }, "description": "Listar motivos de cancelacion del SAT." } } ] }, { "name": "Stats", "description": "Endpoints para obtener metricas y estadisticas del tenant.", "item": [ { "name": "CFDI Stats", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "url": { "raw": "{{base_url}}/stats/cfdi", "host": ["{{base_url}}"], "path": ["stats", "cfdi"] }, "description": "Estadisticas de CFDIs: total emitidos, cancelados, montos por periodo." } }, { "name": "CSD Stats", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "url": { "raw": "{{base_url}}/stats/csd", "host": ["{{base_url}}"], "path": ["stats", "csd"] }, "description": "Estadisticas de certificados CSD: activos, por vencer, vencidos." } }, { "name": "User Stats", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}" } ], "url": { "raw": "{{base_url}}/stats/users", "host": ["{{base_url}}"], "path": ["stats", "users"] }, "description": "Estadisticas de usuarios del tenant." } } ] } ] }