Pular para o conteúdo principal

Estou recebendo faturas sem invoice_details ou com alguns campos vazios (null)

  • Atualizado
Seguir

Obs: Integração com o SAT só está disponível para empresas em território Mexicano!

Por que a Belvo está devolvendo faturas incompletas?

Nossa capacidade de extrair dados do SAT às vezes pode ser afetada pela confiabilidade e limitações de sua plataforma. Além disso, o SAT tem alguns limites na quantidade de XML que você pode baixar em um determinado dia. Este limite é atualizado às 00:00 (CST). É improvável que você seja afetado por esses limites, a menos que esteja acessando um grande volume de faturas (mais de 2.000 faturas).

No entanto, se o fizer, as faturas recuperadas após atingir o limite definido pelo SAT podem conter informações parciais (alguns dos campos serão null). Isso ocorre porque precisamos do XML de uma fatura para preencher alguns atributos específicos da fatura.

 

Quais dados da fatura posso sempre recuperar através do Belvo?

Nos casos em que não possamos baixar o XML de uma fatura, sempre retornaremos os metadados da fatura (independentemente do limite). Isso inclui:

  • type
  • invoice_type
  • invoice_identification
  • invoice_date
  • sender_id
  • sender_name
  • receiver_id
  • receiver_name
  • certification_date
  • certification_authority
  • currency
  • total_amount
  • status
  • cancelation_status
  • cancelation_update_date

 

Como sempre devolvemos esses dados, você terá o comprovante da referida fatura, que poderá corrigir em solicitações futuras.


Como posso saber se uma fatura foi afetada pelo limite de download estabelecido pelo SAT?

As faturas que são afetadas pelo limite de download imposto pelo SAT podem ser identificadas por meio de um atributo warnings que mostrará um alerta:

{ 
  ... 
  "warnings": { 
    "code": "sat_xml_limit_reached",
    "message": "The daily limit for XML downloads set by SAT was reached so this invoice might be missing data. Please check <https://tinyurl.com/yydzhy5d> for more information on this error." 
  }, 
  ... 
}

Na grande maioria dos casos, quando nenhum erro foi detectado, o atributo warnings mostrará null.

{ 
  ... 
  "warnings": null 
  ... 
}

 

O que acontece se eu tiver uma fatura armazenada no Belvo e, em uma nova solicitação, obtiver a mesma fatura mas com erros?

Se a fatura armazenada na Belvo contiver erros, iremos sobrescrevê-la com a versão correta assim que for feito um novo pedido de inclusão.

Se a fatura armazenada na Belvo não contiver erros e recebermos uma nova versão da mesma fatura que contém erros, não salvaremos esta nova versão. Em vez disso, retornaremos a versão correta que tínhamos em estoque.


Como faço para reparar uma fatura armazenada na Belvo que contém erros?

Se você usar links recorrentes, tentaremos recuperar essa fatura novamente atualizando o link (por padrão, a cada 7 dias).

Se você usar links exclusivos, sugerimos que você se inscreva novamente após 24 horas para recuperar faturas incompletas.

 

 

 

Artigos relacionados