Skip to main content
POST
Enviar XML

Visão Geral

Este endpoint permite enviar arquivos XML de Notas Fiscais Eletrônicas para armazenamento seguro no sistema GuardaNFe, garantindo a preservação e organização dos documentos fiscais.

Headers

string
required
Token de autenticação da API
string
required
Deve ser application/json

Parâmetros do Body

string
required
Conteúdo completo do arquivo XML da NFeFormato: String contendo o XML válido da NFe
string
required
Chave de acesso da NFe (44 caracteres)Exemplo: 35170608530528000184550000000154301000771561
object
Metadados adicionais para organizaçãoPropriedades opcionais:
  • origem: Origem do arquivo (ex: “email”, “upload”, “sistema”)
  • tags: Array de tags para categorização
  • observacoes: Observações adicionais

Exemplos de Requisição

Exemplo de Resposta

201 - Criado
400 - Erro de Validação
409 - NFe já existe

Códigos de Resposta

Created
NFe armazenada com sucesso
Bad Request
XML inválido, malformado ou chave NFe incorreta
Unauthorized
Token de autenticação ausente ou inválido
Forbidden
Serviço GuardaNFe não ativado para sua conta
Conflict
NFe já existe no sistema
Payload Too Large
Arquivo XML muito grande (limite: 5MB)
Too Many Requests
Limite de requisições excedido
Internal Server Error
Erro interno do servidor

Validações Realizadas

  • Estrutura XML: Verifica se o XML está bem formado
  • Schema NFe: Valida contra o schema oficial da NFe
  • Chave de Acesso: Confirma que a chave no XML corresponde ao parâmetro
  • Integridade: Verifica assinatura digital se presente
  • Formato: 44 caracteres numéricos
  • Dígito Verificador: Validação matemática da chave
  • Consistência: Chave deve existir no conteúdo do XML
  • Tamanho máximo: 5MB por arquivo XML
  • Rate limiting: 10 uploads por minuto
  • Formatos aceitos: Apenas XML válido de NFe
  • Duplicatas: Não permite NFe já armazenada

Casos de Uso

Upload Manual

Processamento em Lote

Próximos Passos

Verificar NFe

Confirme se a NFe foi armazenada corretamente

Visualizar NFe

Acesse os dados da NFe armazenada

Gerar Arquivo

Exporte suas NFe para download

Autenticação

Configure sua API key corretamente
Serviço Não Ativado?Se você receber erro 403, entre em contato com suporte@validanfe.com para ativar o GuardaNFe em sua conta.
Dica de PerformancePara uploads frequentes, considere implementar upload assíncrono e monitoramento via webhooks para melhor experiência do usuário.