---
title: "Cadastro dos dados de faturamento do cliente"
method: POST
path: "/api/v1/faturamento/dados-cliente"
tags: ["Faturamento"]
---

# Cadastro dos dados de faturamento do cliente

`POST /api/v1/faturamento/dados-cliente`

**Faturamento - Cadastro dos Dados de Faturamento do Cliente**<br/>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.<br/><br/>**Requisição**<br/><table><thead><tr><th>Campo</th><th>Tipo</th><th>Descrição</th><th>Obrigatoriedade</th></tr></thead><tbody><tr><td>cnpjParceiro</td><td>Texto</td><td>CNPJ do parceiro informante.</td><td>Sim</td></tr><tr><td>cnpjCedente</td><td>Texto</td><td>CNPJ do cedente (cliente).</td><td>Sim</td></tr><tr><td>dataInicioRelacionamentoParceiro</td><td>Data</td><td>Data de início da relação comercial entre parceiro e cliente.</td><td>Sim</td></tr><tr><td>clienteCompromMensalParceiro</td><td>Decimal</td><td>Comprometimento mensal do cliente com o parceiro (em reais).</td><td>Sim</td></tr><tr><td>clienteEndividamentoTotalParceiro</td><td>Decimal</td><td>Endividamento total do cliente junto ao parceiro (em reais).</td><td>Sim</td></tr><tr><td>fatClienteInformadoParceiro</td><td>Array de Objetos</td><td>Lista com os 12 últimos meses de faturamento do cliente. Cada item representa um mês.</td><td>Sim</td></tr><tr><td style='padding-left: 30px;'>fatClienteInformadoParceiro.mesFaturamento</td><td>Texto (YYYY-MM)</td><td>Mês de referência do faturamento.</td><td>Sim</td></tr><tr><td style='padding-left: 30px;'>fatClienteInformadoParceiro.faturamento</td><td>Decimal</td><td>Valor de faturamento informado para o mês.</td><td>Sim</td></tr></tbody></table><br/><br/>**Resposta - Sucesso (200)**<br/><table><thead><tr><th>Campo</th><th>Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td>message</td><td>Texto</td><td>Mensagem de confirmação do cadastro</td></tr><tr><td>data.message</td><td>Texto</td><td>Mensagem adicional sobre o sucesso da operação</td></tr><tr><td>statusCode</td><td>Inteiro</td><td>Código HTTP da resposta</td></tr><tr><td>status</td><td>Booleano</td><td>Status lógico da operação</td></tr></tbody></table><br/><br/>**Resposta - Erro de Validação (422)**<br/><table><thead><tr><th>Campo</th><th>Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td>message.httpCode</td><td>Inteiro</td><td>Código HTTP</td></tr><tr><td>message.errorCode</td><td>Texto</td><td>Código interno do erro</td></tr><tr><td>message.message</td><td>Texto</td><td>Mensagem de erro</td></tr><tr><td>data.meses_faltando</td><td>Objeto</td><td>Lista de meses obrigatórios que não foram enviados. Ex: { '2024-03': 'Mês ausente no envio.' }</td></tr><tr><td>data.meses_invalidos</td><td>Objeto</td><td>Lista de meses fora do período permitido. Ex: { '2025-01': 'Mês inválido (fora do período permitido).' }</td></tr><tr><td>status</td><td>Booleano</td><td>Status lógico da operação</td></tr><tr><td>statusCode</td><td>Inteiro</td><td>Código HTTP da resposta</td></tr></tbody></table>

## Headers

- `client-id` string, uuid, required

## Request body

- object
  - `cnpjParceiro` string
  - `cnpjCedente` string
  - `dataInicioRelacionamentoParceiro` string, date
  - `clienteCompromMensalParceiro` number, float
  - `clienteEndividamentoTotalParceiro` number, float
  - `fatClienteInformadoParceiro` object[]
    - `mesFaturamento` string
    - `faturamento` number, float

## Response `200`

Dados recebidos com sucesso.

- object
  - `message` string
  - `data` object
    - `message` string
  - `errors` string
  - `statusCode` integer
  - `status` boolean

## Other responses

- `401` — Invalid client data.
- `403` — Invalid token.
- `422` — Invalid input fields.

---

[API](https://skmtc.net/meuk8/apis/k8-fintech.md) · [All operations](https://skmtc.net/meuk8/apis/k8-fintech/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meuk8/k8-fintech/revisions/14db4977f490/schema)