As notificações desempenham um papel fundamental na experiência do usuário com a REST API de Documentos Fiscais Eletrônicos e de Consulta de Notas da Webmania, proporcionando atualizações instantâneas e precisas sobre todos os status das notas fiscais, para que a sua plataforma se mantenha sempre atualizada. Dentre essas informações vitais, destaca-se um parâmetro essencial que compõe as notificações: o UUID.
Então venha conosco nesse artigo entender de maneira rápida e simples um pouco mais sobre esse parâmetro e como encontrá-lo no painel Webmania!
O que é:
O UUID (do inglês Universally Unique Identifier) é um número de 128 bits utilizado para identificar informações em sistemas de computação. Sua singularidade, obtida por métodos padronizados, independe de autoridades centrais, tornando-o amplamente adotado, com probabilidade de duplicação sendo praticamente nula, permitindo que qualquer usuário o gere com confiança. Essa característica descentralizada e a ampla aceitação em várias plataformas fazem do UUID um recurso essencial na emissão de notas fiscais, garantindo identificação única e confiável dos documentos.
No contexto da API Webmania®, UUID é o número único de identificação da Nota Fiscal, ou seja, cada Nota Fiscal possui esse número que deve ser utilizado para recepcionar e identificar a Nota Fiscal para atualizar as informações no seu banco de dados. (Lembrando que esse número é diferente da chave de acesso da nota fiscal; esta pode sofrer alterações quando emitida em ambiente de contingência).
No momento de emissão da Nota Fiscal via API Webmania®, caso tenha informado o parâmetro “url_notificacao”, será enviado o retorno no formato POST para a URL especificada no parâmetro, contendo, no corpo, o parâmetro “uuid”. Já para recepcionar o retorno da notificação, deve ser utilizado a UUID, e é por isso que ela é tão importante.
Como encontrar:
No painel Webmania, o usuário consegue acessar a informação de UUID da nota entrando nos logs dela:
Vale ressaltar que a UUID apenas irá aparecer no log de URL de notificação se, no momento da emissão, o usuário tiver informado o parâmetro “url_notificacao”. Para o caso abaixo, não foi informado o referido parâmetro, então no log da nota aparece apenas o JSON de envio (sem a informação de UUID):
Nesse caso, para encontrar o UUID, você pode verificar a URL do PDF da nota ou do XML dela:
Em caso de problemas ou dúvidas, nosso suporte estará disponível nos canais de atendimento.
