Skip to navigation
SectoresDocumentos de ajuste

24 · Nota de Crédito-Débito

Ajustes con crédito fiscal por DocumentoAjuste. Dos layouts: el clásico (nota_credito_debito) y el fiscal (nota_fiscal_credito_debito), elegidos con layout. Exige reference_invoice_id del mismo tenant y cliente. Ver también: 47 · Descuentos · 29 · Conciliación.

Cabecera (data)

CampoTipoObligatorioQué significa
monto_descuento_credito_debitonumberVer perfilDescuento del ajuste
monto_total_devueltonumberVer perfilTotal devuelto
monto_efectivo_credito_debitonumberNoOverride del crédito calculado
numero_nota_credito_debitostring/intVer perfilNúmero del documento

Detalle (items[].data)

Líneas estándar (sin campos sectoriales propios).

const nota = await supay.invoices.emit({
  point_of_sale_id: pos.id,
  customer: {
    document_type: "CI",
    document_number: "9971522",
    name: "Ramiro",
  },
  // Ajuste con layout explícito
  invoice_type: "credit_note",
  sector: "24",
  layout: "nota_fiscal_credito_debito",
  reference_invoice_id: "b61d67ed-7962-4989-958f-8ccc01979d64",
  // SKU de la factura ORIGINAL
  items: [
    {
      sku: "PROD-001",
      quantity: 1,
      price: 1250,
      discount: 0,
    },
  ],
});

Errores típicos

SituaciónRespuesta
Sin reference_invoice_id400 VALIDATION_ERROR
Sin layout (ambigüedad)400 — elige uno de los dos

POST /siat/documento-ajuste/{pos} está deprecado: emite siempre las notas por invoices (esta página), nunca directo al SIAT.