Dúvida

O que é o envio assíncrono e síncrono?

Particularidade

O envio assíncrono ou síncrono e definido pela prefeitura não pelo add-on.

O que é?

Síncrono e assíncrono são duas formas de comunicação utilizadas por WebService das prefeituras. 

Envio Síncrono.

No envio síncrono, a comunicação acontece em tempo real. Pense nisso como uma conversa presencial ou uma ligação telefônica: você fala e espera pela resposta do outro lado antes de seguir adiante.

Na prática, quando seu sistema envia um XML, ele aguarda imediatamente o retorno. Assim que o documento é enviado, você já tem o veredito: a operação foi autorizada ou rejeitada, sem precisar esperar ou consultar depois. É a garantia de um feedback instantâneo.

Envio Assíncrono.

No envio assíncrono, a comunicação não exige uma resposta imediata. Imagine que é como enviar um e-mail: você manda a informação e aguarda um retorno posterior, sem travar sua caixa de saída.

Nesse modo, o sistema envia o XML para a prefeitura, que retorna um código interno (como um número de lote ou protocolo). Esse código serve como um "recibo" de que a informação foi recebida a prefeitura. A partir daí, o add-on passa a consultar periodicamente a prefeitura usando esse código, verificando o status do documento até que ele seja autorizado ou rejeitado.

É por essa dinâmica de consulta posterior que o envio assíncrono pode levar um pouco mais de tempo para que a autorização seja finalizada, já que o processamento não ocorre no mesmo instante do envio.