Recorrência de NFS-e
Emitir agora
POST https://apifiscal.weesy.com.br/v1/recorrencias/{id}/ocorrencias/{numero}/emitir-agora
Abrir na referência interativaPara uma ocorrência programada, falhou ou perdida (recorrência ativa ou concluida). A nota sai em até 5 minutos, com o modelo e o valor atuais, competencia = hoje e idIntegracao = rec-{id}-{numero}-m{k} (k = 1, 2...). As variáveis da discriminação continuam pela data prevista. Se uma tentativa anterior chegou a criar a nota, a ocorrência fica com ela — nunca sai uma segunda.
Com a recorrência pausada: 409 recorrencia_pausada (retome antes).
Parâmetros
| Nome | Onde | Tipo | Descrição |
|---|---|---|---|
| id obrigatório | caminho | string | |
| numero obrigatório | caminho | integer |
Exemplo de chamada
cURL
curl --request POST \
--url "https://apifiscal.weesy.com.br/v1/recorrencias/6ade6278e8340a492a46b564/ocorrencias/<numero>/emitir-agora" \
--header "Authorization: Bearer $WEESY_TOKEN"Node.js
const resposta = await fetch("https://apifiscal.weesy.com.br/v1/recorrencias/6ade6278e8340a492a46b564/ocorrencias/<numero>/emitir-agora", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.WEESY_TOKEN}`,
},
});
console.log(resposta.status, await resposta.text());Python
import os
import requests
resposta = requests.post(
"https://apifiscal.weesy.com.br/v1/recorrencias/6ade6278e8340a492a46b564/ocorrencias/<numero>/emitir-agora",
headers={"Authorization": f"Bearer {os.environ['WEESY_TOKEN']}"},
timeout=30,
)
print(resposta.status_code, resposta.text)PHP
<?php
$contexto = stream_context_create(["http" => [
"method" => "POST",
"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/recorrencias/6ade6278e8340a492a46b564/ocorrencias/<numero>/emitir-agora", 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.PostAsync(
"https://apifiscal.weesy.com.br/v1/recorrencias/6ade6278e8340a492a46b564/ocorrencias/<numero>/emitir-agora",
null);
Console.WriteLine($"{(int)resposta.StatusCode} {await resposta.Content.ReadAsStringAsync()}");Respostas
- 202: Marcada. mensagem = "A nota sai em alguns minutos."
- 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)
- 409: A ação não vale na situação atual. O code diz o motivo: - recorrenciasituacaoinvalida — a recorrência está cancelada, concluída ou na situação errada para a ação; - recorrenciapausada — Emitir agora com a recorrência pausada (retome antes); - ocorrenciasituacaoinvalida — a ocorrência não está numa situação que aceita a ação; - prazoencerrado — o pulo só pode ser desfeito até 07:59 do dia da data prevista; - ocorrenciadataemconflito — outra ocorrência programada ocupa a data. (formato de erro)
Campos da resposta 202
| Campo | Tipo | Descrição | |||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| numero obrigatório | integer | ||||||||||||||||||||||||||||||||||||||||||||||
| dataPrevista obrigatório | string (date) | O dia (Brasília) em que a nota sai, às 08:00; vira a | |||||||||||||||||||||||||||||||||||||||||||||
| valor obrigatório | number | Valor em reais, como número com 2 casas decimais (ex. | |||||||||||||||||||||||||||||||||||||||||||||
| valorEditado obrigatório | boolean | O valor foi mudado à mão e não acompanha o valor do modelo. | |||||||||||||||||||||||||||||||||||||||||||||
| situacao obrigatório | string |
Valores: | |||||||||||||||||||||||||||||||||||||||||||||
| emitirAgora obrigatório | boolean | Marcada por Emitir agora; sai na próxima execução (até 5 min). | |||||||||||||||||||||||||||||||||||||||||||||
| idIntegracao | string ou null | O da nota desta ocorrência: | |||||||||||||||||||||||||||||||||||||||||||||
| avisadaEm | string (date-time) ou null | Quando entrou no aviso da véspera (só empresas do ERP Weesy). | |||||||||||||||||||||||||||||||||||||||||||||
| motivoImpedimento | object ou null | O que impediria a emissão, visto na véspera. | |||||||||||||||||||||||||||||||||||||||||||||
| motivoImpedimento. | string | ||||||||||||||||||||||||||||||||||||||||||||||
| motivoImpedimento. | string | ||||||||||||||||||||||||||||||||||||||||||||||
| nota | object ou null | A nota emitida, lida na hora. | |||||||||||||||||||||||||||||||||||||||||||||
| nota. | string | O | |||||||||||||||||||||||||||||||||||||||||||||
| nota. | string ou null | Número da NFS-e; nulo até autorizar. | |||||||||||||||||||||||||||||||||||||||||||||
| nota. | string | Em que pé está a nota. Novos valores podem aparecer: trate valor desconhecido sem quebrar.
| |||||||||||||||||||||||||||||||||||||||||||||
| falha | object ou null | Por que não saiu. | |||||||||||||||||||||||||||||||||||||||||||||
| falha. | string | ||||||||||||||||||||||||||||||||||||||||||||||
| falha. | string | ||||||||||||||||||||||||||||||||||||||||||||||
| falha. | string (date-time) | ||||||||||||||||||||||||||||||||||||||||||||||
| avisoVespera | string | Só na resposta de Editar data ou valor. Valores: | |||||||||||||||||||||||||||||||||||||||||||||
| mensagem | string | Só na resposta de Emitir agora. |