Referencia de la API
Cada ruta, por grupo. Todas van en https://facturaloypunto.com/api/v1 con Authorization: Bearer tk_…; lo que timbra pide Idempotency-Key. Los ejemplos están en Empieza en tres pasos.
Referencia OpenAPI 3.1 (.yaml)
Facturas
- GET
/facturasLas últimas 50 facturas de la empresa (?estado=filtra) - POST
/facturasTimbrar una factura (ingreso) - GET
/facturas/{id}Una factura, con su receptor, lo que falta por cobrar y su cancelación - GET
/facturas/{id}/xmlEl XML timbrado (con su addenda si la tiene;?original=1sin ella) - GET
/facturas/{id}/pdfEl PDF - GET
/facturas/{id}/acuseEl acuse de cancelación del SAT (XML; o el PDF que se registró a mano) - POST
/facturas/{id}/cancelarCancelar ante el SAT - POST
/facturas/{id}/reenviarMandar otra vez por correo una factura timbrada (con su PDF y su XML) - POST
/facturas/{id}/addendaAgregar la addenda que pide una cadena (a una copia del XML; el timbrado no se toca) - POST
/facturas/globalFactura global de público en general con los tickets sin facturar del periodo
Pagos
- POST
/pagosRegistrar un pago recibido y timbrar su complemento (REP)
Traslados
- POST
/trasladosTraslado de mercancía propia (Carta Porte 3.1 o salida al extranjero con comercio exterior)
Retenciones
- GET
/retencionesLas últimas 50 constancias de retenciones - POST
/retencionesTimbrar una constancia de retenciones e información de pagos 2.0 - GET
/retenciones/{id}Una constancia - GET
/retenciones/{id}/{formato}Su XML o su PDF - POST
/retenciones/{id}/cancelarCancelar una constancia (motivos 01, 02 o 03; no usa folio)
Autofacturación
- GET
/tickets/{codigo}Un ticket por su código (estatus, liga del portal y QR) - POST
/ticketsCrear un ticket de venta para que el cliente lo facture en el portal
Clientes y catálogos
- GET
/clientesLos clientes de la empresa (hasta 200;?q=busca por nombre o RFC) - GET
/catalogos/productos-serviciosBuscar en c_ClaveProdServ del SAT (por clave o palabras, sin importar acentos) - GET
/catalogos/unidadesBuscar en c_ClaveUnidad del SAT - POST
/constanciaLeer la Constancia de Situación Fiscal (PDF o foto de su código QR)
Cuenta
- GET
/cuentaFolios, plan y sello de la empresa de la llave
Plataformas conectadas
- POST
/socios/canjearCambiar el código de la conexión por la llave de la empresa del negocio (servidor a servidor) - POST
/socios/desconectarDesconectar el negocio (revoca la llave con que se llama y su aviso) - POST
/sesionesLiga para entrar a Factúralo y Punto ya con sesión (un solo uso, 60 s; sólo plataformas verificadas)