---
title: "Nota de Crédito"
method: POST
path: "/billing-documents/credit-note"
---

# Nota de Crédito

`POST /billing-documents/credit-note`

## Request body

- object
  - `provider_external_id` string, required
  - `reason` string
  - `amount` number, float
  - `payment_form` string, required
  - `items` object, required
    - `product_code` string, required — Clave del producto a facturar según el SAT
    - `product_description` string, required — Descripción del producto a facturar
    - `unit_code` string, required — Clave de Unidad de Medida del producto a facturar según el SAT
    - `quantity` integer, required — Cantidad del producto a facturar. Por default es 1
    - `unit_price` number, float — Para las Notas de Crédito es obligatorio. Para las Facturas, si no se envía, se usa el monto de la Invoice para calcular este campo
    - `tax_object` string, required — Código de impuestos según el SAT
    - `taxes` object[]
      - `rate` number, float, required — Monto del impuesto a aplicar
      - `is_retention` boolean, required — Indica si el impuesto es retenido
      - `name` 'IVA' | 'ISR' | 'IEPS' | 'IVA RET' | 'IVA Exento', required
  - `date` string, date — La fecha en formato ISO

## Response `201`

201

- object
  - `id_billing_document` string
  - `id_invoice` string
  - `id_transaction` string
  - `id_account` string
  - `id_customer` string
  - `status` string
  - `type` string
  - `folio` string
  - `issue_date` string
  - `sub_total` integer
  - `discount` integer
  - `total` integer
  - `pdf_url` string
  - `xml_url` string
  - `provider_external_id` string
  - `fiscal_billing_id` string
  - `related_fiscal_billing_id` string
  - `tax_id` string
  - `tax_regime` string
  - `tax_zip_code` string
  - `billing_address` string
  - `billing_email` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/trytoku/apis/toku-api.md) · [All operations](https://skmtc.net/trytoku/apis/toku-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trytoku/toku-api/versions/30699b13e0d0/schema)