---
title: "Obtener datos de facturación de un Invoice"
method: GET
path: "/invoice-billing-data/{identifier}"
tags: ["Facturación"]
---

# Obtener datos de facturación de un Invoice

`GET /invoice-billing-data/{identifier}`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/invoice-billing-data/{identifier}`
- Auth: API key in header `x-api-key`

Devuelve los datos de facturación de un Invoice por su identificador.

Falla con `404` si el Invoice o sus datos de facturación no existen en la organización.

## Path parameters

- `identifier` string, required: Identificador público del Invoice, o el de la Checkout Session con la que se registraron sus datos si el Invoice todavía no existe. Se distinguen por el prefijo.

## Headers

- `x-account-key` string

## Response `200`

Successful Response

- GetInvoiceBillingDataResponse: Datos con los que se emitirá el CFDI de un Invoice.
  - `cfdi_payment_method` 'PUE' | 'PPD', required: Método de pago del CFDI, según el catálogo `c_MetodoPago` del SAT mexicano: `PUE` (pago en una sola exhibición) cuando el comprobante se paga completo de una vez, y `PPD` (pago en parcialidades o diferido) cuando se paga en cuotas o después de emitido.
  - `cfdi_use` 'CN01' | 'CP01' | 'D01' | 'D02' | 'D03' | 'D04' | 'D05' | 'D06' | 'D07' | 'D08' | 'D09' | 'D10' | 'G01' | 'G02' | 'G03' | 'I01' | 'I02' | 'I03' | 'I04' | 'I05' | 'I06' | 'I07' | 'I08' | 'P01' | 'S01', required: Clave de uso del CFDI: para qué declara el receptor el comprobante fiscal ante el SAT. Los valores son las claves del catálogo `c_UsoCFDI` que publica el SAT mexicano, no una codificación de Toku, y el receptor es quien determina cuál corresponde.
  - `checkout_session_id` string
  - `id_invoice` string
  - `issued` boolean
  - `item` InvoiceBillingDataItemPayload: Concepto que se factura, con sus impuestos.
    - `identification_number` string: Tu propio código de producto, que viaja al CFDI como `NoIdentificacion`. Sirve para cruzar el concepto contra tu catálogo interno.
    - `product_code` string, required: Clave del producto o servicio según el catálogo del SAT.
    - `product_description` string, required: Descripción del concepto tal como aparecerá en el CFDI.
    - `quantity` integer: Cantidad de unidades del concepto. Si es mayor que 1, `unit_price` es obligatorio.
    - `tax_object` string: Clave de objeto de impuesto del SAT: `01` no objeto, `02` sí objeto, `03` sí objeto y no obligado al desglose.
    - `taxes` InvoiceBillingDataTaxPayload[], required: Impuestos del concepto. Va una lista vacía si el concepto no los lleva.
      - `is_retention` boolean, required: `true` si el impuesto es una retención, `false` si es trasladado. Viaja al CFDI para que el SAT lo clasifique.
      - `name` string, required: Nombre del impuesto según el catálogo del SAT.
      - `rate` number, required: Tasa del impuesto expresada como fracción, no como porcentaje: el 16% de IVA es `0.16`. La suma de las tasas de un concepto no puede pasar de 1.
    - `unit_code` string, required: Clave de la unidad de medida según el catálogo del SAT. `E48` es unidad de servicio.
    - `unit_price` number: Precio unitario antes de impuestos. Si se omite, Toku lo deriva del monto del Invoice. Se redondea a seis decimales.
  - `items` InvoiceBillingDataItemPayload[]: Conceptos que se facturan. Obligatorio: se envía este o `item`.
    - `identification_number` string: Tu propio código de producto, que viaja al CFDI como `NoIdentificacion`. Sirve para cruzar el concepto contra tu catálogo interno.
    - `product_code` string, required: Clave del producto o servicio según el catálogo del SAT.
    - `product_description` string, required: Descripción del concepto tal como aparecerá en el CFDI.
    - `quantity` integer: Cantidad de unidades del concepto. Si es mayor que 1, `unit_price` es obligatorio.
    - `tax_object` string: Clave de objeto de impuesto del SAT: `01` no objeto, `02` sí objeto, `03` sí objeto y no obligado al desglose.
    - `taxes` InvoiceBillingDataTaxPayload[], required: Impuestos del concepto. Va una lista vacía si el concepto no los lleva.
      - `is_retention` boolean, required: `true` si el impuesto es una retención, `false` si es trasladado. Viaja al CFDI para que el SAT lo clasifique.
      - `name` string, required: Nombre del impuesto según el catálogo del SAT.
      - `rate` number, required: Tasa del impuesto expresada como fracción, no como porcentaje: el 16% de IVA es `0.16`. La suma de las tasas de un concepto no puede pasar de 1.
    - `unit_code` string, required: Clave de la unidad de medida según el catálogo del SAT. `E48` es unidad de servicio.
    - `unit_price` number: Precio unitario antes de impuestos. Si se omite, Toku lo deriva del monto del Invoice. Se redondea a seis decimales.
  - `observations` string: Texto libre que se guarda junto a los datos de facturación. No viaja al CFDI.

## Other responses

- `401`: Faltan las credenciales o son inválidas.
- `403`: No tienes acceso a este recurso.
- `404`: El recurso solicitado no existe.
- `422`: El cuerpo de la petición no pasó la validación.
- `429`: Se superó el límite de peticiones permitidas.

---

[API](https://skmtc.dev/trytoku/apis/toku-api.md) - [All operations](https://skmtc.dev/trytoku/apis/toku-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytoku/apis/toku-api/revisions/a6ef070075b1?raw)