{
  "info": {
    "name": "API de Facturín v1",
    "description": "Generada de https://facturin.mx/openapi.json. Pon tu key en la variable `apiKey` (empieza con una fk_test_) y el id de una constancia en `companyId` (GET /companies). Guía: https://facturin.mx/docs/api",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://facturin.mx/api/v1"
    },
    {
      "key": "apiKey",
      "value": "fk_test_…"
    },
    {
      "key": "companyId",
      "value": ""
    },
    {
      "key": "ticketId",
      "value": ""
    }
  ],
  "item": [
    {
      "name": "Tickets",
      "description": "Un ticket es la foto de un comprobante de compra que Facturín factura por ti. Se crea con `POST /tickets` y termina en uno de dos estados: `invoiced` (con su CFDI) o `closed` (con su motivo).",
      "item": [
        {
          "name": "Crear un ticket (imageUrl)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Una llave tuya por petición (un UUID, por ejemplo). Si la petición se repite con la misma llave y el mismo cuerpo, regresa el mismo ticket con `200` en vez de crear otro. Vale 24 horas. Texto ASCII imprimible de 1 a 255 caracteres."
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/tickets",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "tickets"
              ]
            },
            "description": "Crear un ticket\n\nCrea un ticket a partir de la foto del comprobante y arranca su lectura. La respuesta llega en cuanto el ticket existe (`202`); el resultado llega después, por webhook o con `GET /tickets/{id}`.\n\nManda la imagen de una de dos formas, exactamente una:\n\n- `multipart/form-data` con el archivo en el campo `image`, para fotos de hasta 4.5 MB (el tamaño máximo de petición de la plataforma).\n- `application/json` con `imageUrl`, una URL https pública que Facturín descarga: hasta 10 MB, el camino para fotos más pesadas.\n\nSi la petición se rechaza (cualquier `4xx`), no se creó ningún ticket ni se apartó ningún crédito.\n\nCon una key `fk_test_` la petición pasa por las mismas validaciones, pero el ticket no se lee, no entra a ningún portal y no usa saldo: unos 30 segundos después toma el desenlace que pidas en `metadata.simulate` (ver Modo prueba en la guía).",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"imageUrl\": \"https://archivos.ejemplo.mx/casetas/2026-10-20/foto-8812.jpg\",\n  \"companyId\": \"{{companyId}}\",\n  \"usoCFDI\": \"G03\",\n  \"externalId\": \"VIAJE-2026-10-20-0042\",\n  \"metadata\": {\n    \"unidad\": \"T-114\",\n    \"operador\": \"J. Pérez\",\n    \"caseta\": 3\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Crear un ticket (multipart)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Una llave tuya por petición (un UUID, por ejemplo). Si la petición se repite con la misma llave y el mismo cuerpo, regresa el mismo ticket con `200` en vez de crear otro. Vale 24 horas. Texto ASCII imprimible de 1 a 255 caracteres."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/tickets",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "tickets"
              ]
            },
            "description": "Crear un ticket\n\nCrea un ticket a partir de la foto del comprobante y arranca su lectura. La respuesta llega en cuanto el ticket existe (`202`); el resultado llega después, por webhook o con `GET /tickets/{id}`.\n\nManda la imagen de una de dos formas, exactamente una:\n\n- `multipart/form-data` con el archivo en el campo `image`, para fotos de hasta 4.5 MB (el tamaño máximo de petición de la plataforma).\n- `application/json` con `imageUrl`, una URL https pública que Facturín descarga: hasta 10 MB, el camino para fotos más pesadas.\n\nSi la petición se rechaza (cualquier `4xx`), no se creó ningún ticket ni se apartó ningún crédito.\n\nCon una key `fk_test_` la petición pasa por las mismas validaciones, pero el ticket no se lee, no entra a ningún portal y no usa saldo: unos 30 segundos después toma el desenlace que pidas en `metadata.simulate` (ver Modo prueba en la guía).",
            "body": {
              "mode": "formdata",
              "formdata": [
                {
                  "key": "companyId",
                  "value": "{{companyId}}",
                  "type": "text"
                },
                {
                  "key": "usoCFDI",
                  "value": "",
                  "type": "text",
                  "disabled": true
                },
                {
                  "key": "formaPago",
                  "value": "",
                  "type": "text",
                  "disabled": true
                },
                {
                  "key": "externalId",
                  "value": "",
                  "type": "text",
                  "disabled": true
                },
                {
                  "key": "emailNotifications",
                  "value": "",
                  "type": "text",
                  "disabled": true
                },
                {
                  "key": "image",
                  "type": "file",
                  "src": "",
                  "description": "La foto del ticket."
                },
                {
                  "key": "metadata",
                  "value": "",
                  "type": "text",
                  "disabled": true
                }
              ]
            }
          }
        },
        {
          "name": "Listar tickets",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/tickets",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "tickets"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "20",
                  "description": "Tickets por página.",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "El `nextCursor` de la página anterior.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "Solo los tickets en este estado.",
                  "disabled": true
                },
                {
                  "key": "externalId",
                  "value": "",
                  "description": "Tu propio id, comparación exacta.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "2026-10-01",
                  "description": "Fecha del comprobante (`extracted.date`, la que leímos del ticket) desde este día, inclusive. No es la fecha de creación: un ticket cuya fecha todavía no se lee no aparece con este filtro.",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "2026-10-31",
                  "description": "Fecha del comprobante (`extracted.date`, la que leímos del ticket) hasta este día, inclusive. No es la fecha de creación: un ticket cuya fecha todavía no se lee no aparece con este filtro.",
                  "disabled": true
                }
              ]
            },
            "description": "Listar tickets\n\nLos tickets de tu empresa en el modo de tu key, del más nuevo al más viejo, paginados por cursor. Para la siguiente página manda el `nextCursor` de la anterior; es `null` en la última."
          }
        },
        {
          "name": "Consultar un ticket",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/tickets/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "tickets",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{ticketId}}",
                  "description": "El `id` del ticket."
                }
              ]
            },
            "description": "Consultar un ticket\n\nEl ticket como está ahora. Un id de otra empresa, del otro modo (prueba o live) o que no existe responde igual: `404 ticket_not_found`."
          }
        },
        {
          "name": "Descargar el XML o el PDF",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/tickets/:id/cfdi/:type",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "tickets",
                ":id",
                "cfdi",
                ":type"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{ticketId}}",
                  "description": "El `id` del ticket."
                },
                {
                  "key": "type",
                  "value": "xml",
                  "description": "`xml` o `pdf`."
                }
              ]
            },
            "description": "Descargar el XML o el PDF\n\nEl archivo del CFDI timbrado, tal como lo entregó el portal. La respuesta es el archivo mismo (`200`), no una redirección: viaja por la API con tu key y no hay una liga firmada que caduque o se pueda compartir. Solo existe para un ticket `invoiced`; las ligas `cfdi.xmlUrl` y `cfdi.pdfUrl` del ticket apuntan aquí."
          }
        }
      ]
    },
    {
      "name": "Constancias",
      "description": "Las constancias de situación fiscal (RFC) de tu empresa: con cuál de ellas se factura cada ticket.",
      "item": [
        {
          "name": "Listar constancias",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/companies",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "companies"
              ]
            },
            "description": "Listar constancias\n\nLas constancias activas de tu empresa, de la más nueva a la más vieja: los `companyId` que acepta `POST /tickets`. Es la misma lista para una key live y una de prueba."
          }
        }
      ]
    }
  ]
}
