# Criação de Carnê

Para criar um carnê, você pode fazer uma requisição POST com objetos JSON para o seguinte URL:

**URL de Solicitação:**

{% code overflow="wrap" %}

```url
https://api.zsystems.com.br/carnes
```

{% endcode %}

Certifique-se de incluir os detalhes necessários no corpo da requisição em formato JSON, como os dados do carnê.

Além disso, é importante incluir os cabeçalhos de requisição necessários para garantir uma comunicação adequada:

* `ContentType`: application/json
* `authorization`: Bearer 'Token API'

<table data-header-hidden><thead><tr><th width="209"></th><th width="114"></th><th></th></tr></thead><tbody><tr><td>Id</td><td>Tipo</td><td>Descrição</td></tr><tr><td>cliente</td><td></td><td><strong>nome:</strong> Nome do cliente<br><strong>cpf =</strong> Cpf do cliente<br><strong>dataNascimento =</strong> data de nascimento do cliente<br><strong>email</strong> =  Email do cliente<br><strong>celular</strong> =  Nº de telefone celular do cliente</td></tr><tr><td>descontos</td><td></td><td><strong>mode</strong>: Tipo de desconto<br><strong>value</strong> = valor do desconto<br><strong>limitDate</strong> = expiração do desconto</td></tr><tr><td>descricao</td><td></td><td>Descrição do carnê</td></tr><tr><td>diaVencimento</td><td></td><td>Data de validade do carnê</td></tr><tr><td>endereco</td><td></td><td><strong>Endereço de cobrança</strong><br><strong>logradouro</strong>: Logradouro<br><strong>numero</strong> = Nº Residencial<br><strong>cep</strong>  = cep do endereço<br><strong>cidade</strong> = cidade<br><strong>estado</strong> = estado<br><strong>complemento</strong> = complemento</td></tr><tr><td>estabelecimentoId</td><td></td><td>Id do estabelecimento</td></tr><tr><td>parcelas</td><td></td><td>parcelas do carnê</td></tr><tr><td>splits</td><td></td><td><strong>estabelecimentoId</strong>: Id do estavelecimento de referencia<br><strong>cpfcnpj</strong>: Documento identificador do indiciduo splitado<br><strong>nome</strong>: Nome do individuo ou estabelecimento<br><strong>email</strong> = email do individuo ou estabelecimento<br><strong>value</strong> = valor do split<br><strong>tipoSplit</strong> = tipo de split<br><strong>chargeProcessingFree</strong> = 0=Bruto / 1=Líquido</td></tr><tr><td>tipoPagamentoId</td><td></td><td>ID do tipo de pagamento</td></tr><tr><td>titulo</td><td></td><td>titulo do carnê</td></tr><tr><td>valor</td><td></td><td>valor total do carnê</td></tr><tr><td>percentual</td><td></td><td>Percentual de juros</td></tr><tr><td>repassarTaxaCliente</td><td></td><td>Vai repassar a taxa para o cliente?</td></tr><tr><td>split</td><td></td><td>Haverá split? (true ou false)</td></tr><tr><td>splits</td><td></td><td><p><strong>[{estabelecimentoId: false</strong>, Há estabelecimento vinculado? (true ou false)</p><p><strong>cnfcnpj</strong> = Cpf ou Cnpj do estabelecimento<br><strong>nome</strong> = Nome do estabelecimento<br><strong>email</strong> = Email do estabelecimento<br><strong>valeu</strong> = Valor do split</p><p><strong>tipoSplit: 2</strong> = Informar id do tipo do split]}</p></td></tr><tr><td>titulo</td><td></td><td>Título do link do pagamento</td></tr></tbody></table>

**Exemplo de requisição:**

{% code overflow="wrap" %}

```json
{
  "cliente": {
    "nome": "LUCAS COELHO",
    "cpf": "03927561029",
    "dataNascimento": "2000-02-08",
    "email": "RUA SAO JOSEMARIA ESCRIVA",
    "celular": "99562909"
  },
  "clienteId:2666",
  "descontos": [
    {
      "mode": "",
      "value": 0,
      "limitDate": "2023-09-13T19:24:05.619Z"
    }
  ],
  "descricao":"descricaoteste",
  "diaVencimento":"2023-09-18",
  "endereco": {
    "logradouro": "Rua São Josemaría Escrivá",
    "numero": " 669 ",
    "cep": "91410-470",
    "cidade": "Porto Alegre",
    "estado": "RS",
    "complemento": ""
  }
  "estabelecimentoId":155,
  "parcelas":1,
  "splits": [
    {
      "estabelecimentoId": false,
      "cpfcnpj": "",
      "nome": "",
      "email": "",
      "value": 0,
      "tipoSplit": 2,
      "chargeProcessingFee": true
    }
  ],
  "tipoPagamentoId": 4,
  "titulo": "tete",
  "valor": 10,

}

```

{% endcode %}

**Exemplo de resultado:**

```json
{
  "success": true,
  "carne": {
      "id": 8441,
      "estabelecimento_id": 158,
      "usuario_id": 125,
      "cliente_id": 27432251,
      "titulo": "tete",
      "descricao": "teste",
      "parcelas": 1,
      "dia_vencimento": "18",
      "valor": 10,
      "modified": "2023-09-13T19:26:23.154Z",
      "created": "2023-09-13T19:26:23.154Z"
  }
}
```
