post https://api-clientes.meuk8.com.br/api/v1/faturamento/dados-cliente
Faturamento - Cadastro dos Dados de Faturamento do Cliente
Permite que parceiros informem os dados de faturamento mensal de um cliente com quem possuem relacionamento comercial. A informação enviada deve conter 12 registros, um para cada mês anterior ao mês atual. Essa captura é essencial para análises de crédito, acompanhamento financeiro e avaliação do comportamento do cliente ao longo do tempo.
Requisição
| Campo | Tipo | Descrição | Obrigatoriedade |
|---|---|---|---|
| cnpjParceiro | Texto | CNPJ do parceiro informante. | Sim |
| cnpjCedente | Texto | CNPJ do cedente (cliente). | Sim |
| dataInicioRelacionamentoParceiro | Data | Data de início da relação comercial entre parceiro e cliente. | Sim |
| clienteCompromMensalParceiro | Decimal | Comprometimento mensal do cliente com o parceiro (em reais). | Sim |
| clienteEndividamentoTotalParceiro | Decimal | Endividamento total do cliente junto ao parceiro (em reais). | Sim |
| fatClienteInformadoParceiro | Array de Objetos | Lista com os 12 últimos meses de faturamento do cliente. Cada item representa um mês. | Sim |
| fatClienteInformadoParceiro.mesFaturamento | Texto (YYYY-MM) | Mês de referência do faturamento. | Sim |
| fatClienteInformadoParceiro.faturamento | Decimal | Valor de faturamento informado para o mês. | Sim |
Resposta - Sucesso (200)
| Campo | Tipo | Descrição |
|---|---|---|
| message | Texto | Mensagem de confirmação do cadastro |
| data.message | Texto | Mensagem adicional sobre o sucesso da operação |
| statusCode | Inteiro | Código HTTP da resposta |
| status | Booleano | Status lógico da operação |
Resposta - Erro de Validação (422)
| Campo | Tipo | Descrição |
|---|---|---|
| message.httpCode | Inteiro | Código HTTP |
| message.errorCode | Texto | Código interno do erro |
| message.message | Texto | Mensagem de erro |
| data.meses_faltando | Objeto | Lista de meses obrigatórios que não foram enviados. Ex: { '2024-03': 'Mês ausente no envio.' } |
| data.meses_invalidos | Objeto | Lista de meses fora do período permitido. Ex: { '2025-01': 'Mês inválido (fora do período permitido).' } |
| status | Booleano | Status lógico da operação |
| statusCode | Inteiro | Código HTTP da resposta |