Notas de crédito y débito

Una nota modifica una factura o una boleta ya emitida. La nota de crédito (tipo 07) la reduce o la deja sin efecto; la nota de débito (tipo 08) le suma un cargo.

Nota de crédito

curl https://api.emitay.com/v1/credit_notes \
  -H "Authorization: Bearer $EMITAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "series": "FC01",
    "reason_code": "01",
    "reason_description": "Anulación de la operación",
    "affected_document": { "series": "F001", "number": 1 },
    "customer": { "document_number": "20100066603", "name": "CLIENTE S.A." },
    "items": [
      {
        "description": "Servicio de consultoría",
        "quantity": 2,
        "unit_price": "50.00"
      }
    ]
  }'

$cabeceras = @{
  Authorization = "Bearer $env:EMITAY_API_KEY"
}
$cuerpo = @'
{
  "series": "FC01",
  "reason_code": "01",
  "reason_description": "Anulación de la operación",
  "affected_document": { "series": "F001", "number": 1 },
  "customer": { "document_number": "20100066603", "name": "CLIENTE S.A." },
  "items": [
    {
      "description": "Servicio de consultoría",
      "quantity": 2,
      "unit_price": "50.00"
    }
  ]
}
'@
Invoke-RestMethod -Method Post `
  -Uri https://api.emitay.com/v1/credit_notes `
  -Headers $cabeceras `
  -ContentType "application/json; charset=utf-8" `
  -Body $cuerpo

import { Emitay } from "emitay";

const emitay = new Emitay(); // toma la llave de EMITAY_API_KEY

const nota = await emitay.creditNotes.create({
  series: "FC01",
  reason_code: "01",
  reason_description: "Anulación de la operación",
  affected_document: { series: "F001", number: 1 },
  customer: { document_number: "20100066603", name: "CLIENTE S.A." },
  items: [
    { description: "Servicio de consultoría", quantity: 2, unit_price: "50.00" },
  ],
});

affected_document es el comprobante que se modifica, por su serie y número. Su tipo se deduce de la serie (F… factura, B… boleta).
series de la nota empieza con la misma letra que el comprobante que modifica: FC01 para facturas, BC01 para boletas. Es una serie aparte, con su propio correlativo.
items son lo que la nota afecta. Para dejar sin efecto la operación entera, repite los ítems del comprobante; para una devolución parcial o un descuento, solo esa parte.
customer es el del comprobante original.

Motivos (catálogo 09)

`reason_code`	Motivo
`01`	Anulación de la operación
`02`	Anulación por error en el RUC
`03`	Corrección por error en la descripción
`04`	Descuento global (solo sobre facturas)
`05`	Descuento por ítem (solo sobre facturas)
`06`	Devolución total
`07`	Devolución por ítem
`08`	Bonificación (solo sobre facturas)
`09`	Disminución en el valor
`10`	Otros conceptos
`11`	Ajustes de operaciones de exportación
`12`	Ajustes afectos al IVAP
`13`	Corrección del monto neto pendiente de pago o de las fechas de vencimiento de las cuotas (solo sobre facturas al crédito)

reason_description es el sustento con tus palabras: se imprime y va a SUNAT.

Nota de débito

curl https://api.emitay.com/v1/debit_notes \
  -H "Authorization: Bearer $EMITAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "series": "FD01",
    "reason_code": "01",
    "reason_description": "Intereses por mora",
    "affected_document": { "series": "F001", "number": 1 },
    "customer": { "document_number": "20100066603", "name": "CLIENTE S.A." },
    "items": [
      { "description": "Intereses por mora", "quantity": 1, "unit_price": "15.00" }
    ]
  }'

$cabeceras = @{
  Authorization = "Bearer $env:EMITAY_API_KEY"
}
$cuerpo = @'
{
  "series": "FD01",
  "reason_code": "01",
  "reason_description": "Intereses por mora",
  "affected_document": { "series": "F001", "number": 1 },
  "customer": { "document_number": "20100066603", "name": "CLIENTE S.A." },
  "items": [
    { "description": "Intereses por mora", "quantity": 1, "unit_price": "15.00" }
  ]
}
'@
Invoke-RestMethod -Method Post `
  -Uri https://api.emitay.com/v1/debit_notes `
  -Headers $cabeceras `
  -ContentType "application/json; charset=utf-8" `
  -Body $cuerpo

import { Emitay } from "emitay";

const emitay = new Emitay(); // toma la llave de EMITAY_API_KEY

const nota = await emitay.debitNotes.create({
  series: "FD01",
  reason_code: "01",
  reason_description: "Intereses por mora",
  affected_document: { series: "F001", number: 1 },
  customer: { document_number: "20100066603", name: "CLIENTE S.A." },
  items: [{ description: "Intereses por mora", quantity: 1, unit_price: "15.00" }],
});

Motivos (catálogo 10)

`reason_code`	Motivo
`01`	Intereses por mora
`02`	Aumento en el valor
`03`	Penalidades / otros conceptos
`11`	Ajustes de operaciones de exportación
`12`	Ajustes afectos al IVAP
`13`	Penalidades

Lo que una nota no lleva

Una nota no admite discount, detraction, prepayments ni perception: enviarlos responde 422. Lo demás de un ítem (tax_affectation, isc, icbper, unit_code) sí.

¿Nota de crédito o anulación?

Situación	Qué usar
El comprobante fue aceptado, no se entregó al cliente y no pasaron 7 días desde su emisión	Anular
El comprobante ya se entregó al cliente, o pasó el plazo	Nota de crédito con motivo `01`
Devolución o descuento posterior a la venta	Nota de crédito (`06`, `07`, `04`, `05`)

Una nota se anula igual que el comprobante que modifica.

Los campos de cada una están en la referencia: nota de crédito y nota de débito.