Guia de integração
NFS-e recebidas (destinadas)
A Weesy lê no Ambiente de Dados Nacional (ADN) as NFS-e em que a empresa aparece como tomadora ou intermediária e guarda XML e dados para você listar, consultar e baixar pela `/v1/destinados`.
Exemplo
curl -X POST https://apifiscal.weesy.com.br/v1/destinados/sincronizacao \
-H "Authorization: Bearer <TOKEN>" \
-H "Content-Type: application/json" \
-d '{"cnpjEmitente":"21664333000195","modelo":"nfse"}'
HTTP/1.1 202 Accepted
{"previstaPara":"2026-11-05T15:05:00Z"}Pré-requisito: certificado A1
A leitura no ADN é feita com o certificado digital A1 da própria empresa, enviado à Weesy. Sem certificado A1, ou com ele vencido, a busca não acontece e GET /v1/destinados/sincronizacao mostra certificado = ausente ou vencido. Certificado A3 não é atendido.
Ligar a busca
Chame PUT /v1/destinados/sincronizacao/nfse?cnpjEmitente=... uma vez. A primeira leitura começa na próxima execução da rotina (a cada 5 minutos) e traz o histórico que o ADN guardar; pode levar algumas horas. Depois disso a busca roda sozinha uma vez por dia.
Listar e baixar
GET /v1/destinados traz as notas no envelope dados + paginacao, mais recentes primeiro (no empate, pela chave). Filtre por de e ate (datas de Brasília), emitente (parte do nome ou do CPF/CNPJ do prestador) e situacao (normal, cancelada, substituida). O XML sai em /v1/destinados/nfse/{chave}/xml e o PDF (DANFSe gerada na hora) em /pdf. Nota cujo XML não abre vem com leitura = falha: baixe o XML; o PDF responde 409 pdf_indisponivel.
Pedir uma busca agora
POST /v1/destinados/sincronizacao com { "cnpjEmitente": "...", "modelo": "nfse" } responde 202 com previstaPara, uma estimativa da próxima execução. Limite: um pedido aceito por empresa por hora; antes disso, 429 limite_excedido com Retry-After em segundos.
Quem acessa
O integrador informa cnpjEmitente (empresas do parceiro). Com o token de API da empresa (wee_...), só o próprio CNPJ: sem cnpjEmitente vale o do token, e outro CNPJ responde 404.
Acompanhar
GET /v1/destinados/sincronizacao mostra se a busca está ligada, a última execução, falhasSeguidas (buscas seguidas sem avanço) e a validade do certificado em certificadoValidoAte. Por enquanto o único modelo é nfse; outro valor responde 400 valor_invalido.
Observação: Só NFS-e do padrão nacional. NF-e recebida ainda não está na /v1/destinados.