Weesy API Fiscal — CT‑e (1.0.0)

O CT-e (Conhecimento de Transporte Eletrônico, modelo 57) é o documento fiscal que a transportadora emite para cada frete. Com esta API você manda os dados do frete e a Weesy gera o XML, assina com o certificado digital da empresa e envia para a SEFAZ.

Como funciona, em quatro passos

1. Você envia o CT-e em POST /cte. A resposta (201) só confirma que recebemos — o CT-e ainda não está autorizado.
2. A Weesy envia para a SEFAZ. Normalmente a resposta sai em poucos segundos.
3. O resultado chega pelo webhook (cte.autorizado, cte.rejeitado...) ou consultando GET /cte/{id}.
4. Com o CT-e autorizado, baixe o XML em GET /cte/{id}/xml.

Bom saber

• Hoje a Weesy emite CT-e normal, modal rodoviário, versão 4.00 do leiaute.
• O CT-e é sempre de uma empresa (o CNPJ da transportadora, cnpjEmitente). A empresa precisa estar cadastrada na Weesy com certificado digital A1.
• CT-e de outra empresa responde 404, como se não existisse.
• Os valores de status podem ganhar itens novos no futuro: trate valor desconhecido sem quebrar.
• Convenções (nomes, datas, dinheiro, erros) são as mesmas da NFS-e — veja comum.yaml.