Notas de crédito y débito
Emitir notas de crédito y débito A, B o C con comprobantes asociados.
Las notas de crédito y débito deben incluir el comprobante original al que hacen referencia mediante comprobantesAsociados.
Nota de crédito
POST /api/wsfe/notas-creditoTipos soportados: 3 (NC A), 8 (NC B), 13 (NC C).
Nota de débito
POST /api/wsfe/notas-debitoTipos soportados: 2 (ND A), 7 (ND B), 12 (ND C).
Request
curl -X POST https://arca.api.com.ar/api/wsfe/notas-credito \
-H "Authorization: Bearer ak_TuSecretoAqui" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: nc-uuid-5678" \
-d '{
"environment": "homologacion",
"representada": "27111111118",
"cbteTipo": 8,
"ptoVta": 1,
"docTipo": 80,
"docNro": "30999888777",
"concepto": 1,
"condicionIvaReceptorId": 1,
"items": [
{
"cantidad": 1,
"descripcion": "Devolución parcial",
"precioUnitario": 5000.00,
"alicuotaIva": 21
}
],
"comprobantesAsociados": [
{
"tipo": 6,
"ptoVta": 1,
"nro": 42,
"cuit": "27111111118"
}
]
}'Parámetros adicionales
Igual que emitir factura, más:
| Campo | Tipo | Descripción |
|---|---|---|
comprobantesAsociados | array (requerido) | Comprobantes originales a los que refiere esta nota |
El campo email funciona igual que en las facturas: si lo mandás y la nota se aprueba, se le envía
al destinatario con el PDF adjunto (el asunto y el cuerpo dicen "nota de crédito" o "nota de
débito", según el cbteTipo). Ver Envío por email.
comprobantesAsociados[]
| Campo | Tipo | Descripción |
|---|---|---|
tipo | number | Tipo del comprobante original |
ptoVta | number | Punto de venta del comprobante original |
nro | number | Número del comprobante original |
cuit | string (11 dígitos) | CUIT del emisor del comprobante original |
cbteFch | string (opcional) | Fecha del comprobante original YYYYMMDD |
Emitir por referencia (clienteId / productoId)
Las notas comparten el contrato de emisión de las facturas, así que también aceptan clienteId en el comprobante y productoId en cada ítem, con exactamente las mismas reglas:
curl -X POST https://arca.api.com.ar/api/wsfe/notas-credito \
-H "Authorization: Bearer ak_TuSecretoAqui" \
-H "Content-Type: application/json" \
-d '{
"environment": "homologacion",
"representada": "27111111118",
"cbteTipo": 8,
"ptoVta": 1,
"concepto": 1,
"clienteId": "8f1c2b3a-4d5e-6f70-8192-a3b4c5d6e7f8",
"items": [
{ "productoId": "c3e5a7b9-1d2f-4068-8a9b-0c1d2e3f4a5b", "cantidad": 1 }
],
"comprobantesAsociados": [
{ "tipo": 6, "ptoVta": 1, "nro": 42, "cuit": "27111111118" }
]
}'comprobantesAsociados no se ve afectado: sigue siendo obligatorio y se escribe siempre a mano. Lo natural es referenciar al mismo cliente al que le emitiste la factura original.
Valen las mismas reglas que en las facturas —el campo explícito gana, el comprobante guarda valores y no punteros, y los mismos errores de resolución con 400 antes de llamar a ARCA—: ver Emitir por referencia.
Respuesta exitosa
{
"resultado": "A",
"cae": "75050000000002",
"caeFchVto": "20251225",
"cbteNro": 1,
"ptoVta": 1,
"cbteTipo": 8,
"observaciones": [],
"errores": [],
"pdfUrl": null
}Errores
Antes de reintentar una emisión, leé Reintentar sin duplicar el comprobante: un 502 no significa que el comprobante no se haya emitido.