> For the complete documentation index, see [llms.txt](https://apidocs.cloudinvoice.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.cloudinvoice.net/documentacao-api/clientes/mov.-conta-corrente/create.md).

# Create

Cria movimento de conta-corrente manual.

## Criar Movimento de Conta-Corrente

<mark style="color:green;">`POST`</mark> `https://api.cloudinvoice.net/customers/:cust_id/movements/new/`

#### Path Parameters

| Name     | Type    | Description   |
| -------- | ------- | ------------- |
| cust\_id | integer | ID do Cliente |

#### Request Body

<table data-search="false"><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>description<mark style="color:red;">*</mark></td><td>string</td><td>Descrição do Movimento</td></tr><tr><td>document_nature_id<mark style="color:red;">*</mark></td><td>integer</td><td><p>Natureza do Documento</p><p></p><p>Consulte a tabela <a href="/documentacao-api/apendice.md#naturezas-de-documentos-campo-document_nature">Apêndice</a>.</p></td></tr><tr><td>document_reference<mark style="color:red;">*</mark></td><td>string</td><td><p>Referência do Documento<br><br>Identificador único do documento original que gerou o movimento.<br></p><p><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> É imperativo que o valor fornecido esteja em conformidade com identificadores já anteriormente comunicados à AT, para que seja estabelecida a relação.</p></td></tr><tr><td>document_reference_date</td><td>date<br><sub><mark style="color:$info;">Format: yyyy-mm-dd</mark></sub></td><td>Data do Documento de Referência</td></tr><tr><td>movement_amount<mark style="color:red;">*</mark></td><td>float</td><td>Total do Movimento<br><br>O movimento será considerado a Débito se o valor fornecido for positivo, ou a Crédito se for negativo. Valores nulos geram erro na importação dos dados.</td></tr><tr><td>due_date<mark style="color:red;">*</mark></td><td>date<br><sub><mark style="color:$info;">Format: yyyy-mm-dd</mark></sub></td><td>Data de Vencimento</td></tr><tr><td>due_amount</td><td>float<br><sub><mark style="color:$info;">Default: 0</mark></sub></td><td><p>Valor Pendente</p><p><br>Se o valor fornecido for diferente do fornecido em 'movement_amount' (em valor absoluto), o movimento será criado como parcialmente saldado.</p></td></tr></tbody></table>

{% tabs %}
{% tab title="Exemplo de Pedido" %}

```shell
curl -X POST https://api.cloudinvoice.net/customers/2/movements/new/
    -d '{
        "description": "Factura",
        "document_nature_id": 301,
        "document_reference": "FAC Z01/1",
        "movement_amount": 10,
        "due_date": "2017-05-20",
        "due_amount": 10
    }'
```

{% endtab %}

{% tab title="Exemplo de Resposta" %}

```json
{
    "id": 1,
    "description": "Factura",
    "document_reference": "FAC Z01/1",
    "document_nature_id": 301,
    "document_nature": {
        "code": "FT",
        "description": "Factura"
    },
    "account_movement_type_id": 1753,
    "account_movement_type": {
        "code": "D",
        "description": "Débito"
    },
    "account_type_id": 1,
    "account_type": {
        "code": "CC",
        "description": "Conta-corrente"
    },
    "party_class_id": 1601,
    "party_class": {
        "code": "C",
        "description": "Cliente"
    },
    "party_id": 2,
    "movement_date": "2026-08-18",
    "movement_time": null,
    "movement_amount": 10.0,
    "credit_amount": 0.0,
    "debit_amount": 10.0,
    "due_date": "2017-05-20",
    "due_amount": 10.0,
    "withholding_amount": 0.0,
    "withholding_due_amount": 0.0,
    "total_cumulate_amount": 0.0,
    "is_automatic_entry": false,
    "is_movement_reconciled": true,
    "is_cash_vat_scheme": false,
    "used_in_receipt": false,
    "used_in_receipt_ric": false
}
```

{% endtab %}
{% endtabs %}

Para ver exemplos de pedidos nas várias linguagens, consulte a página[ Exemplos de Pedidos.](/introducao/exemplos-de-pedidos.md)