{
  "openapi": "3.1.0",
  "info": {
    "title": "API de Facturín",
    "version": "1.0.0",
    "summary": "Manda la foto de un ticket de compra y recibe el CFDI timbrado.",
    "description": "La API v1 de Facturín convierte la foto de un ticket de compra en un CFDI timbrado, sin captura manual. Tu sistema crea el ticket, nosotros lo leemos, entramos al portal del comercio y te regresamos el XML, el PDF y los datos del XML (subtotal, IVA, fecha, emisor) por webhook o consultando el ticket.\n\nEl acceso es por solicitud, para empresas con plan Enterprise. La guía completa en español está en https://facturin.mx/docs/api.\n\nEl contrato de `/api/v1` es estable: un campo nunca se renombra ni se quita, solo se agregan campos nuevos. Ignora los campos que no conozcas.",
    "contact": {
      "name": "Facturín",
      "url": "https://facturin.mx/docs/api",
      "email": "magio@magiobus.com"
    },
    "license": {
      "name": "Términos y Condiciones de Facturín",
      "url": "https://facturin.mx/terminos"
    },
    "x-facturin-limits": {
      "requestsPerMinute": 60,
      "createsPerMinute": 30,
      "failedAuthPerIpPerMinute": 20,
      "imageMaxBytes": 10485760,
      "metadataMaxBytes": 4096,
      "externalIdMaxLength": 128,
      "idempotencyKeyMaxLength": 255,
      "idempotencyKeyTtlHours": 24,
      "listDefaultLimit": 20,
      "listMaxLimit": 100,
      "imageUrlTimeoutSeconds": 10,
      "imageUrlMaxRedirects": 3,
      "webhookTimeoutSeconds": 10,
      "webhookAttempts": 9,
      "webhookRetryDelaysSeconds": [120, 600, 1800, 3600, 7200, 14400, 28800, 28800],
      "webhookXmlHoldSeconds": 7200,
      "webhookSecretRotationGraceHours": 24,
      "slaHours": 48,
      "slaPriorityHours": 36,
      "cfdiRequestWaitDays": 5,
      "testOutcomeDelaySeconds": 30,
      "testTicketRetentionDays": 30
    }
  },
  "servers": [
    {
      "url": "https://facturin.mx/api/v1",
      "description": "Producción. Una key fk_live_ trabaja con tickets reales y una fk_test_ con tickets de prueba, sobre el mismo servidor."
    }
  ],
  "security": [{ "apiKey": [] }],
  "tags": [
    {
      "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)."
    },
    {
      "name": "Constancias",
      "description": "Las constancias de situación fiscal (RFC) de tu empresa: con cuál de ellas se factura cada ticket."
    }
  ],
  "paths": {
    "/tickets": {
      "post": {
        "operationId": "createTicket",
        "tags": ["Tickets"],
        "summary": "Crear un ticket",
        "description": "Crea 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).",
        "parameters": [{ "$ref": "#/components/parameters/IdempotencyKey" }],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": { "$ref": "#/components/schemas/CreateTicketMultipart" },
              "encoding": {
                "image": { "contentType": "image/jpeg, image/png, image/webp, image/heic" }
              }
            },
            "application/json": {
              "schema": { "$ref": "#/components/schemas/CreateTicketJson" },
              "examples": {
                "imageUrl": {
                  "summary": "Foto por URL, con tu id y tus datos",
                  "value": {
                    "imageUrl": "https://archivos.ejemplo.mx/casetas/2026-10-20/foto-8812.jpg",
                    "companyId": "6720b1f4c2a9e81d4f0a1b2c",
                    "usoCFDI": "G03",
                    "externalId": "VIAJE-2026-10-20-0042",
                    "metadata": { "unidad": "T-114", "operador": "J. Pérez", "caseta": 3 }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Ticket creado. Su lectura ya arrancó; el `status` es `processing`. Con una key de prueba no se lee: su desenlace simulado llega en unos 30 segundos.",
            "headers": {
              "RateLimit-Limit": { "$ref": "#/components/headers/RateLimit-Limit" },
              "RateLimit-Remaining": { "$ref": "#/components/headers/RateLimit-Remaining" },
              "RateLimit-Reset": { "$ref": "#/components/headers/RateLimit-Reset" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/Ticket" },
                "examples": { "processing": { "$ref": "#/components/examples/TicketProcessing" } }
              }
            }
          },
          "200": {
            "description": "Repetición de una petición con la misma `Idempotency-Key` y el mismo cuerpo: regresa el MISMO ticket, como está ahora. No se creó nada nuevo.",
            "headers": {
              "RateLimit-Limit": { "$ref": "#/components/headers/RateLimit-Limit" },
              "RateLimit-Remaining": { "$ref": "#/components/headers/RateLimit-Remaining" },
              "RateLimit-Reset": { "$ref": "#/components/headers/RateLimit-Reset" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/Ticket" },
                "examples": { "processing": { "$ref": "#/components/examples/TicketProcessing" } }
              }
            }
          },
          "400": {
            "description": "La petición no es válida. El `code` dice qué campo.",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/Error" },
                "examples": {
                  "invalid_uso_cfdi": {
                    "value": {
                      "error": {
                        "code": "invalid_uso_cfdi",
                        "message": "usoCFDI no es una clave válida del catálogo c_UsoCFDI del SAT."
                      }
                    }
                  }
                }
              }
            },
            "x-facturin-codes": [
              "unsupported_content_type",
              "invalid_body",
              "invalid_json",
              "invalid_idempotency_key",
              "invalid_company_id",
              "company_required",
              "invalid_uso_cfdi",
              "invalid_forma_pago",
              "invalid_external_id",
              "invalid_metadata",
              "invalid_email_notifications",
              "invalid_simulate",
              "invalid_image_url",
              "image_required"
            ]
          },
          "401": { "$ref": "#/components/responses/Unauthorized" },
          "402": {
            "description": "Tu empresa no tiene tickets disponibles en este periodo. No se creó el ticket. Una key de prueba no usa saldo, así que nunca recibe este error.",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/Error" },
                "examples": {
                  "no_credits": {
                    "value": {
                      "error": {
                        "code": "no_credits",
                        "message": "Tu empresa no tiene tickets disponibles en este periodo. No se creó el ticket."
                      }
                    }
                  }
                }
              }
            },
            "x-facturin-codes": ["no_credits"]
          },
          "404": {
            "description": "`companyId` no es una constancia activa de tu empresa.",
            "content": {
              "application/json": { "schema": { "$ref": "#/components/schemas/Error" } }
            },
            "x-facturin-codes": ["company_not_found"]
          },
          "409": {
            "description": "Conflicto de idempotencia, o ya existe un ticket con ese `externalId` (el error trae su `ticketId`).",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/Error" },
                "examples": {
                  "external_id_exists": {
                    "value": {
                      "error": {
                        "code": "external_id_exists",
                        "message": "Ya existe un ticket con este externalId.",
                        "ticketId": "6720b2a1c2a9e81d4f0a1b9f"
                      }
                    }
                  },
                  "idempotency_in_progress": {
                    "value": {
                      "error": {
                        "code": "idempotency_in_progress",
                        "message": "Otra petición con esta Idempotency-Key todavía se está procesando. Reintenta en unos segundos."
                      }
                    }
                  }
                }
              }
            },
            "x-facturin-codes": ["idempotency_conflict", "idempotency_in_progress", "external_id_exists"]
          },
          "413": {
            "description": "La imagen pesa más de 10 MB (`image_too_large`). Aparte, una petición multipart de más de 4.5 MB la rechaza la plataforma con su propio 413, antes de llegar a la API y sin este formato de error: para fotos grandes usa `imageUrl`.",
            "content": {
              "application/json": { "schema": { "$ref": "#/components/schemas/Error" } }
            },
            "x-facturin-codes": ["image_too_large"]
          },
          "422": {
            "description": "La imagen no es JPEG, PNG, WebP o HEIC, `imageUrl` no se pudo descargar, o tu empresa no tiene una constancia activa.",
            "content": {
              "application/json": { "schema": { "$ref": "#/components/schemas/Error" } }
            },
            "x-facturin-codes": ["image_invalid", "image_fetch_failed", "no_company"]
          },
          "429": { "$ref": "#/components/responses/RateLimited" },
          "500": { "$ref": "#/components/responses/InternalError" },
          "503": { "$ref": "#/components/responses/ServiceUnavailable" }
        }
      },
      "get": {
        "operationId": "listTickets",
        "tags": ["Tickets"],
        "summary": "Listar tickets",
        "description": "Los 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.",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "description": "Tickets por página.",
            "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "El `nextCursor` de la página anterior.",
            "schema": { "type": "string" }
          },
          {
            "name": "status",
            "in": "query",
            "description": "Solo los tickets en este estado.",
            "schema": { "$ref": "#/components/schemas/TicketStatus" }
          },
          {
            "name": "externalId",
            "in": "query",
            "description": "Tu propio id, comparación exacta.",
            "schema": { "type": "string", "minLength": 1, "maxLength": 128 }
          },
          {
            "name": "from",
            "in": "query",
            "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.",
            "schema": { "type": "string", "format": "date" },
            "example": "2026-10-01"
          },
          {
            "name": "to",
            "in": "query",
            "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.",
            "schema": { "type": "string", "format": "date" },
            "example": "2026-10-31"
          }
        ],
        "responses": {
          "200": {
            "description": "Una página de tickets.",
            "headers": {
              "RateLimit-Limit": { "$ref": "#/components/headers/RateLimit-Limit" },
              "RateLimit-Remaining": { "$ref": "#/components/headers/RateLimit-Remaining" },
              "RateLimit-Reset": { "$ref": "#/components/headers/RateLimit-Reset" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/TicketList" }
              }
            }
          },
          "400": {
            "description": "Un parámetro no es válido. Nunca se ignora en silencio: `?status=invoced` es un 400, no la lista completa.",
            "content": {
              "application/json": { "schema": { "$ref": "#/components/schemas/Error" } }
            },
            "x-facturin-codes": ["invalid_limit", "invalid_status", "invalid_external_id", "invalid_date", "invalid_cursor"]
          },
          "401": { "$ref": "#/components/responses/Unauthorized" },
          "429": { "$ref": "#/components/responses/RateLimited" },
          "500": { "$ref": "#/components/responses/InternalError" },
          "503": { "$ref": "#/components/responses/ServiceUnavailable" }
        }
      }
    },
    "/tickets/{id}": {
      "get": {
        "operationId": "getTicket",
        "tags": ["Tickets"],
        "summary": "Consultar un ticket",
        "description": "El 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`.",
        "parameters": [{ "$ref": "#/components/parameters/TicketId" }],
        "responses": {
          "200": {
            "description": "El ticket.",
            "headers": {
              "RateLimit-Limit": { "$ref": "#/components/headers/RateLimit-Limit" },
              "RateLimit-Remaining": { "$ref": "#/components/headers/RateLimit-Remaining" },
              "RateLimit-Reset": { "$ref": "#/components/headers/RateLimit-Reset" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/Ticket" },
                "examples": {
                  "invoiced": { "$ref": "#/components/examples/TicketInvoiced" },
                  "closed": { "$ref": "#/components/examples/TicketClosed" },
                  "processing": { "$ref": "#/components/examples/TicketProcessing" },
                  "test": { "$ref": "#/components/examples/TicketTestInvoiced" }
                }
              }
            }
          },
          "401": { "$ref": "#/components/responses/Unauthorized" },
          "404": { "$ref": "#/components/responses/TicketNotFound" },
          "429": { "$ref": "#/components/responses/RateLimited" },
          "500": { "$ref": "#/components/responses/InternalError" },
          "503": { "$ref": "#/components/responses/ServiceUnavailable" }
        }
      }
    },
    "/tickets/{id}/cfdi/{type}": {
      "get": {
        "operationId": "downloadCfdi",
        "tags": ["Tickets"],
        "summary": "Descargar el XML o el PDF",
        "description": "El 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í.",
        "parameters": [
          { "$ref": "#/components/parameters/TicketId" },
          {
            "name": "type",
            "in": "path",
            "required": true,
            "description": "`xml` o `pdf`.",
            "schema": { "type": "string", "enum": ["xml", "pdf"] }
          }
        ],
        "responses": {
          "200": {
            "description": "El archivo. `Content-Disposition` trae el nombre con el que lo entregó el portal.",
            "headers": {
              "RateLimit-Limit": { "$ref": "#/components/headers/RateLimit-Limit" },
              "RateLimit-Remaining": { "$ref": "#/components/headers/RateLimit-Remaining" },
              "RateLimit-Reset": { "$ref": "#/components/headers/RateLimit-Reset" },
              "Content-Disposition": {
                "description": "`attachment; filename=\"…\"`",
                "schema": { "type": "string" }
              }
            },
            "content": {
              "application/xml": { "schema": { "type": "string", "contentMediaType": "application/xml" } },
              "application/pdf": { "schema": { "type": "string", "contentMediaType": "application/pdf" } }
            }
          },
          "400": {
            "description": "`type` no es `xml` ni `pdf`.",
            "content": {
              "application/json": { "schema": { "$ref": "#/components/schemas/Error" } }
            },
            "x-facturin-codes": ["invalid_cfdi_type"]
          },
          "401": { "$ref": "#/components/responses/Unauthorized" },
          "404": {
            "description": "`ticket_not_found`: el ticket no existe para tu key. `cfdi_not_available`: el ticket es tuyo pero no está `invoiced`, o no tiene ese archivo.",
            "content": {
              "application/json": { "schema": { "$ref": "#/components/schemas/Error" } }
            },
            "x-facturin-codes": ["ticket_not_found", "cfdi_not_available"]
          },
          "429": { "$ref": "#/components/responses/RateLimited" },
          "500": { "$ref": "#/components/responses/InternalError" },
          "503": { "$ref": "#/components/responses/ServiceUnavailable" }
        }
      }
    },
    "/companies": {
      "get": {
        "operationId": "listCompanies",
        "tags": ["Constancias"],
        "summary": "Listar constancias",
        "description": "Las 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.",
        "responses": {
          "200": {
            "description": "Las constancias.",
            "headers": {
              "RateLimit-Limit": { "$ref": "#/components/headers/RateLimit-Limit" },
              "RateLimit-Remaining": { "$ref": "#/components/headers/RateLimit-Remaining" },
              "RateLimit-Reset": { "$ref": "#/components/headers/RateLimit-Reset" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/CompanyList" },
                "example": {
                  "data": [
                    {
                      "id": "6720b1f4c2a9e81d4f0a1b2c",
                      "rfc": "TEJ200101AB1",
                      "businessName": "TRANSPORTES EJEMPLO",
                      "tradeName": null,
                      "taxRegime": "601",
                      "createdAt": "2026-10-01T16:20:00.000Z"
                    }
                  ]
                }
              }
            }
          },
          "401": { "$ref": "#/components/responses/Unauthorized" },
          "429": { "$ref": "#/components/responses/RateLimited" },
          "500": { "$ref": "#/components/responses/InternalError" },
          "503": { "$ref": "#/components/responses/ServiceUnavailable" }
        }
      }
    }
  },
  "webhooks": {
    "ticket.invoiced": {
      "post": {
        "operationId": "webhookTicketInvoiced",
        "summary": "ticket.invoiced",
        "description": "El ticket se timbró. `data` es el ticket completo, con `cfdi` lleno.\n\nSi el portal entregó primero el PDF, el evento espera al XML hasta 2 horas, porque `fecha`, `subtotal`, `iva` y `xmlUrl` salen del XML. Si el XML no llega en ese tiempo, el evento sale sin él: esos campos vienen en `null`. Si el XML llega después, te llega `ticket.updated` con el ticket completo.\n\nSolo los tickets creados por la API generan webhooks, y van al endpoint del mismo modo que el ticket (live o prueba). Cada desenlace de un ticket es un evento, una sola vez; si el desenlace cambia después, llega otro evento con otro `id`.\n\nEl cuerpo es el mismo en cada reintento (mismo `id`, mismos bytes); solo `t` del header cambia. Verifica la firma de `Facturin-Signature` antes de confiar en el cuerpo.",
        "parameters": [
          { "$ref": "#/components/parameters/FacturinSignature" },
          { "$ref": "#/components/parameters/WebhookUserAgent" }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": { "$ref": "#/components/schemas/WebhookEvent" },
              "examples": { "invoiced": { "$ref": "#/components/examples/WebhookInvoiced" } }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Recibido. Cualquier otra respuesta, una redirección incluida, o ninguna en 10 segundos, cuenta como fallo. Se reintenta a los 2 min, 10 min, 30 min, 1 h, 2 h, 4 h, 8 h y 8 h (9 intentos en unas 24 horas); después la entrega queda como fallida y nuestro equipo puede reenviarla con el mismo `id`."
          }
        }
      }
    },
    "ticket.closed": {
      "post": {
        "operationId": "webhookTicketClosed",
        "summary": "ticket.closed",
        "description": "El ticket se cerró sin CFDI de Facturín. `data.reason` dice por qué y `data.reasonText` lo explica en español. Incluye un comprobante que ya estaba facturado (`already_invoiced`, también cuando era un duplicado de otro ticket tuyo) y los tickets que cerramos a las 48 horas.\n\nSolo los tickets creados por la API generan webhooks, y van al endpoint del mismo modo que el ticket (live o prueba). Cada desenlace de un ticket es un evento, una sola vez; si el desenlace cambia después, llega otro evento con otro `id`.\n\nEl cuerpo es el mismo en cada reintento (mismo `id`, mismos bytes); solo `t` del header cambia. Verifica la firma de `Facturin-Signature` antes de confiar en el cuerpo.",
        "parameters": [
          { "$ref": "#/components/parameters/FacturinSignature" },
          { "$ref": "#/components/parameters/WebhookUserAgent" }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": { "$ref": "#/components/schemas/WebhookEvent" },
              "examples": { "closed": { "$ref": "#/components/examples/WebhookClosed" } }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Recibido. Cualquier otra respuesta, una redirección incluida, o ninguna en 10 segundos, cuenta como fallo. Se reintenta a los 2 min, 10 min, 30 min, 1 h, 2 h, 4 h, 8 h y 8 h (9 intentos en unas 24 horas); después la entrega queda como fallida y nuestro equipo puede reenviarla con el mismo `id`."
          }
        }
      }
    },
    "ticket.updated": {
      "post": {
        "operationId": "webhookTicketUpdated",
        "summary": "ticket.updated",
        "description": "Un ticket que ya te avisamos como `invoiced` cambió: hoy, solo cuando su XML llegó después de que `ticket.invoiced` salió sin él (el portal entregó primero el PDF y el XML tardó más de 2 horas). `data` es el ticket completo, ahora con `cfdi.fecha`, `subtotal`, `iva`, `serie` y `xmlUrl`. Actualiza tu registro con él: no es un desenlace nuevo (`data.status` sigue en `invoiced`) y no se cobra de nuevo.\n\nSolo llega a los endpoints que recibieron ese `ticket.invoiced` sin XML. El cuerpo es el mismo en cada reintento (mismo `id`, mismos bytes); solo `t` del header cambia. Verifica la firma de `Facturin-Signature` antes de confiar en el cuerpo.",
        "parameters": [
          { "$ref": "#/components/parameters/FacturinSignature" },
          { "$ref": "#/components/parameters/WebhookUserAgent" }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": { "$ref": "#/components/schemas/WebhookEvent" },
              "examples": { "updated": { "$ref": "#/components/examples/WebhookUpdated" } }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Recibido. Cualquier otra respuesta, una redirección incluida, o ninguna en 10 segundos, cuenta como fallo. Se reintenta a los 2 min, 10 min, 30 min, 1 h, 2 h, 4 h, 8 h y 8 h (9 intentos en unas 24 horas); después la entrega queda como fallida y nuestro equipo puede reenviarla con el mismo `id`."
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "apiKey": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "fk_live_… | fk_test_…",
        "description": "`Authorization: Bearer fk_live_…`. La key define la empresa y el modo: `fk_live_` para tickets reales, `fk_test_` para tickets de prueba. Una key mala, revocada o de una empresa sin acceso a la API responde siempre igual: `401 invalid_key`."
      }
    },
    "parameters": {
      "TicketId": {
        "name": "id",
        "in": "path",
        "required": true,
        "description": "El `id` del ticket.",
        "schema": { "$ref": "#/components/schemas/ObjectId" }
      },
      "IdempotencyKey": {
        "name": "Idempotency-Key",
        "in": "header",
        "required": false,
        "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.",
        "schema": { "type": "string", "minLength": 1, "maxLength": 255 },
        "example": "3f0c1d9e-6a57-4f43-9b0e-2f1c8d7a6b5e"
      },
      "WebhookUserAgent": {
        "name": "User-Agent",
        "in": "header",
        "required": true,
        "description": "Identifica a los webhooks de Facturín. Si lo filtras (en tu firewall o en tu receptor), compara solo el inicio, `Facturin-Webhooks/`: la versión y el resto pueden cambiar. La prueba de que el webhook es nuestro es la firma, no este header.",
        "schema": { "type": "string", "pattern": "^Facturin-Webhooks/" },
        "example": "Facturin-Webhooks/1 (+https://facturin.mx)"
      },
      "FacturinSignature": {
        "name": "Facturin-Signature",
        "in": "header",
        "required": true,
        "description": "`t=<unix>,v1=<hex>`: `v1` es el HMAC-SHA256, en hexadecimal, de `<t>.<cuerpo crudo>` con el secreto de tu endpoint. En las 24 horas después de rotar el secreto llega un `v1` por secreto (`t=<unix>,v1=<nuevo>,v1=<anterior>`): acepta el webhook si cualquiera coincide.",
        "schema": { "type": "string", "pattern": "^t=\\d{1,12}(,v1=[0-9a-f]{64})+$" },
        "example": "t=1761001382,v1=8f2b1c0a5d7e9f3b4a6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f0a"
      }
    },
    "headers": {
      "RateLimit-Limit": {
        "description": "Peticiones permitidas en la ventana de un minuto (de la cubeta más cerca de su límite).",
        "schema": { "type": "integer" }
      },
      "RateLimit-Remaining": {
        "description": "Peticiones que te quedan en esta ventana.",
        "schema": { "type": "integer" }
      },
      "RateLimit-Reset": {
        "description": "Segundos para que la ventana se reinicie.",
        "schema": { "type": "integer" }
      },
      "Retry-After": {
        "description": "Segundos que debes esperar antes de reintentar.",
        "schema": { "type": "integer" }
      }
    },
    "responses": {
      "Unauthorized": {
        "description": "Falta la key, está mal escrita, fue revocada o su empresa no tiene acceso a la API. La respuesta es la misma en todos los casos.",
        "headers": {
          "WWW-Authenticate": {
            "description": "`Bearer realm=\"facturin\", error=\"invalid_token\"`",
            "schema": { "type": "string" }
          }
        },
        "content": {
          "application/json": {
            "schema": { "$ref": "#/components/schemas/Error" },
            "example": { "error": { "code": "invalid_key", "message": "Invalid API key." } }
          }
        },
        "x-facturin-codes": ["invalid_key"]
      },
      "TicketNotFound": {
        "description": "No existe un ticket con ese id para tu key.",
        "content": {
          "application/json": {
            "schema": { "$ref": "#/components/schemas/Error" },
            "example": { "error": { "code": "ticket_not_found", "message": "No existe un ticket con ese id." } }
          }
        },
        "x-facturin-codes": ["ticket_not_found"]
      },
      "RateLimited": {
        "description": "Pasaste el límite de peticiones por minuto de tu key, o tu IP acumuló demasiados intentos con una key inválida. Espera los segundos de `Retry-After`.",
        "headers": {
          "Retry-After": { "$ref": "#/components/headers/Retry-After" },
          "RateLimit-Limit": { "$ref": "#/components/headers/RateLimit-Limit" },
          "RateLimit-Remaining": { "$ref": "#/components/headers/RateLimit-Remaining" },
          "RateLimit-Reset": { "$ref": "#/components/headers/RateLimit-Reset" }
        },
        "content": {
          "application/json": {
            "schema": { "$ref": "#/components/schemas/Error" },
            "example": {
              "error": {
                "code": "rate_limited",
                "message": "Too many requests. Retry after the number of seconds in the Retry-After header."
              }
            }
          }
        },
        "x-facturin-codes": ["rate_limited"]
      },
      "ServiceUnavailable": {
        "description": "No pudimos verificar tu key o tu límite en este momento, así que la petición no pasó. Reintenta después de `Retry-After`.",
        "headers": { "Retry-After": { "$ref": "#/components/headers/Retry-After" } },
        "content": {
          "application/json": {
            "schema": { "$ref": "#/components/schemas/Error" },
            "example": {
              "error": {
                "code": "service_unavailable",
                "message": "Temporarily unavailable. Retry after the number of seconds in the Retry-After header."
              }
            }
          }
        },
        "x-facturin-codes": ["service_unavailable"]
      },
      "InternalError": {
        "description": "Error nuestro. Reintenta en unos segundos; con `Idempotency-Key` el reintento de un `POST` es seguro.",
        "content": {
          "application/json": {
            "schema": { "$ref": "#/components/schemas/Error" },
            "example": { "error": { "code": "internal_error", "message": "Error interno. Reintenta en unos segundos." } }
          }
        },
        "x-facturin-codes": ["internal_error"]
      }
    },
    "schemas": {
      "ObjectId": {
        "type": "string",
        "pattern": "^[0-9a-f]{24}$",
        "examples": ["6720b2a1c2a9e81d4f0a1b9f"]
      },
      "TicketStatus": {
        "type": "string",
        "enum": ["processing", "invoiced", "closed"],
        "description": "`processing`: todavía trabajamos en él; si algo se atora, lo resolvemos nosotros (el plazo de 48 horas está en la guía). `invoiced`: timbrado, con `cfdi`. `closed`: cerrado sin CFDI de Facturín, con `reason`."
      },
      "ClosedReason": {
        "type": "string",
        "enum": ["not_invoiceable", "period_closed", "unreadable", "already_invoiced", "missing_csf", "other"],
        "description": "Por qué se cerró un ticket. Ver la tabla de motivos en la guía."
      },
      "Ticket": {
        "type": "object",
        "description": "Todos los campos vienen siempre; los que no aplican vienen en `null`.",
        "required": [
          "id",
          "livemode",
          "status",
          "reason",
          "reasonText",
          "externalId",
          "metadata",
          "emailNotifications",
          "companyId",
          "createdAt",
          "updatedAt",
          "extracted",
          "cfdi",
          "possibleDuplicateOf",
          "charged"
        ],
        "properties": {
          "id": { "$ref": "#/components/schemas/ObjectId" },
          "livemode": {
            "type": "boolean",
            "description": "`true` para un ticket real, `false` para uno de prueba."
          },
          "status": { "$ref": "#/components/schemas/TicketStatus" },
          "reason": {
            "description": "Solo en `closed`.",
            "oneOf": [{ "$ref": "#/components/schemas/ClosedReason" }, { "type": "null" }]
          },
          "reasonText": {
            "type": ["string", "null"],
            "description": "El motivo en español, para mostrárselo a una persona. Solo en `closed`."
          },
          "externalId": {
            "type": ["string", "null"],
            "maxLength": 128,
            "description": "Tu propio id, tal como lo mandaste."
          },
          "metadata": {
            "oneOf": [{ "$ref": "#/components/schemas/Metadata" }, { "type": "null" }]
          },
          "emailNotifications": {
            "type": "boolean",
            "description": "Si al dueño de la empresa le llega un correo con el desenlace de este ticket. En los tickets creados por la API es lo que mandaste en `emailNotifications` (por defecto `false`); en los de prueba siempre es `false`. El webhook llega igual."
          },
          "companyId": {
            "type": ["string", "null"],
            "description": "La constancia con la que se factura."
          },
          "createdAt": { "type": ["string", "null"], "format": "date-time" },
          "updatedAt": { "type": ["string", "null"], "format": "date-time" },
          "extracted": { "$ref": "#/components/schemas/TicketExtracted" },
          "cfdi": {
            "description": "Solo en `invoiced`.",
            "oneOf": [{ "$ref": "#/components/schemas/Cfdi" }, { "type": "null" }]
          },
          "possibleDuplicateOf": {
            "type": ["string", "null"],
            "description": "Una pista, no un estado: el id de otro ticket que parece ser el mismo comprobante. Mientras ese otro ticket sigue en proceso, este se queda en `processing`. Si el otro se timbra, este termina en `closed` con `already_invoiced` y no se cobra; si el otro no se pudo facturar, este se procesa normal."
          },
          "charged": {
            "type": "boolean",
            "description": "`true` solo cuando el CFDI se entregó y el ticket consumió su crédito. Mientras se factura, o si no se timbró, es `false`."
          }
        }
      },
      "TicketExtracted": {
        "type": "object",
        "description": "Lo que leímos de la foto. Es la lectura del ticket, no del CFDI: para contabilidad usa `cfdi`. En un ticket de prueba todos vienen en `null`, porque la foto no se lee.",
        "required": ["merchantName", "rfcEmisor", "folio", "date", "subtotal", "total"],
        "properties": {
          "merchantName": { "type": ["string", "null"] },
          "rfcEmisor": { "type": ["string", "null"] },
          "folio": { "type": ["string", "null"] },
          "date": { "type": ["string", "null"], "format": "date", "description": "Día del comprobante, AAAA-MM-DD." },
          "subtotal": { "type": ["number", "null"] },
          "total": { "type": ["number", "null"] }
        }
      },
      "Cfdi": {
        "type": "object",
        "description": "Los datos del CFDI, leídos del XML timbrado (no de la foto). En un ticket de prueba salen de un XML de ejemplo, sin validez fiscal.",
        "required": [
          "uuid",
          "fecha",
          "rfcEmisor",
          "nombreEmisor",
          "serie",
          "folio",
          "subtotal",
          "iva",
          "total",
          "xmlUrl",
          "pdfUrl"
        ],
        "properties": {
          "uuid": { "type": ["string", "null"], "description": "Folio fiscal (UUID del timbre), en mayúsculas." },
          "fecha": {
            "type": ["string", "null"],
            "description": "Atributo `Fecha` del comprobante, tal como lo imprime el CFDI: hora local de México, sin zona horaria.",
            "examples": ["2026-10-20T18:01:02"]
          },
          "rfcEmisor": { "type": ["string", "null"] },
          "nombreEmisor": { "type": ["string", "null"] },
          "serie": { "type": ["string", "null"] },
          "folio": { "type": ["string", "null"] },
          "subtotal": { "type": ["number", "null"] },
          "iva": {
            "type": ["number", "null"],
            "description": "IVA trasladado (impuesto 002). `0` cuando el CFDI no traslada IVA."
          },
          "total": { "type": ["number", "null"] },
          "xmlUrl": {
            "type": ["string", "null"],
            "format": "uri",
            "description": "`GET /tickets/{id}/cfdi/xml`, con tu key."
          },
          "pdfUrl": {
            "type": ["string", "null"],
            "format": "uri",
            "description": "`GET /tickets/{id}/cfdi/pdf`, con tu key."
          }
        }
      },
      "Metadata": {
        "type": "object",
        "description": "Tus propios datos, planos: valores de texto, número o booleano, hasta 4 KB serializado. Regresan tal cual en el ticket y en cada webhook.\n\nCon una key `fk_test_`, la llave `simulate` elige el desenlace del ticket de prueba: `invoiced` (también si no la mandas) o `closed:<reason>`, con un `reason` de `ClosedReason`. Cualquier otro valor responde `400 invalid_simulate`. Con una key live, `simulate` es un dato más.",
        "additionalProperties": { "type": ["string", "number", "boolean"] },
        "propertyNames": { "minLength": 1, "pattern": "^(?!\\$)(?!__proto__$)[^.]+$" }
      },
      "TicketList": {
        "type": "object",
        "required": ["data", "nextCursor"],
        "properties": {
          "data": { "type": "array", "items": { "$ref": "#/components/schemas/Ticket" } },
          "nextCursor": {
            "type": ["string", "null"],
            "description": "Mándalo como `cursor` para la siguiente página. `null` en la última."
          }
        }
      },
      "Company": {
        "type": "object",
        "required": ["id", "rfc", "businessName", "tradeName", "taxRegime", "createdAt"],
        "properties": {
          "id": { "$ref": "#/components/schemas/ObjectId" },
          "rfc": { "type": ["string", "null"] },
          "businessName": { "type": ["string", "null"], "description": "Razón social o nombre, como viene en la constancia." },
          "tradeName": { "type": ["string", "null"] },
          "taxRegime": { "type": ["string", "null"], "description": "Clave de régimen fiscal (c_RegimenFiscal)." },
          "createdAt": { "type": ["string", "null"], "format": "date-time" }
        }
      },
      "CompanyList": {
        "type": "object",
        "required": ["data"],
        "properties": {
          "data": { "type": "array", "items": { "$ref": "#/components/schemas/Company" } }
        }
      },
      "CreateTicketFields": {
        "type": "object",
        "properties": {
          "companyId": {
            "type": "string",
            "pattern": "^[0-9a-f]{24}$",
            "description": "La constancia con la que se factura (`GET /companies`). Opcional solo si tu empresa tiene una sola constancia activa; con varias, omitirlo responde `400 company_required`. Nunca se usa una constancia de otra empresa."
          },
          "usoCFDI": {
            "type": "string",
            "description": "Clave c_UsoCFDI del SAT. Si no la mandas, se usa `G03` (gastos en general).",
            "examples": ["G03"]
          },
          "formaPago": {
            "type": "string",
            "description": "Clave c_FormaPago del SAT. Si el ticket imprime la forma de pago sin ambigüedad, gana la del ticket.",
            "examples": ["04"]
          },
          "externalId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128,
            "description": "Tu propio id (viaje, pedido, gasto). Único por empresa y modo: repetirlo es `409 external_id_exists`."
          },
          "emailNotifications": {
            "type": "boolean",
            "default": false,
            "description": "`true` para que al dueño de la empresa también le llegue un correo cuando el ticket se facture o se cierre. Por defecto no se manda correo: tu sistema se entera por webhook. En multipart va como texto `true` o `false`."
          }
        }
      },
      "CreateTicketJson": {
        "allOf": [
          { "$ref": "#/components/schemas/CreateTicketFields" },
          {
            "type": "object",
            "required": ["imageUrl"],
            "properties": {
              "imageUrl": {
                "type": "string",
                "format": "uri",
                "pattern": "^https://",
                "description": "URL https pública de la foto (puerto por defecto, sin usuario ni contraseña). Se descarga en máximo 10 segundos, con hasta 3 redirecciones y hasta 10 MB."
              },
              "metadata": { "$ref": "#/components/schemas/Metadata" }
            }
          }
        ]
      },
      "CreateTicketMultipart": {
        "allOf": [
          { "$ref": "#/components/schemas/CreateTicketFields" },
          {
            "type": "object",
            "required": ["image"],
            "properties": {
              "image": {
                "type": "string",
                "contentMediaType": "application/octet-stream",
                "description": "La foto: JPEG, PNG, WebP o HEIC, reconocida por su contenido, no por su extensión. La petición multipart completa puede pesar hasta 4.5 MB (límite de la plataforma); para fotos de hasta 10 MB usa `imageUrl`."
              },
              "metadata": {
                "type": "string",
                "contentMediaType": "application/json",
                "description": "El mismo objeto de `metadata`, como texto JSON."
              }
            }
          }
        ]
      },
      "Error": {
        "type": "object",
        "required": ["error"],
        "properties": {
          "error": {
            "type": "object",
            "required": ["code", "message"],
            "properties": {
              "code": { "$ref": "#/components/schemas/ErrorCode" },
              "message": {
                "type": "string",
                "description": "Para la persona que lee el log; puede cambiar de redacción. Decide con `code`."
              },
              "ticketId": {
                "type": ["string", "null"],
                "description": "Solo en `external_id_exists`: el ticket que ya tiene ese `externalId`."
              }
            }
          }
        }
      },
      "ErrorCode": {
        "type": "string",
        "description": "El código es el contrato. Si recibes uno que no conoces, decide por el status HTTP.",
        "enum": [
          "invalid_key",
          "rate_limited",
          "service_unavailable",
          "internal_error",
          "unsupported_content_type",
          "invalid_body",
          "invalid_json",
          "invalid_idempotency_key",
          "invalid_company_id",
          "company_required",
          "invalid_uso_cfdi",
          "invalid_forma_pago",
          "invalid_external_id",
          "invalid_metadata",
          "invalid_email_notifications",
          "invalid_simulate",
          "invalid_image_url",
          "image_required",
          "image_too_large",
          "image_invalid",
          "image_fetch_failed",
          "no_credits",
          "company_not_found",
          "no_company",
          "idempotency_conflict",
          "idempotency_in_progress",
          "external_id_exists",
          "invalid_limit",
          "invalid_status",
          "invalid_date",
          "invalid_cursor",
          "ticket_not_found",
          "invalid_cfdi_type",
          "cfdi_not_available"
        ]
      },
      "WebhookEvent": {
        "type": "object",
        "description": "El cuerpo de un webhook. Se arma una vez, cuando ocurre el evento: cada reintento manda los mismos bytes.",
        "required": ["id", "type", "createdAt", "data"],
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^evt_[0-9a-f]{32}$",
            "description": "Id del evento, el mismo en cada reintento y reenvío: úsalo para no procesar dos veces. Un desenlace distinto del mismo ticket trae otro `id`."
          },
          "type": { "type": "string", "enum": ["ticket.invoiced", "ticket.closed", "ticket.updated"] },
          "createdAt": { "type": "string", "format": "date-time" },
          "data": { "$ref": "#/components/schemas/Ticket" }
        }
      }
    },
    "examples": {
      "TicketProcessing": {
        "summary": "Recién creado",
        "value": {
          "id": "6720b2a1c2a9e81d4f0a1b9f",
          "livemode": true,
          "status": "processing",
          "reason": null,
          "reasonText": null,
          "externalId": "VIAJE-2026-10-20-0042",
          "metadata": { "unidad": "T-114", "operador": "J. Pérez", "caseta": 3 },
          "emailNotifications": false,
          "companyId": "6720b1f4c2a9e81d4f0a1b2c",
          "createdAt": "2026-10-20T23:58:11.000Z",
          "updatedAt": "2026-10-20T23:58:11.000Z",
          "extracted": {
            "merchantName": null,
            "rfcEmisor": null,
            "folio": null,
            "date": null,
            "subtotal": null,
            "total": null
          },
          "cfdi": null,
          "possibleDuplicateOf": null,
          "charged": false
        }
      },
      "TicketInvoiced": {
        "summary": "Timbrado",
        "value": {
          "id": "6720b2a1c2a9e81d4f0a1b9f",
          "livemode": true,
          "status": "invoiced",
          "reason": null,
          "reasonText": null,
          "externalId": "VIAJE-2026-10-20-0042",
          "metadata": { "unidad": "T-114", "operador": "J. Pérez", "caseta": 3 },
          "emailNotifications": false,
          "companyId": "6720b1f4c2a9e81d4f0a1b2c",
          "createdAt": "2026-10-20T23:58:11.000Z",
          "updatedAt": "2026-10-21T00:04:37.000Z",
          "extracted": {
            "merchantName": "ESCUELA KEMPER URGATE",
            "rfcEmisor": "EKU9003173C9",
            "folio": "88120457",
            "date": "2026-10-20",
            "subtotal": 107.76,
            "total": 125
          },
          "cfdi": {
            "uuid": "5F1E9A3C-2B7D-4C1A-9E8F-0A1B2C3D4E5F",
            "fecha": "2026-10-20T18:01:02",
            "rfcEmisor": "EKU9003173C9",
            "nombreEmisor": "ESCUELA KEMPER URGATE",
            "serie": "A",
            "folio": "88120457",
            "subtotal": 107.76,
            "iva": 17.24,
            "total": 125,
            "xmlUrl": "https://facturin.mx/api/v1/tickets/6720b2a1c2a9e81d4f0a1b9f/cfdi/xml",
            "pdfUrl": "https://facturin.mx/api/v1/tickets/6720b2a1c2a9e81d4f0a1b9f/cfdi/pdf"
          },
          "possibleDuplicateOf": null,
          "charged": true
        }
      },
      "TicketClosed": {
        "summary": "Cerrado: ya estaba facturado",
        "value": {
          "id": "6720b30ec2a9e81d4f0a1bc4",
          "livemode": true,
          "status": "closed",
          "reason": "already_invoiced",
          "reasonText": "Este comprobante ya había sido facturado por otro medio.",
          "externalId": "VIAJE-2026-10-20-0043",
          "metadata": null,
          "emailNotifications": false,
          "companyId": "6720b1f4c2a9e81d4f0a1b2c",
          "createdAt": "2026-10-21T00:10:02.000Z",
          "updatedAt": "2026-10-21T00:15:40.000Z",
          "extracted": {
            "merchantName": "ESCUELA KEMPER URGATE",
            "rfcEmisor": "EKU9003173C9",
            "folio": "88120457",
            "date": "2026-10-20",
            "subtotal": 107.76,
            "total": 125
          },
          "cfdi": null,
          "possibleDuplicateOf": "6720b2a1c2a9e81d4f0a1b9f",
          "charged": false
        }
      },
      "TicketTestInvoiced": {
        "summary": "Prueba: timbrado con el CFDI de ejemplo",
        "value": {
          "id": "6720b2a1c2a9e81d4f0a1c07",
          "livemode": false,
          "status": "invoiced",
          "reason": null,
          "reasonText": null,
          "externalId": "PRUEBA-0001",
          "metadata": { "unidad": "T-114" },
          "emailNotifications": false,
          "companyId": "6720b1f4c2a9e81d4f0a1b2c",
          "createdAt": "2026-10-20T23:58:11.000Z",
          "updatedAt": "2026-10-20T23:58:41.000Z",
          "extracted": {
            "merchantName": null,
            "rfcEmisor": null,
            "folio": null,
            "date": null,
            "subtotal": null,
            "total": null
          },
          "cfdi": {
            "uuid": "CDC2E049-6169-45D5-B18F-602801596143",
            "fecha": "2026-10-20T17:58:41",
            "rfcEmisor": "XAXX010101000",
            "nombreEmisor": "EMISOR DE PRUEBA - SIN VALIDEZ FISCAL",
            "serie": "PRUEBA",
            "folio": "4F0A1C07",
            "subtotal": 100,
            "iva": 16,
            "total": 116,
            "xmlUrl": "https://facturin.mx/api/v1/tickets/6720b2a1c2a9e81d4f0a1c07/cfdi/xml",
            "pdfUrl": "https://facturin.mx/api/v1/tickets/6720b2a1c2a9e81d4f0a1c07/cfdi/pdf"
          },
          "possibleDuplicateOf": null,
          "charged": false
        }
      },
      "WebhookInvoiced": {
        "summary": "ticket.invoiced",
        "value": {
          "id": "evt_5649ac7c641341885368bc5a7036e8e0",
          "type": "ticket.invoiced",
          "createdAt": "2026-10-21T00:04:38.000Z",
          "data": {
            "id": "6720b2a1c2a9e81d4f0a1b9f",
            "livemode": true,
            "status": "invoiced",
            "reason": null,
            "reasonText": null,
            "externalId": "VIAJE-2026-10-20-0042",
            "metadata": { "unidad": "T-114", "operador": "J. Pérez", "caseta": 3 },
            "emailNotifications": false,
            "companyId": "6720b1f4c2a9e81d4f0a1b2c",
            "createdAt": "2026-10-20T23:58:11.000Z",
            "updatedAt": "2026-10-21T00:04:37.000Z",
            "extracted": {
              "merchantName": "ESCUELA KEMPER URGATE",
              "rfcEmisor": "EKU9003173C9",
              "folio": "88120457",
              "date": "2026-10-20",
              "subtotal": 107.76,
              "total": 125
            },
            "cfdi": {
              "uuid": "5F1E9A3C-2B7D-4C1A-9E8F-0A1B2C3D4E5F",
              "fecha": "2026-10-20T18:01:02",
              "rfcEmisor": "EKU9003173C9",
              "nombreEmisor": "ESCUELA KEMPER URGATE",
              "serie": "A",
              "folio": "88120457",
              "subtotal": 107.76,
              "iva": 17.24,
              "total": 125,
              "xmlUrl": "https://facturin.mx/api/v1/tickets/6720b2a1c2a9e81d4f0a1b9f/cfdi/xml",
              "pdfUrl": "https://facturin.mx/api/v1/tickets/6720b2a1c2a9e81d4f0a1b9f/cfdi/pdf"
            },
            "possibleDuplicateOf": null,
            "charged": true
          }
        }
      },
      "WebhookUpdated": {
        "summary": "ticket.updated",
        "value": {
          "id": "evt_0d4f1c2b9a8e7d6c5b4a39281706f5e4",
          "type": "ticket.updated",
          "createdAt": "2026-10-21T00:04:38.000Z",
          "data": {
            "id": "6720b2a1c2a9e81d4f0a1b9f",
            "livemode": true,
            "status": "invoiced",
            "reason": null,
            "reasonText": null,
            "externalId": "VIAJE-2026-10-20-0042",
            "metadata": { "unidad": "T-114", "operador": "J. Pérez", "caseta": 3 },
            "emailNotifications": false,
            "companyId": "6720b1f4c2a9e81d4f0a1b2c",
            "createdAt": "2026-10-20T23:58:11.000Z",
            "updatedAt": "2026-10-21T00:04:37.000Z",
            "extracted": {
              "merchantName": "ESCUELA KEMPER URGATE",
              "rfcEmisor": "EKU9003173C9",
              "folio": "88120457",
              "date": "2026-10-20",
              "subtotal": 107.76,
              "total": 125
            },
            "cfdi": {
              "uuid": "5F1E9A3C-2B7D-4C1A-9E8F-0A1B2C3D4E5F",
              "fecha": "2026-10-20T18:01:02",
              "rfcEmisor": "EKU9003173C9",
              "nombreEmisor": "ESCUELA KEMPER URGATE",
              "serie": "A",
              "folio": "88120457",
              "subtotal": 107.76,
              "iva": 17.24,
              "total": 125,
              "xmlUrl": "https://facturin.mx/api/v1/tickets/6720b2a1c2a9e81d4f0a1b9f/cfdi/xml",
              "pdfUrl": "https://facturin.mx/api/v1/tickets/6720b2a1c2a9e81d4f0a1b9f/cfdi/pdf"
            },
            "possibleDuplicateOf": null,
            "charged": true
          }
        }
      },
      "WebhookClosed": {
        "summary": "ticket.closed",
        "value": {
          "id": "evt_1d5486784921d69ed22d535114ea81fa",
          "type": "ticket.closed",
          "createdAt": "2026-10-21T00:15:41.000Z",
          "data": {
            "id": "6720b30ec2a9e81d4f0a1bc4",
            "livemode": true,
            "status": "closed",
            "reason": "unreadable",
            "reasonText": "El comprobante no se pudo leer completo para generar la factura.",
            "externalId": "VIAJE-2026-10-20-0043",
            "metadata": null,
            "emailNotifications": false,
            "companyId": "6720b1f4c2a9e81d4f0a1b2c",
            "createdAt": "2026-10-21T00:10:02.000Z",
            "updatedAt": "2026-10-21T00:15:40.000Z",
            "extracted": {
              "merchantName": null,
              "rfcEmisor": null,
              "folio": null,
              "date": null,
              "subtotal": null,
              "total": null
            },
            "cfdi": null,
            "possibleDuplicateOf": null,
            "charged": false
          }
        }
      }
    }
  }
}
