{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/toku/json-schema/toku-invoice-billing-data-response-schema.json",
  "title": "InvoiceBillingDataResponse",
  "description": "Datos con los que se emitirá el CFDI 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/InvoiceBillingDataResponse",
  "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": {
      "title": "Checkout Session Id",
      "type": "string"
    },
    "id_invoice": {
      "title": "Id Invoice",
      "type": "string"
    },
    "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"
    }
  }
}