CUFE y CUDE

El CUFE (Código Único de Factura Electrónica) y el CUDE (Código Único de Documento Electrónico) son el identificador de cada documento electrónico ante la DIAN. Es una huella (SHA-384) calculada con los datos del documento, así que cualquier cambio en el documento cambia el código.

Código	En qué documentos
CUFE	Facturas de venta.
CUDE	Notas crédito y notas débito, y la transcripción de una factura de papel.

En la API los dos se ven en el campo cufe del documento.

De dónde sale

foliios lo calcula por ti al firmar el documento, según la fórmula del anexo técnico: los datos del documento, el NIT del emisor, el ambiente y una clave que depende del tipo (la clave técnica de la resolución en las facturas; el PIN del software en las notas y en la transcripción). No tienes que calcularlo ni enviarlo. El sandbox lo recalcula y rechaza el documento si no coincide (regla FAD06).

Cuándo aparece

En la respuesta de la emisión, el documento nace pending y cufe es null: todavía no se firmó.
Cuando el documento ya se firmó (sending, accepted, rejected…), cufe trae el código y links.xml el XML firmado.
Un documento que falla antes de firmarse por primera vez no tiene CUFE.
El código no cambia en los reintentos del mismo día: el mismo documento firmado el mismo día tiene el mismo código. Si el día cambia antes de transmitirse, el documento se vuelve a firmar con la fecha actual y puede tener otro código.

Para qué lo necesitas

Referenciar una factura desde una nota. correction.billing_reference lleva el number, el cufe y la issue_date de la factura. Tómalos del documento aceptado. Ver notas crédito y débito.
Consultar un documento en la DIAN. En producción, el comprador y tú pueden verificarlo con ese código en el catálogo de la DIAN. En el sandbox no se puede consultar en línea: el documento es simulado.
Conciliar. Guarda el cufe junto a tu venta.

Qué no es

El CUFE no es el id del documento en foliios (un identificador interno) ni su number. Para consultar un documento en la API usa el id.