Documento Asociado
Schema del documento asociado — referencia a la factura original para notas de crédito y débito.
El objeto documentoAsociado referencia un documento previo desde otro documento electrónico. Es obligatorio en Notas de Crédito y Notas de Débito (deben apuntar a la FE original que están modificando), y opcional en Facturas Electrónicas (típicamente para anticipos).
Schema
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
tipoDocumento | enum | Sí | ELECTRONICO, IMPRESO o CONSTANCIA_ELECTRONICA |
cdc | string | Sí para ELECTRONICO | CDC de 44 caracteres del documento referenciado |
Sólo ELECTRONICO está soportado actualmente. Los valores IMPRESO y CONSTANCIA_ELECTRONICA están definidos en el enum pero el backend lanza UnsupportedOperationException si se usan. Si necesitás referenciar un documento pre-electrónico (papel timbrado), contactá a soporte.
Reglas
- El CDC debe pertenecer a un documento aprobado por SIFEN (estado
APROBADO). No podés referenciar un documento pendiente o rechazado. - El receptor del documento original y el de la NCE/NDE deben coincidir (mismo RUC, CI, etc.).
- Para NCE: el documento original debe ser una FE (no se permite NCE sobre NCE).
Ejemplo — Referencia electrónica
{
"documentoAsociado": {
"tipoDocumento": "ELECTRONICO",
"cdc": "01800123451001001000000122026042710000000006"
}
}El CDC tiene exactamente 44 caracteres y codifica RUC del emisor, tipo de documento, establecimiento, punto de expedición, número, fecha de emisión y un código de seguridad. Ver el concepto CDC para el desglose completo.
Uso típico — Nota de Crédito
{
"tipoDocumento": "NOTA_DE_CREDITO_ELECTRONICA",
"motivoEmision": "DEVOLUCION",
"documentoAsociado": {
"tipoDocumento": "ELECTRONICO",
"cdc": "01800123451001001000000122026042710000000006"
}
}