# Emitir nota de débito: POST /bill/receipts/debit-note/

- Método y ruta: `POST /bill/receipts/debit-note/`
- Scope: `invoices:write`
- Recurso: Facturación

## Qué hace

Ajusta al alza un comprobante existente. Con un token `yf_test_*` (sandbox) este endpoint no llama a AFIP: persiste un comprobante simulado (`simulated: true`, `livemode: false`, un CAE sintético) en la base sandbox aislada del tenant. Requiere scope `invoices:write`. En un tenant que factura con SIFEN (Paraguay) responde 409 con `error_code: use_sifen_routes`: emití con `POST /sales/` y las notas con `POST /sales/{sale_id}/credit_note/`. Notas de crédito y débito sobre comprobantes de un CUIT dado de baja: se permiten mientras ese CUIT no lo haya registrado otra cuenta; si lo registró otra responde 409 `API_PARTNER_NOTE_ISSUER_CLAIMED_ELSEWHERE`, y si ARCA ya no lista la delegación la nota queda pendiente con `API_PARTNER_NOTE_ISSUER_DELEGATION_MISSING`.

## Cuerpo del request (application/json)

| Campo | Tipo | Requerido | Descripción |
| --- | --- | --- | --- |
| `comprobante_asociado_id` | string | sí | Id del comprobante (factura) que esta nota ajusta. |
| `motivo` | string | no |  |
| `items` | array de object | sí |  |
| `importe_total` | number | no |  |
| `ambiente` | string | no | Ignorado: el ambiente sale de la configuración de la cuenta. Valores: production, testing. Por defecto: production. |

## Errores

| Estado | Descripción | Código |
| --- | --- | --- |
| 400 | Solicitud inválida (body ausente o con formato incorrecto). | `VALIDATION_ERROR` |
| 401 | Falta autenticación o el token es inválido/expiró. | `UNAUTHORIZED` |
| 403 | El token no tiene el/los scope(s) requeridos, o el plan del tenant no habilita el módulo. | `FORBIDDEN` |
| 422 | Semánticamente inválido — incluye la reutilización de un Idempotency-Key con un body distinto. | `UNPROCESSABLE_ENTITY` |
| 429 | Se superó el rate limit del endpoint o del tenant. Ver headers `X-RateLimit-*` y `Retry-After`. | `RATE_LIMITED` |

Referencia completa: https://yo-facturo.com/dev/referencia/