Weesy Docs

Configurar webhooks

Configurar o webhook da empresa

PUT https://apifiscal.weesy.com.br/v1/empresas/{cnpj}/webhook

Abrir na referência interativa

Define o endereço (URL) que vai receber os avisos da empresa — nota autorizada, rejeitada, cancelada — e quais avisos você quer receber. A URL precisa ser https.

Parâmetros

NomeOndeTipoDescrição
cnpj
obrigatório
caminhostring

Exemplo de chamada

cURL

curl --request PUT \
  --url "https://apifiscal.weesy.com.br/v1/empresas/21664333000195/webhook" \
  --header "Authorization: Bearer $WEESY_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
  "url": "https://meusistema.com.br/weesy/avisos",
  "eventos": [
    "nfse.autorizada",
    "nfse.rejeitada",
    "nfse.cancelada"
  ],
  "ativo": true
}'

Node.js

const resposta = await fetch("https://apifiscal.weesy.com.br/v1/empresas/21664333000195/webhook", {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${process.env.WEESY_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "url": "https://meusistema.com.br/weesy/avisos",
    "eventos": [
      "nfse.autorizada",
      "nfse.rejeitada",
      "nfse.cancelada"
    ],
    "ativo": true
  }),
});
console.log(resposta.status, await resposta.text());

Python

import os

import requests

resposta = requests.put(
    "https://apifiscal.weesy.com.br/v1/empresas/21664333000195/webhook",
    headers={"Authorization": f"Bearer {os.environ['WEESY_TOKEN']}"},
    json={
        "url": "https://meusistema.com.br/weesy/avisos",
        "eventos": [
            "nfse.autorizada",
            "nfse.rejeitada",
            "nfse.cancelada",
        ],
        "ativo": True,
    },
    timeout=30,
)
print(resposta.status_code, resposta.text)

PHP

<?php

$corpo = <<<'JSON'
{
  "url": "https://meusistema.com.br/weesy/avisos",
  "eventos": [
    "nfse.autorizada",
    "nfse.rejeitada",
    "nfse.cancelada"
  ],
  "ativo": true
}
JSON;

$contexto = stream_context_create(["http" => [
    "method" => "PUT",
    "header" => implode("\r\n", ["Authorization: Bearer " . getenv("WEESY_TOKEN"), "Content-Type: application/json"]),
    "content" => $corpo,
    "ignore_errors" => true, // lê o corpo também nas respostas de erro
]]);
$resposta = file_get_contents("https://apifiscal.weesy.com.br/v1/empresas/21664333000195/webhook", false, $contexto);
echo $http_response_header[0], PHP_EOL, $resposta, PHP_EOL;

C#

using System.Net.Http.Headers;
using System.Text;

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("WEESY_TOKEN"));

var corpo = """
    {
      "url": "https://meusistema.com.br/weesy/avisos",
      "eventos": [
        "nfse.autorizada",
        "nfse.rejeitada",
        "nfse.cancelada"
      ],
      "ativo": true
    }
    """;

using var resposta = await http.PutAsync(
    "https://apifiscal.weesy.com.br/v1/empresas/21664333000195/webhook",
    new StringContent(corpo, Encoding.UTF8, "application/json"));
Console.WriteLine($"{(int)resposta.StatusCode} {await resposta.Content.ReadAsStringAsync()}");

Corpo da requisição

CampoTipoDescrição
url
obrigatório
string (uri)

O endereço do seu sistema que vai receber os avisos. Precisa ser https, na porta padrão (443), com nome de domínio (não aceitamos IP nem endereço de rede interna).

eventos
obrigatório
array de string

Quais avisos você quer receber. Vazio = todos.

ativo
obrigatório
boolean

Indica se esta configuração está habilitada para entrega.

Exemplo

JSON
{
  "url": "https://meusistema.com.br/weesy/avisos",
  "eventos": [
    "nfse.autorizada",
    "nfse.rejeitada",
    "nfse.cancelada"
  ],
  "ativo": true
}

Respostas

Campos da resposta 200

CampoTipoDescrição
url
obrigatório
string (uri)

O endereço do seu sistema que vai receber os avisos. Precisa ser https, na porta padrão (443), com nome de domínio (não aceitamos IP nem endereço de rede interna).

eventos
obrigatório
array de string

Quais avisos você quer receber. Vazio = todos.

ativo
obrigatório
boolean

Indica se esta configuração está habilitada para entrega.

← Voltar ao início