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 una Nota de Crédito o de Débito, que debe apuntar a la FE original que modifica. Las Facturas Electrónicas usan la lista documentosAsociados, también para un solo documento.

Schema

Campo	Tipo	Requerido	Descripción
`tipoDocumento`	`enum`	Sí	`ELECTRONICO`, `IMPRESO` o `CONSTANCIA_ELECTRONICA`
`rucFusionado`	`string`	No	En NCE/NDE, RUC fusionado del emisor del documento asociado, sin DV ni guion; ver reglas abajo
`cdc`	`string`	Sí para `ELECTRONICO`	CDC de 44 caracteres del documento referenciado

Tipos admitidos según el documento

Documento	Campo de asociación	Tipos admitidos
NCE y NDE	`documentoAsociado`	`ELECTRONICO`; otro valor recibe `400 validation-error`
FE	`documentosAsociados`	`ELECTRONICO` o `IMPRESO`, notas de remisión y facturas de anticipo. `CONSTANCIA_ELECTRONICA` no se admite
NRE	`documentosAsociados`	`ELECTRONICO` o `IMPRESO`, sólo facturas

Las NRE usan una lista con campos específicos. Consultá Documentos asociados de NRE.

Reglas

El CDC debe pertenecer a un documento aprobado por SIFEN (estado APROBADO o APROBADO_OBSERVACION). 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).

RUC fusionado en NCE y NDE

documentoAsociado.rucFusionado admite de 3 a 8 caracteres: empieza con un dígito distinto de cero, continúa con dígitos y puede terminar en A, B, C o D. Debe corresponder al RUC emisor contenido en el CDC asociado, comparándolo con ceros a la izquierda hasta 8 caracteres. No se admite en FE. Por ejemplo, para el CDC del ejemplo siguiente, el RUC base es 80012345.

Ejemplo — Referencia electrónica

{
  "documentoAsociado": {
    "tipoDocumento": "ELECTRONICO",
    "cdc": "01800123451001001000000122026042710000000006"
  }
}

El CDC tiene exactamente 44 dígitos 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"
  }
}