A referência (ref) é o identificador que você envia para marcar uma emissão na API Focus NFe. Ela precisa ser única dentro do escopo do token (cada empresa/token tem o seu próprio conjunto de referências).
Formato e uso
- Pode ser alfanumérica.
- Não use caracteres especiais (acentos, espaços,
@,/, etc.); fique em letras e números, conforme a validação da API. - É comum usar o ID interno do seu sistema — por exemplo, a chave da tabela onde a nota é armazenada antes da autorização.
Reutilização
- Se a autorização falhar (nota rejeitada ou erro antes de autorizar), em geral você pode reenviar usando a mesma referência após corrigir o payload.
- Depois que a nota for autorizada (mesmo que depois seja cancelada), aquela referência não pode ser usada de novo para uma nova emissão: ela fica vinculada àquele documento.