{ "info": { "name": "Facter — API de Timbrado", "_postman_id": "facter-api-ext-v1", "description": "Colección oficial del API externo de Facter. Hay dos ambientes: Demo (https://demo.facter.com.mx/api/ext/v1, sandbox de pruebas, sin cobro real) y Producción (https://v2.facter.com.mx/api/ext/v1, timbrado real). Configura la variable base_url con el ambiente que quieras usar y tu api_key fct_live_* de ESE ambiente (la key de demo no funciona en prod ni viceversa). Por defecto base_url apunta a Demo para que pruebes primero. Documentación: https://v2.facter.com.mx/developers", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "item": [ { "name": "CFDIs", "item": [ { "name": "Timbrar CFDI (ingreso)", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{base_url}}/api/ext/v1/cfdis", "host": [ "{{base_url}}" ], "path": [ "api", "ext", "v1", "cfdis" ] }, "body": { "mode": "raw", "raw": "{\n \"emisor_rfc\": \"EKU9003173C9\",\n \"external_ref\": \"REF-FAC-000123\",\n \"fecha_emision\": null,\n \"cfdi\": {\n \"Version\": \"4.0\",\n \"Serie\": \"A\",\n \"Folio\": \"123\",\n \"FormaPago\": \"01\",\n \"MetodoPago\": \"PUE\",\n \"CondicionesDePago\": null,\n \"SubTotal\": \"1000.00\",\n \"Descuento\": null,\n \"Moneda\": \"MXN\",\n \"Total\": \"1160.00\",\n \"TipoDeComprobante\": \"I\",\n \"Exportacion\": \"01\",\n \"LugarExpedicion\": \"64000\",\n \"Emisor\": {\n \"Rfc\": \"EKU9003173C9\",\n \"Nombre\": \"ESCUELA KEMPER URGATE\",\n \"RegimenFiscal\": \"601\"\n },\n \"Receptor\": {\n \"Rfc\": \"XAXX010101000\",\n \"Nombre\": \"PUBLICO EN GENERAL\",\n \"DomicilioFiscalReceptor\": \"64000\",\n \"RegimenFiscalReceptor\": \"616\",\n \"UsoCFDI\": \"S01\"\n },\n \"Conceptos\": [\n {\n \"ClaveProdServ\": \"01010101\",\n \"NoIdentificacion\": \"SKU-01\",\n \"Cantidad\": \"1.000000\",\n \"ClaveUnidad\": \"H87\",\n \"Unidad\": \"Pieza\",\n \"Descripcion\": \"Producto de prueba\",\n \"ValorUnitario\": \"1000.00\",\n \"Importe\": \"1000.00\",\n \"Descuento\": null,\n \"ObjetoImp\": \"02\",\n \"Impuestos\": {\n \"Traslados\": [\n {\n \"Base\": \"1000.00\",\n \"Impuesto\": \"002\",\n \"TipoFactor\": \"Tasa\",\n \"TasaOCuota\": \"0.160000\",\n \"Importe\": \"160.00\"\n }\n ],\n \"Retenciones\": []\n }\n }\n ],\n \"Impuestos\": {\n \"TotalImpuestosTrasladados\": \"160.00\",\n \"Traslados\": [\n {\n \"Base\": \"1000.00\",\n \"Impuesto\": \"002\",\n \"TipoFactor\": \"Tasa\",\n \"TasaOCuota\": \"0.160000\",\n \"Importe\": \"160.00\"\n }\n ]\n },\n \"CfdiRelacionados\": null,\n \"Complemento\": null,\n \"InformacionGlobal\": null\n }\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Timbrar CFDI (egreso / nota de crédito)", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{base_url}}/api/ext/v1/cfdis", "host": [ "{{base_url}}" ], "path": [ "api", "ext", "v1", "cfdis" ] }, "body": { "mode": "raw", "raw": "{\n \"emisor_rfc\": \"EKU9003173C9\",\n \"external_ref\": \"REF-NC-000045\",\n \"fecha_emision\": null,\n \"cfdi\": {\n \"Version\": \"4.0\",\n \"Serie\": \"NC\",\n \"Folio\": \"45\",\n \"FormaPago\": \"01\",\n \"MetodoPago\": \"PUE\",\n \"CondicionesDePago\": null,\n \"SubTotal\": \"1000.00\",\n \"Descuento\": null,\n \"Moneda\": \"MXN\",\n \"Total\": \"1160.00\",\n \"TipoDeComprobante\": \"E\",\n \"Exportacion\": \"01\",\n \"LugarExpedicion\": \"64000\",\n \"Emisor\": {\n \"Rfc\": \"EKU9003173C9\",\n \"Nombre\": \"ESCUELA KEMPER URGATE\",\n \"RegimenFiscal\": \"601\"\n },\n \"Receptor\": {\n \"Rfc\": \"XAXX010101000\",\n \"Nombre\": \"PUBLICO EN GENERAL\",\n \"DomicilioFiscalReceptor\": \"64000\",\n \"RegimenFiscalReceptor\": \"616\",\n \"UsoCFDI\": \"S01\"\n },\n \"Conceptos\": [\n {\n \"ClaveProdServ\": \"01010101\",\n \"NoIdentificacion\": \"SKU-01\",\n \"Cantidad\": \"1.000000\",\n \"ClaveUnidad\": \"H87\",\n \"Unidad\": \"Pieza\",\n \"Descripcion\": \"Bonificacion sobre venta SKU-01\",\n \"ValorUnitario\": \"1000.00\",\n \"Importe\": \"1000.00\",\n \"Descuento\": null,\n \"ObjetoImp\": \"02\",\n \"Impuestos\": {\n \"Traslados\": [\n {\n \"Base\": \"1000.00\",\n \"Impuesto\": \"002\",\n \"TipoFactor\": \"Tasa\",\n \"TasaOCuota\": \"0.160000\",\n \"Importe\": \"160.00\"\n }\n ],\n \"Retenciones\": []\n }\n }\n ],\n \"Impuestos\": {\n \"TotalImpuestosTrasladados\": \"160.00\",\n \"Traslados\": [\n {\n \"Base\": \"1000.00\",\n \"Impuesto\": \"002\",\n \"TipoFactor\": \"Tasa\",\n \"TasaOCuota\": \"0.160000\",\n \"Importe\": \"160.00\"\n }\n ]\n },\n \"CfdiRelacionados\": [\n {\n \"TipoRelacion\": \"01\",\n \"CfdiRelacionado\": [\n {\n \"UUID\": \"AAAAAAAA-BBBB-CCCC-DDDD-EEEEEEEEEEEE\"\n }\n ]\n }\n ],\n \"Complemento\": null,\n \"InformacionGlobal\": null\n }\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Timbrar CFDI (pago)", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{base_url}}/api/ext/v1/cfdis", "host": [ "{{base_url}}" ], "path": [ "api", "ext", "v1", "cfdis" ] }, "body": { "mode": "raw", "raw": "{\n \"emisor_rfc\": \"EKU9003173C9\",\n \"external_ref\": \"REF-PAGO-000077\",\n \"fecha_emision\": null,\n \"cfdi\": {\n \"Version\": \"4.0\",\n \"Serie\": \"P\",\n \"Folio\": \"77\",\n \"FormaPago\": null,\n \"MetodoPago\": null,\n \"CondicionesDePago\": null,\n \"SubTotal\": \"0\",\n \"Descuento\": null,\n \"Moneda\": \"XXX\",\n \"Total\": \"0\",\n \"TipoDeComprobante\": \"P\",\n \"Exportacion\": \"01\",\n \"LugarExpedicion\": \"64000\",\n \"Emisor\": {\n \"Rfc\": \"EKU9003173C9\",\n \"Nombre\": \"ESCUELA KEMPER URGATE\",\n \"RegimenFiscal\": \"601\"\n },\n \"Receptor\": {\n \"Rfc\": \"XAXX010101000\",\n \"Nombre\": \"PUBLICO EN GENERAL\",\n \"DomicilioFiscalReceptor\": \"64000\",\n \"RegimenFiscalReceptor\": \"616\",\n \"UsoCFDI\": \"CP01\"\n },\n \"Conceptos\": [\n {\n \"ClaveProdServ\": \"84111506\",\n \"NoIdentificacion\": null,\n \"Cantidad\": \"1\",\n \"ClaveUnidad\": \"ACT\",\n \"Unidad\": null,\n \"Descripcion\": \"Pago\",\n \"ValorUnitario\": \"0\",\n \"Importe\": \"0\",\n \"Descuento\": null,\n \"ObjetoImp\": \"01\"\n }\n ],\n \"Impuestos\": null,\n \"CfdiRelacionados\": null,\n \"Complemento\": {\n \"Pagos\": {\n \"Version\": \"2.0\",\n \"Totales\": {\n \"MontoTotalPagos\": \"1160.00\"\n },\n \"Pago\": [\n {\n \"FechaPago\": \"2026-06-10T12:00:00\",\n \"FormaDePagoP\": \"03\",\n \"MonedaP\": \"MXN\",\n \"TipoCambioP\": \"1\",\n \"Monto\": \"1160.00\",\n \"DoctosRelacionados\": [\n {\n \"IdDocumento\": \"AAAAAAAA-BBBB-CCCC-DDDD-EEEEEEEEEEEE\",\n \"Serie\": \"A\",\n \"Folio\": \"123\",\n \"MonedaDR\": \"MXN\",\n \"EquivalenciaDR\": \"1\",\n \"NumParcialidad\": \"1\",\n \"ImpSaldoAnt\": \"1160.00\",\n \"ImpPagado\": \"1160.00\",\n \"ImpSaldoInsoluto\": \"0.00\",\n \"ObjetoImpDR\": \"01\"\n }\n ]\n }\n ]\n }\n },\n \"InformacionGlobal\": null\n }\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Validar sin timbrar (dry-run)", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/api/ext/v1/cfdis/validate", "host": [ "{{base_url}}" ], "path": [ "api", "ext", "v1", "cfdis", "validate" ] }, "body": { "mode": "raw", "raw": "{\n \"emisor_rfc\": \"EKU9003173C9\",\n \"external_ref\": \"REF-FAC-000123\",\n \"fecha_emision\": null,\n \"cfdi\": {\n \"Version\": \"4.0\",\n \"Serie\": \"A\",\n \"Folio\": \"123\",\n \"FormaPago\": \"01\",\n \"MetodoPago\": \"PUE\",\n \"CondicionesDePago\": null,\n \"SubTotal\": \"1000.00\",\n \"Descuento\": null,\n \"Moneda\": \"MXN\",\n \"Total\": \"1160.00\",\n \"TipoDeComprobante\": \"I\",\n \"Exportacion\": \"01\",\n \"LugarExpedicion\": \"64000\",\n \"Emisor\": {\n \"Rfc\": \"EKU9003173C9\",\n \"Nombre\": \"ESCUELA KEMPER URGATE\",\n \"RegimenFiscal\": \"601\"\n },\n \"Receptor\": {\n \"Rfc\": \"XAXX010101000\",\n \"Nombre\": \"PUBLICO EN GENERAL\",\n \"DomicilioFiscalReceptor\": \"64000\",\n \"RegimenFiscalReceptor\": \"616\",\n \"UsoCFDI\": \"S01\"\n },\n \"Conceptos\": [\n {\n \"ClaveProdServ\": \"01010101\",\n \"NoIdentificacion\": \"SKU-01\",\n \"Cantidad\": \"1.000000\",\n \"ClaveUnidad\": \"H87\",\n \"Unidad\": \"Pieza\",\n \"Descripcion\": \"Producto de prueba\",\n \"ValorUnitario\": \"1000.00\",\n \"Importe\": \"1000.00\",\n \"Descuento\": null,\n \"ObjetoImp\": \"02\",\n \"Impuestos\": {\n \"Traslados\": [\n {\n \"Base\": \"1000.00\",\n \"Impuesto\": \"002\",\n \"TipoFactor\": \"Tasa\",\n \"TasaOCuota\": \"0.160000\",\n \"Importe\": \"160.00\"\n }\n ],\n \"Retenciones\": []\n }\n }\n ],\n \"Impuestos\": {\n \"TotalImpuestosTrasladados\": \"160.00\",\n \"Traslados\": [\n {\n \"Base\": \"1000.00\",\n \"Impuesto\": \"002\",\n \"TipoFactor\": \"Tasa\",\n \"TasaOCuota\": \"0.160000\",\n \"Importe\": \"160.00\"\n }\n ]\n },\n \"CfdiRelacionados\": null,\n \"Complemento\": null,\n \"InformacionGlobal\": null\n }\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Consultar CFDI", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}", "type": "text" } ], "url": { "raw": "{{base_url}}/api/ext/v1/cfdis/{{uuid}}", "host": [ "{{base_url}}" ], "path": [ "api", "ext", "v1", "cfdis", "{{uuid}}" ] } } }, { "name": "Descargar XML", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}", "type": "text" } ], "url": { "raw": "{{base_url}}/api/ext/v1/cfdis/{{uuid}}/xml", "host": [ "{{base_url}}" ], "path": [ "api", "ext", "v1", "cfdis", "{{uuid}}", "xml" ] } } }, { "name": "Descargar PDF", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}", "type": "text" } ], "url": { "raw": "{{base_url}}/api/ext/v1/cfdis/{{uuid}}/pdf", "host": [ "{{base_url}}" ], "path": [ "api", "ext", "v1", "cfdis", "{{uuid}}", "pdf" ] } } }, { "name": "Listar CFDIs", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}", "type": "text" } ], "url": { "raw": "{{base_url}}/api/ext/v1/cfdis?per_page=25&page=1", "host": [ "{{base_url}}" ], "path": [ "api", "ext", "v1", "cfdis?per_page=25&page=1" ] } } } ] }, { "name": "Cancelación", "item": [ { "name": "Solicitar cancelación", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{base_url}}/api/ext/v1/cfdis/{{uuid}}/cancelacion", "host": [ "{{base_url}}" ], "path": [ "api", "ext", "v1", "cfdis", "{{uuid}}", "cancelacion" ] }, "body": { "mode": "raw", "raw": "{\n \"motivo\": \"02\",\n \"folio_sustitucion_uuid\": null\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Estatus de cancelación", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}", "type": "text" } ], "url": { "raw": "{{base_url}}/api/ext/v1/cfdis/{{uuid}}/cancelacion", "host": [ "{{base_url}}" ], "path": [ "api", "ext", "v1", "cfdis", "{{uuid}}", "cancelacion" ] } } } ] }, { "name": "Emisores", "item": [ { "name": "Alta de emisor", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{base_url}}/api/ext/v1/emisores", "host": [ "{{base_url}}" ], "path": [ "api", "ext", "v1", "emisores" ] }, "body": { "mode": "raw", "raw": "{\n \"external_ref\": \"tenant-externo-42\",\n \"razon_social\": \"ESCUELA KEMPER URGATE\",\n \"rfc\": \"EKU9003173C9\",\n \"regimen_fiscal\": \"601\",\n \"codigo_postal\": \"64000\",\n \"curp\": null\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Listar emisores", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}", "type": "text" } ], "url": { "raw": "{{base_url}}/api/ext/v1/emisores", "host": [ "{{base_url}}" ], "path": [ "api", "ext", "v1", "emisores" ] } } }, { "name": "Detalle de emisor", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}", "type": "text" } ], "url": { "raw": "{{base_url}}/api/ext/v1/emisores/{{emisor_rfc}}", "host": [ "{{base_url}}" ], "path": [ "api", "ext", "v1", "emisores", "{{emisor_rfc}}" ] } } }, { "name": "Subir CSD", "request": { "method": "PUT", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/api/ext/v1/emisores/{{emisor_rfc}}/csd", "host": [ "{{base_url}}" ], "path": [ "api", "ext", "v1", "emisores", "{{emisor_rfc}}", "csd" ] }, "body": { "mode": "raw", "raw": "{\n \"cer_base64\": \"\",\n \"key_base64\": \"\",\n \"password\": \"\"\n}", "options": { "raw": { "language": "json" } } } } } ] }, { "name": "Timbres", "item": [ { "name": "Saldo del pool", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}", "type": "text" } ], "url": { "raw": "{{base_url}}/api/ext/v1/timbres", "host": [ "{{base_url}}" ], "path": [ "api", "ext", "v1", "timbres" ] } } }, { "name": "Reporte de consumo", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}", "type": "text" } ], "url": { "raw": "{{base_url}}/api/ext/v1/timbres/reporte?desde=2026-06-01&hasta=2026-06-30", "host": [ "{{base_url}}" ], "path": [ "api", "ext", "v1", "timbres", "reporte?desde=2026-06-01&hasta=2026-06-30" ] } } } ] }, { "name": "Webhooks", "item": [ { "name": "Consultar configuración", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}", "type": "text" } ], "url": { "raw": "{{base_url}}/api/ext/v1/webhooks", "host": [ "{{base_url}}" ], "path": [ "api", "ext", "v1", "webhooks" ] } } }, { "name": "Configurar webhooks", "request": { "method": "PUT", "header": [ { "key": "Authorization", "value": "Bearer {{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/api/ext/v1/webhooks", "host": [ "{{base_url}}" ], "path": [ "api", "ext", "v1", "webhooks" ] }, "body": { "mode": "raw", "raw": "{\n \"url\": \"https:\\/\\/app.cliente.com\\/facter\\/webhook\",\n \"events\": [\n \"cfdi.cancelado\",\n \"timbres.bajo_saldo\"\n ]\n}", "options": { "raw": { "language": "json" } } } } } ] } ], "variable": [ { "key": "base_url", "value": "https://demo.facter.com.mx" }, { "key": "api_key", "value": "fct_live_xxxxxxxxxxxxxxxx" }, { "key": "uuid", "value": "AAAAAAAA-BBBB-CCCC-DDDD-EEEEEEEEEEEE" }, { "key": "emisor_rfc", "value": "EKU9003173C9" } ] }