Ir al contenido
Autofactura

FISCALISTO / API / REFERENCIA

Ver un ticket

Abrir en ChatGPTAbrir en Claude
GET
/v1/tickets/{id}

Un ticket de autofactura: si ya se facturó (invoice) o entró en la factura global (global_invoice).

Autorización

bearerAuth
headerAutorizaciónBearer <llave>

Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.

Parámetros de la ruta

id*string

El id del objeto.

Cuerpo de la respuesta

Correcto.

application/json
  1. response

Una venta que su comprador puede facturar él mismo en el portal del emisor (autofactura).

id*string

Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_).

livemode*boolean

true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT.

object*string

Qué tipo de objeto es («invoice», «customer»…).

issuer*string

El emisor que vendió.

folio*string

El folio de la venta en su sistema.

code*string

Lo que su comprador escribe en el portal junto con el total: el folio y 4 caracteres al azar (A123-K7QX). Imprímalo en el ticket o mándelo con la compra.

status*string

pending (se puede facturar), invoiced (su comprador lo facturó: la factura en invoice), global (entró en la factura global del periodo) o cancelled.

Uno de"pending""invoiced""global""cancelled"
url*|

La página del portal con el código ya escrito: el comprador pone el total y sus datos. Puede incrustarla con fiscalisto.js. null si ya no está pendiente.

total*number

Lo que se cobró, impuestos incluidos y sin propina.

tip*number

La propina (no va en la factura).

payment_form*string

c_FormaPago de la venta.

description*string

El concepto de la factura.

product_key*string

c_ClaveProdServ del concepto.

sold_at*string

Cuándo se vendió.

Formatodate-time
invoiceable_until*string

El último día (AAAA-MM-DD) en que el comprador puede facturarlo; después entra en la factura global.

invoice*|

La factura (inv_…) que hizo su comprador, o null.

global_invoice*|

La factura global (inv_…) en que entró, o null.

customer*|

A quién se facturó, o null.

created_at*|

Cuándo se registró.

curl -X GET 'https://api.fiscalisto.com/v1/tickets/string' \  -H 'Authorization: Bearer fk_test_…'
{  "id": "tkt_OufpKqnrvx9p6hW1yQbT3mZr8sKdLx0VeN",  "object": "ticket",  "livemode": false,  "issuer": "iss_OufpKqnrvx9p",  "folio": "A1042",  "code": "A1042-K7QX",  "status": "pending",  "url": "https://fiscalisto.com/autofactura/Tx8mQ2vLp9WnR4c?c=A1042-K7QX",  "total": 580,  "tip": 0,  "payment_form": "04",  "description": "Consumo de alimentos",  "product_key": "90101501",  "sold_at": "2026-10-24T14:32:00-06:00",  "invoiceable_until": "2026-10-31",  "invoice": null,  "global_invoice": null,  "customer": null,  "created_at": "2026-10-24T14:32:05-06:00"}

Registrar un ticket POST

Una venta que su comprador factura él mismo: con el código (code) y el total en el portal del emisor (url, que puede incrustar en su página con fiscalisto.js), da sus datos fiscales y la factura se timbra al momento con los timbres de su cuenta. Lo que nadie factura entra solo en la factura global del periodo. Registrar otra vez el mismo folio con el mismo total contesta el ticket que ya existe (los reintentos son seguros); con otro total, 409.

Cancelar un ticket DELETE

Una venta que no se hizo (devolución, error): ya no se puede facturar ni entra en la factura global. Solo mientras esté pendiente.