Upnify Documentación API
CRM · /facturacion/facturas/:tk

Facturación

Detalle de factura

GET/facturacion/facturas/:tk

Obtiene la información de una factura específica y admite paginación.

Parámetros

NombreTipoValidaciónDescripción
tkStringRequeridoCódigo token del registro.
paginaIntegerValor de pagina.
cantidadRegistrosIntegerValor de cantidadRegistros.

Respuesta

NombreTipoDescripción
indiceIntegerPosición o índice.
tkVentaStringCódigo token de la venta.
razonEmisorStringValor de razonEmisor.
tkRazonEmisorStringCódigo token del emisor.
razonReceptorStringValor de razonReceptor.
tkRazonReceptorStringCódigo token del receptor.
idMetodoPagoIntegerIdentificador del método de pago SAT.
metodoPagoStringMétodo de pago.
idFormaPagoIntegerIdentificador de la forma de pago SAT.
formaPagoStringForma de pago.
folioStringNúmero de folio.
tkFolioStringCódigo token del folio.
uuidStringUUID fiscal.
fechaTimbradoDateFecha de timbrado.
fechaDateFecha.
tkArchivoPdfStringCódigo token del PDF.
tkArchivoXMLStringCódigo token del XML.
statusIntegerEstado.
adjuntarIntegerIndica si se adjuntan archivos.
timbradoErrorStringError de timbrado.
timbradoErrorTxtStringDescripción del error de timbrado.
cancelacionErrorStringDescripción del error de cancelación.
tipoComprobanteStringTipo de comprobante.
tipoComprobanteTxtStringDescripción del tipo de comprobante.
tkCompaniaStringCódigo token de la compañía.
tipoDeCambioStringTipo de cambio.
idMonedaStringClave de moneda.
simboloStringSímbolo.
tkSucursalStringCódigo token de la sucursal.
impuestosTrasladadosFloatImpuestos trasladados.
impuestosRetenidosFloatImpuestos retenidos.
montoFloatMonto.
descuentosFloatDescuentos.
totalFloatTotal.
cancelarFacturaIntegerIndica si puede cancelarse.
tkStringCódigo token del registro.
pesoFloatPeso.

Solicitud

Solicitud

curl --request GET \
  --url 'https://api.upnify.com/v4/facturacion/facturas/00000000-0000-4000-8000-000000000001?pagina=1&cantidadRegistros=50' \
  --header 'token: 00000000-0000-4000-8000-000000000001'

Respuesta

Respuesta exitosa

JSON
[
  {
    "indice": 1,
    "tkVenta": "valor-de-ejemplo",
    "razonEmisor": "valor-de-ejemplo",
    "tkRazonEmisor": "valor-de-ejemplo",
    "razonReceptor": "valor-de-ejemplo",
    "tkRazonReceptor": "valor-de-ejemplo",
    "idMetodoPago": 1,
    "metodoPago": "valor-de-ejemplo",
    "idFormaPago": 1,
    "formaPago": "valor-de-ejemplo",
    "folio": 1,
    "tkFolio": "valor-de-ejemplo",
    "uuid": "00000000-0000-4000-8000-000000000020",
    "fechaTimbrado": "2026-01-15T12:00:00.000Z",
    "fecha": "2026-01-15T12:00:00.000Z",
    "tkArchivoPdf": "valor-de-ejemplo",
    "tkArchivoXML": "valor-de-ejemplo",
    "status": 1,
    "adjuntar": 1,
    "timbradoError": "valor-de-ejemplo",
    "timbradoErrorTxt": "valor-de-ejemplo",
    "cancelacionError": "valor-de-ejemplo",
    "tipoComprobante": "valor-de-ejemplo",
    "tipoComprobanteTxt": "valor-de-ejemplo",
    "tkCompania": "valor-de-ejemplo",
    "tipoDeCambio": "valor-de-ejemplo",
    "idMoneda": "valor-de-ejemplo",
    "simbolo": "valor-de-ejemplo",
    "tkSucursal": "valor-de-ejemplo",
    "impuestosTrasladados": 100.5,
    "impuestosRetenidos": 100.5,
    "monto": 100.5,
    "descuentos": 100.5,
    "total": 100.5,
    "cancelarFactura": 1,
    "tk": "valor-de-ejemplo",
    "peso": 100.5
  }
]