Toku · Schema
CreateInvoiceBillingDataPayload
Cuerpo para registrar los datos de facturación de un Invoice.
FintechPaymentsB2BAutomationChile
Properties
| Name | Type | Description |
|---|---|---|
| cfdi_payment_method | object | Método de pago del SAT, y decide la forma del CFDI. `PUE` (pago en una sola exhibición) emite un comprobante por la transacción. `PPD` (pago en parcialidades o diferido) emite uno por Invoice y despué |
| cfdi_use | object | Clave de uso del CFDI según el catálogo del SAT: para qué declara el receptor este comprobante. `G03` es adquisición de mercancías, `P01` por definir. |
| checkout_session_id | string | Identificador de la Checkout Session, para registrar los datos cuando el Invoice todavía no existe. Alternativa a `id_invoice`. |
| id_invoice | object | Identificador público del Invoice. Se envía este o `checkout_session_id`, al menos uno de los dos. |
| item | object | Obsoleto: usa `items`. Si se envía, se trata como una lista de un elemento. Enviar los dos es un error. |
| items | array | Conceptos que se facturan. Obligatorio: se envía este o `item`. |
| observations | string | Texto libre que se guarda junto a los datos de facturación. No viaja al CFDI. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/toku/json-schema/toku-create-invoice-billing-data-payload-schema.json",
"title": "CreateInvoiceBillingDataPayload",
"description": "Cuerpo para registrar los datos de facturación de un Invoice.",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/toku-facturaci-n-api-openapi.yml#/components/schemas/CreateInvoiceBillingDataPayload",
"properties": {
"cfdi_payment_method": {
"allOf": [
{
"$ref": "#/$defs/CfdiPaymentMethod"
}
],
"description": "Método de pago del SAT, y decide la forma del CFDI. `PUE` (pago en una sola exhibición) emite un comprobante por la transacción. `PPD` (pago en parcialidades o diferido) emite uno por Invoice y después un complemento de pago por cada cobro."
},
"cfdi_use": {
"allOf": [
{
"$ref": "#/$defs/CfdiUse"
}
],
"description": "Clave de uso del CFDI según el catálogo del SAT: para qué declara el receptor este comprobante. `G03` es adquisición de mercancías, `P01` por definir."
},
"checkout_session_id": {
"description": "Identificador de la Checkout Session, para registrar los datos cuando el Invoice todavía no existe. Alternativa a `id_invoice`.",
"title": "Checkout Session Id",
"type": "string"
},
"id_invoice": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"description": "Identificador público del Invoice. Se envía este o `checkout_session_id`, al menos uno de los dos.",
"title": "Id Invoice"
},
"item": {
"allOf": [
{
"$ref": "#/$defs/InvoiceBillingDataItemPayload"
}
],
"deprecated": true,
"description": "Obsoleto: usa `items`. Si se envía, se trata como una lista de un elemento. Enviar los dos es un error.",
"title": "Item"
},
"items": {
"description": "Conceptos que se facturan. Obligatorio: se envía este o `item`.",
"items": {
"$ref": "#/$defs/InvoiceBillingDataItemPayload"
},
"title": "Items",
"type": "array"
},
"observations": {
"description": "Texto libre que se guarda junto a los datos de facturación. No viaja al CFDI.",
"title": "Observations",
"type": "string"
}
},
"required": [
"cfdi_use",
"cfdi_payment_method"
],
"type": "object",
"$defs": {
"CfdiPaymentMethod": {
"description": "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.",
"enum": [
"PUE",
"PPD"
],
"title": "CfdiPaymentMethod",
"type": "string"
},
"CfdiUse": {
"description": "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.",
"enum": [
"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"
],
"title": "CfdiUse",
"type": "string"
},
"InvoiceBillingDataItemPayload": {
"description": "Concepto que se factura, con sus impuestos.",
"properties": {
"identification_number": {
"description": "Tu propio código de producto, que viaja al CFDI como `NoIdentificacion`. Sirve para cruzar el concepto contra tu catálogo interno.",
"maxLength": 100,
"title": "Identification Number",
"type": "string"
},
"product_code": {
"description": "Clave del producto o servicio según el catálogo del SAT.",
"title": "Product Code",
"type": "string"
},
"product_description": {
"description": "Descripción del concepto tal como aparecerá en el CFDI.",
"title": "Product Description",
"type": "string"
},
"quantity": {
"default": 1,
"description": "Cantidad de unidades del concepto. Si es mayor que 1, `unit_price` es obligatorio.",
"title": "Quantity",
"type": "integer"
},
"tax_object": {
"default": "02",
"description": "Clave de objeto de impuesto del SAT: `01` no objeto, `02` sí objeto, `03` sí objeto y no obligado al desglose.",
"title": "Tax Object",
"type": "string"
},
"taxes": {
"description": "Impuestos del concepto. Va una lista vacía si el concepto no los lleva.",
"items": {
"$ref": "#/$defs/InvoiceBillingDataTaxPayload"
},
"title": "Taxes",
"type": "array"
},
"unit_code": {
"description": "Clave de la unidad de medida según el catálogo del SAT. `E48` es unidad de servicio.",
"title": "Unit Code",
"type": "string"
},
"unit_price": {
"description": "Precio unitario antes de impuestos. Si se omite, Toku lo deriva del monto del Invoice. Se redondea a seis decimales.",
"title": "Unit Price",
"type": "number"
}
},
"required": [
"product_code",
"product_description",
"unit_code",
"taxes"
],
"title": "InvoiceBillingDataItemPayload",
"type": "object"
},
"InvoiceBillingDataTaxPayload": {
"description": "Impuesto que se aplica sobre un concepto.",
"properties": {
"is_retention": {
"description": "`true` si el impuesto es una retención, `false` si es trasladado. Viaja al CFDI para que el SAT lo clasifique.",
"title": "Is Retention",
"type": "boolean"
},
"name": {
"description": "Nombre del impuesto según el catálogo del SAT.",
"title": "Name",
"type": "string"
},
"rate": {
"description": "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.",
"title": "Rate",
"type": "number"
}
},
"required": [
"rate",
"is_retention",
"name"
],
"title": "InvoiceBillingDataTaxPayload",
"type": "object"
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/toku-create-invoice-billing-data-payload"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.