Skip to main content

Como ler a régua de cobrança usando a API?

Para ler a régua de cobrança da sua empresa, faça uma chamada GET para o endpoint /api/v1/notification, autenticando com o seu AppID no header Authorization.

Você pode acessar aqui a documentação de referência desse endpoint.

Requisitos​

  • A aplicação precisa ter o escopo NOTIFICATION_GET.
  • Um parceiro lê a régua de cada afiliada com o AppID daquela afiliada.

Requisição​

curl https://api.woovi.com/api/v1/notification \
-H "Authorization: <AppID>"

Resposta​

A resposta traz um item por aviso, com a configuração atual de cada um. O significado de cada campo está em O que é a régua de cobrança?.

{
"notifications": [
{
"notificationType": "NOTIFY_CUSTOMER_ON_CHARGE_CREATED",
"active": true,
"channels": ["WHATSAPP", "EMAIL"],
"attachments": ["CHARGE_PDF"]
},
{
"notificationType": "NOTIFY_CUSTOMER_BEFORE_CHARGE_DUE_DATE",
"active": true,
"channels": ["WHATSAPP"],
"offsets": [
{ "value": 5, "unit": "DAY" },
{ "value": 1, "unit": "DAY" }
]
},
{
"notificationType": "NOTIFY_CUSTOMER_ON_CHARGE_DUE_DATE",
"active": true,
"channels": ["WHATSAPP"],
"offsets": [{ "value": 3, "unit": "HOUR" }]
},
{
"notificationType": "NOTIFY_CUSTOMER_AFTER_CHARGE_DUE_DATE",
"active": false,
"channels": ["WHATSAPP"],
"offsets": [{ "value": 1, "unit": "DAY" }]
},
{
"notificationType": "NOTIFY_CUSTOMER_ON_CHARGE_PAID",
"active": true,
"channels": ["WHATSAPP"]
},
{
"notificationType": "NOTIFY_CUSTOMER_ON_INSTALLMENT_CHARGE_CREATED",
"active": true,
"channels": ["EMAIL"]
},
{
"notificationType": "NOTIFY_CUSTOMER_ON_INSTALLMENT_EXPIRED",
"active": true,
"channels": ["EMAIL"]
}
]
}
  • offsets aparece só nos três avisos de vencimento.
  • attachments aparece só na cobrança criada e na parcela criada, e só depois que a sua empresa escolheu os anexos.

Erros​

StatusQuando
401AppID inválido.
403A aplicação não tem o escopo NOTIFICATION_GET.