Notas recebidas
Ligar a busca das NFS-e recebidas
PUT https://apifiscal.weesy.com.br/v1/destinados/sincronizacao/{modelo}
Abrir na referência interativaLiga a busca diária. Pode chamar mais de uma vez: ativadaEm fica o da primeira. A primeira leitura traz o histórico que o ADN guardar e começa na próxima execução da rotina (até 5 minutos). Exige o certificado A1 da empresa enviado à Weesy.
Parâmetros
| Nome | Onde | Tipo | Descrição |
|---|---|---|---|
| modelo obrigatório | caminho | string | O tipo de documento. Por enquanto só Valores: |
| cnpjEmitente | query | string | CNPJ da empresa. Obrigatório para o integrador; com o token de API, o da própria empresa (outro CNPJ responde 404). |
Exemplo de chamada
cURL
curl --request PUT \
--url "https://apifiscal.weesy.com.br/v1/destinados/sincronizacao/<modelo>" \
--header "Authorization: Bearer $WEESY_TOKEN"Node.js
const resposta = await fetch("https://apifiscal.weesy.com.br/v1/destinados/sincronizacao/<modelo>", {
method: "PUT",
headers: {
Authorization: `Bearer ${process.env.WEESY_TOKEN}`,
},
});
console.log(resposta.status, await resposta.text());Python
import os
import requests
resposta = requests.put(
"https://apifiscal.weesy.com.br/v1/destinados/sincronizacao/<modelo>",
headers={"Authorization": f"Bearer {os.environ['WEESY_TOKEN']}"},
timeout=30,
)
print(resposta.status_code, resposta.text)PHP
<?php
$contexto = stream_context_create(["http" => [
"method" => "PUT",
"header" => implode("\r\n", ["Authorization: Bearer " . getenv("WEESY_TOKEN")]),
"ignore_errors" => true, // lê o corpo também nas respostas de erro
]]);
$resposta = file_get_contents("https://apifiscal.weesy.com.br/v1/destinados/sincronizacao/<modelo>", false, $contexto);
echo $http_response_header[0], PHP_EOL, $resposta, PHP_EOL;C#
using System.Net.Http.Headers;
using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("WEESY_TOKEN"));
using var resposta = await http.PutAsync(
"https://apifiscal.weesy.com.br/v1/destinados/sincronizacao/<modelo>",
null);
Console.WriteLine($"{(int)resposta.StatusCode} {await resposta.Content.ReadAsStringAsync()}");Respostas
- 200: A situação da busca, já ligada.
- 400: Algum dado está errado ou faltando. A lista erros diz qual campo e o que corrigir (code = validacao). (formato de erro)
- 401: Token ausente, errado ou revogado (credencialinvalida). Confira o cabeçalho Authorization. (formato de erro)
- 404: Não encontrado. Pode ser que não exista ou que pertença a outra empresa — por segurança, os dois casos respondem igual. (formato de erro)
- 500: Erro do nosso lado (errointerno). Tente de novo; se continuar, mande o traceId para o suporte. (formato de erro)
Campos da resposta 200
| Campo | Tipo | Descrição |
|---|---|---|
| modelo obrigatório | string | Valores: |
| ativo obrigatório | boolean | |
| ativadaEm | string (date-time) ou null | |
| primeiraLeituraFeita obrigatório | boolean | Já houve uma busca que deu certo. |
| pendente obrigatório | boolean | Ainda há histórico a ler; continua na próxima execução. |
| solicitadaEm | string (date-time) ou null | Pedido de busca à espera da próxima execução. |
| ultimaExecucao | object ou null | |
| ultimaExecucao. | string (date-time) | Data e hora em UTC, terminada em |
| ultimaExecucao. | string (date-time) | Data e hora em UTC, terminada em |
| ultimaExecucao. | string | Valores: |
| ultimaExecucao. | string ou null | |
| ultimaExecucao. | integer | |
| falhasSeguidas obrigatório | integer | |
| ultimoSucessoEm | string (date-time) ou null | |
| certificado obrigatório | string | O certificado A1 da empresa no cofre da Weesy, lido na hora. Valores: |
| certificadoValidoAte | string (date-time) | Validade do certificado A1. Ausente quando não há certificado. |