La API

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=1 sin 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)