1. Eventos
  • Introdução
    • Integração ONE
    • Visão Geral da API Rest
    • Ciclo de Vida da API
  • Ambiente
    • Ambiente
  • Autenticação
    • Gerando Chaves de Acesso
    • Autenticando-se
    • Token de Acesso
      POST
  • Projetos
    • Entendendo Projetos
    • Criação de Projeto
      POST
  • Medição
    • Entendendo a Medição
    • Criação de Medição
      POST
    • Consulta de Impostos da Empresa
      GET
    • Adição de Retenções Fiscais em uma Medição
      POST
    • Criação de Parcela em Medição
      POST
    • Validação das Parcelas
      POST
    • Validação da Medição
      PATCH
    • Mudança de Status da Medição
      PATCH
  • Contas a Pagar
    • Entendendo o Contas a Pagar
    • Adicinar Comprovante de Pagamento em Parcela
  • Fluxo Financeiro
    • Entendendo o Fluxo Financeiro
  • Webhooks
    • Entendendo o Payload
    • Eventos
      • Utilizando Webhooks
      • Criação de Medição
      • Atualização de Medição
      • Criação e Atualização de Parcela
      • Criação e Atualização de Fluxo Financeiro
  1. Eventos

Criação e Atualização de Parcela

Introdução#

Quando da criaçaõ da medição, cria-se parcelas com status Rascunho. Ao aprovar a medição, as parcelas seguem para inclusão de método de pagamento e programação do pagamento

Metadata do Evento:#

A estrutura do metadata deste evento é padrão e segue a seguinte ordem:
CampoDescrição
idIdentificador do evento
resourceTypeOrigem do evento
companyIdIdentificador da empresa atualizando a medição
stakeholdersCNPJ de empresas que receberão este evento
nameTítulo do evento
userIdIdentificador do usuário criando ou atualizando a parcela
resourceIdIdentificador da parcela
dateTimeHorário da criação ou edição da parcela
metadata.idIdentificador da parcela
metadata.measurementIdIdentificador da medição
metadata.billingTypeInformação do tipo de faturamento
metadata.typeTipo de parcela
metadata.statusStatus da parcela
metadata.dueDateData de vencimento da parcela
metadata.payerTaxIdCPF/CNPJ do responsável pelo pagamento
metadata.amountValor da medição
metadata.supplierTaxIdCNPJ do fornecedor
metadata.billetSwappedInformação se parcela foi antecipada
metadata.identifierNúmero da parcela

Exemplo de Payload#

{
    "id":"c8a44e58-2a27-4d5c-9cab-c0ad1f82a648",
    "companyId":35,
    "stakeholders":["73538818000136"],
    "name":"INSTALLMENT_CREATED_OR_UPDATED",
    "userId":"47",
    "resourceId":"812",
    "dateTime":"2024-04-25 15:20:38",
    "metadata":{
                "id":812,
                "measurementId":559,
                "billingType":"CONSTRUCTOR",
                "type":"COMMITMENT",
                "status":"DRAFT",
                "dueDate":[2024,5,10],
                "amount":1000,
                "payerTaxId":"73538818000136",
                "supplierTaxId":"48860613000125",
                "billetSwapped":false,
                "identifier":"1"
      }
}
   

O que esperamos como retorno#

Ao retorar o http status da família 200 (sucesso) será considerado pelo time ONE que os dados foram inseridos com sucesso na fatura no seu ERP.
Importante frisar que o sucesso deste webhook não se dá pelo recebimento de seus dados, mas sim em sua atualização da informação no sistema ERP.
Consideramos que qualquer retorno diferente da família 200 como falha na integração e tentaremos reenviar os dados novamente por mais 5 (cinco) vezes. Persistindo a falha, haverá um reprocessamento durante a noite, notificando a equipe de suporte ONE para solução do problema.
Modificado em 2024-05-07 15:23:29
Página anterior
Atualização de Medição
Próxima página
Criação e Atualização de Fluxo Financeiro
Built with