Atualizar o filtro de parte interessada do webhook de CT-e
PUT/v2/companies/:companyId/inbound/transportationinvoices/webhook/filter
Restringe a entrega de webhook aos CT-e em que o CNPJ da empresa aparece em um dos papéis informados. A empresa precisa ter configuração de inbound ativa.
Envie array vazio para remover o filtro e voltar a receber todos os
documentos capturados (comportamento histórico). O campo é obrigatório:
ausente ou null é rejeitado com 400, para não confundir "limpar o
filtro" com "não informado".
Documentos suprimidos pelo filtro não são cobrados como captura efetiva. A atualização do filtro em si não é bilhetada.
Fail-open: o filtro nunca é causa de perda de documento por dado ausente. O documento é entregue quando não há filtro, ou quando o CT-e não trouxe nenhum dos cinco atores (os grupos são opcionais no schema). Quando algum ator veio mas não o do papel filtrado, o documento é suprimido.
Atenção a Sender: um CT-e que passa um filtro ["Sender"] é, por
definição, documento emitido pela própria empresa, e vai para o tópico de
webhook outbound_successfully — que precisa estar registrado, senão o
filtro não entrega nada.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 500
Sucesso na requisição; devolve a configuração resultante
Algum parametro informado não é válido, ou a empresa não tem configuração ativa
Não autorizado, verificar o cabeçalho do HTTP Authorization
Accesso proibido
Não encontrado
Erro no processamento