Disponibilizamos só os campos que a Benup usou no envio original — não o arquivo de
retorno inteiro.
Reconheci 4 das 5 colunas comparando com o que foi enviado. mensagem_erro
ainda não tem vínculo.
Se tiver um exemplo de retorno com pendência real, subir agora ajuda a classificar
esse tipo de coluna.
Ver observações da leitura
status tem só dois valores no exemplo (ATIVO, ERRO) — tratei
como indicador de sucesso/erro.
mensagem_erro só aparece preenchida nas linhas com status ERRO
— parece um texto livre do fornecedor, não um código fixo.
Como identificar a pessoa
Campos-chave que a Benup usa pra conciliar o retorno com o contrato de trabalho
(employment-contract) de quem foi enviado.
CPF
Matrícula
CNPJ da empresa
Como identificar a linha original
Pra conciliar cada linha do retorno com a linha que a Benup enviou.
Mapeamento de campos
O retorno reaproveita colunas do arquivo original (CPF, matrícula) — a Benup casa
as linhas por esses valores.
Indicador de linha no arquivo original
O retorno traz um número ou texto apontando a linha original — a Benup usa isso
(direto ou via resolver) pra achar a linha.
Base inteira: a Zurich manda quem está ativo hoje no benefício. Não precisa bater 1 a 1
com o que a Benup enviou — basta saber identificar cada pessoa.
Reconheci as 6 colunas. Como é base inteira, só preciso saber
quais colunas identificam a pessoa — o resto é dado do benefício.
Não existe indicador de sucesso ou erro aqui: quem está na base tem o benefício, quem
não está não tem.
Ver observações da leitura
O arquivo tem 4.812 linhas — bem mais do que as 340
movimentações do último envio. Coerente com base inteira.
numero_carteirinha só aparece nessa base — é dado novo, que a
Benup pode escrever de volta no contrato de trabalho.
Como identificar a pessoa
É a única decisão obrigatória do retorno de base inteira. CPF sozinho já resolve na
maioria dos casos — marque mais campos só se a base tiver CPF repetido.
Matrícula
Coluna matricula · desambigua quem tem mais de
um contrato na mesma empresa.
CNPJ da empresa
Coluna cnpj · só necessário se a base juntar
várias empresas do mesmo benefício.
Numa base inteira, estar no arquivo é a resposta
Regra automática, não configurável: tentei GRANT e a pessoa está na
base → Concedido. Tentei REVOKE e a pessoa não está
mais na base → Revogado. Qualquer outra combinação →
Falhou e vira pendência. Por isso não há coluna de erro pra
classificar aqui.
Classificar campo do retorno
Coluna mensagem_erro · exemplo lido:
CPF_INVALIDO_FORMATO
Escolha o caminho. Dá para voltar e trocar enquanto a classificação não for
confirmada.
6 campos
Identificações do contrato de trabalhoProduto do benefícioTítulo e descrição de pendência
CPF String
CPF do titular, usado para conciliar o retorno com o contrato de trabalho.
Tipo de dado
String
Exemplo de valor
45678912300
Obrigatório
Sim
Fonte
employmentContract
Como será utilizado
Valor puroUsar o valor do campo como está no retorno.
Valor com regra
Aplicar transformação antes de usar — traduzir código, extrair parte do valor...
Exemplo de uso
{{ contract.document }}
Como usar este campo
BentoBeta
Sobre CPF: o que você gostaria de fazer com esse campo? Pode
perguntar sobre formatos, exemplos, transformações ou regras de negócio.
Matrícula String
Matrícula do colaborador no contrato de trabalho.
Tipo de dado
String
Exemplo de valor
4521
Obrigatório
Não
Fonte
employmentContract
Como será utilizado
Valor puroUsar o valor do campo como está no retorno.
Valor com regra
Aplicar transformação antes de usar — traduzir código, extrair parte do valor...
Exemplo de uso
{{ contract.registrationNumber }}
Como usar este campo
BentoBeta
Sobre Matrícula: o que você gostaria de fazer com esse campo? Pode
perguntar sobre formatos, exemplos, transformações ou regras de negócio.
Número da carteirinha String
Número emitido pela Zurich após a ativação — escrito de volta na folha.
Tipo de dado
String
Exemplo de valor
998877665
Obrigatório
Não
Fonte
retorno · Zurich Seguros
Como será utilizado
Valor puroUsar o valor do campo como está no retorno.
Valor com regra
Aplicar transformação antes de usar — traduzir código, extrair parte do valor...
Exemplo de uso
{{ product.cardNumber }}
Como usar este campo
BentoBeta
Sobre Número da carteirinha: o que você gostaria de fazer com esse campo? Pode
perguntar sobre formatos, exemplos, transformações ou regras de negócio.
Código do plano String
Código do plano que foi ativado para o colaborador.
Tipo de dado
String
Exemplo de valor
PLN-04
Obrigatório
Não
Fonte
retorno · Zurich Seguros
Como será utilizado
Valor puroUsar o valor do campo como está no retorno.
Valor com regra
Aplicar transformação antes de usar — traduzir código, extrair parte do valor...
Exemplo de uso
{{ product.planCode }}
Como usar este campo
BentoBeta
Sobre Código do plano: o que você gostaria de fazer com esse campo? Pode
perguntar sobre formatos, exemplos, transformações ou regras de negócio.
Título da pendência String
Resumo curto do que deu errado — aparece na lista de pendências.
Tipo de dado
String
Exemplo de valor
CPF_INVALIDO_FORMATO
Obrigatório
Não
Fonte
retorno · Zurich Seguros
Como será utilizado
Valor puroUsar o valor do campo como está no retorno.
Valor com regra
Aplicar transformação antes de usar — traduzir código, extrair parte do valor...
Exemplo de uso
{{ issue.title }}
Como usar este campo
BentoBeta
Sobre Título da pendência: o que você gostaria de fazer com esse campo?
Pode perguntar sobre formatos, exemplos, transformações ou regras de negócio.
Esse código vem cru do fornecedor. Quero um título curto que o time de operação entenda.
Perfeito! Vou traduzir o código do fornecedor pra um título legível antes de usar.
Regra aplicadaTransformação: de-para de código de erro → títuloCPF_INVALIDO_FORMATO CPF inválido
Descrição da pendência String
Explicação detalhada, pro time de operação entender sem abrir o arquivo.
Tipo de dado
String
Exemplo de valor
CPF_INVALIDO_FORMATO
Obrigatório
Não
Fonte
retorno · Zurich Seguros
Como será utilizado
Valor puroUsar o valor do campo como está no retorno.
Valor com regra
Aplicar transformação antes de usar — traduzir código, extrair parte do valor...
Exemplo de uso
{{ issue.description }}
Como usar este campo
BentoBeta
Sobre Descrição da pendência: o que você gostaria de fazer com esse campo? Pode
perguntar sobre formatos, exemplos, transformações ou regras de negócio.
Preview
O que a Benup vai gravar como issue — o objeto
de pendência (return.jsonissue).
Código cruCPF_INVALIDO_FORMATOtítuloCPF inválido
Código cruCPF_INVALIDO_FORMATOdescriçãoO CPF não passou na validação
Esse resolver passa a existir na plataforma e pode ser reaproveitado em outras
integrações que tenham o mesmo tipo de erro.
Me descreva o que é essa pendência
Combine os códigos de erro que o fornecedor manda e conte o que cada um
significa.
Achei CPF_INVALIDO_FORMATO nessa coluna. Isso é
um código de erro da Zurich?
É, eles mandam uns 15 códigos assim. Esse é quando o CPF não bate no CPF da
Receita.
Entendi. Montei o de-para ao lado com título e descrição pra esse código.
Confere se ficou claro pro time de operação?
Resolver criado
Pendência: CPF inválido
Baseado em: código de erro CPF_INVALIDO_FORMATO
Pendência: CPF inválido IssueNovo
Resolver criado a partir do código de erro cru do fornecedor.