# Emit

## Criar Recibo

## Emite um novo recibo.

<mark style="color:green;">`POST`</mark> `https://api.cloudinvoice.net/receipts/emit/`

Os Recibos podem ser emitidos fornecendo uma lista de documentos a incluir ou por valor a liquidar. Ao emitir por valor a liquidar, os documentos a incluir no recibo serão selecionados automaticamente, do mais antigo para o mais recente, até prefazer o valor a liquidar fornecido.

#### Request Body

| Name          | Type                                      | Description                                                                                                                                                                                                                                                                                   |
| ------------- | ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| customer\_id  | integer                                   | <p>Cliente</p><p></p><p>Consulte a tabela <a href="../clientes/list">Clientes</a>.</p>                                                                                                                                                                                                        |
| documents     | array                                     | <p>Linhas do Recibo</p><p></p><p>Deverá conter uma lista de objectos, sendo que cada objecto poderá conter os parâmetros de um documento a incluir no Recibo conforme descritos no <a href="../apendice#documents-do-recibo">Apêndice</a>.</p>                                                |
| total\_amount | float                                     | <p>Valor a Liquidar</p><p></p><p>Seleção automática de documentos por valor a liquidar. <br><br><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> Apenas surtirá efeito se o campo 'documents' não for fornecido.</p>                                                   |
| payments      | array                                     | <p>Pagamentos do Recibo</p><p></p><p>Deverá conter uma lista de objetos, sendo que cada objeto poderá conter os parâmetros de um pagamento conforme descritos no <a href="../apendice#pagamento-do-recibo">Apêndice</a>.</p>                                                                  |
| finalize      | <p>boolean<br><em>Default: false</em></p> | <p>Finalizar o Recibo após criação</p><p></p><p>Finalizar o recibo de imediato. Deverá também fornecer dados relativos ao(s) pagamento(s) no campo <code>payments</code> equivalentes ao valor do recibo na sua totalidade.</p>                                                               |
| print         | boolean                                   | <p>Imprimir Recibo após Emissão</p><p></p><p><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> O Recibo deverá estar finalizado.</p><p></p><p>Consulte os parâmetros disponíveis para impressão no <a href="../apendice#impressao-do-recibo">Apêndice</a>.</p>          |
| email         | boolean                                   | <p>Enviar por E-mail após Emissão</p><p></p><p><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> O Recibo deverá estar finalizado.</p><p></p><p>Consulte os parâmetros disponíveis para impressão no <a href="../apendice#envio-por-e-mail-do-recibo">Apêndice</a>.</p> |

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

```shell
curl -X POST https://api.cloudinvoice.net/receipts/emit/
    -d '{
        "customer_id": 2,
        "documents": [
            {
                "id": 5078,
                "amount": 1
            }
        ],
        "payments": [
            {
                "payment_method_id": 1
            }
        ],
        "finalize": true
    }'
```

{% endtab %}

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

```json
{
    "id": 1,
    "doc_key": "REC A01/1",
    "document_date": "2026-03-11",
    "document_time": "10:25:10",
    "document_number": 1,
    "party_reference": "",
    "module_origin": 1,
    "party_id": 2,
    "party": {
        "class": 1601,
        "code": 2,
        "name": "Cliente Demo",
        "commercial_name": "",
        "fiscal_number": "123456789",
        "street1": "Rua Principal",
        "street2": "",
        "zip_code": "8800-000",
        "zip_locale": "Tavira"
    },
    "line_details_count": 1,
    "total_gross_amount": 1.0,
    "is_percentage_discount": true,
    "discount_percentage": 0.0,
    "total_net_amount": 0.8180337405,
    "total_amount": 1.0,
    "total_document_amount": 1.0,
    "total_received_amount": 1.0,
    "header_text": "",
    "footer_text": "",
    "number_of_prints": 0,
    "obs": "",
    "has_withholding": false,
    "document_nature_id": 341,
    "document_nature": {
        "code": "RG",
        "description": "Recibo"
    },
    "document_id": 14,
    "document": {
        "code": "REC",
        "document_name": "Recibo",
        "ask_payment_onclose": true
    },
    "document_serie_id": 1,
    "document_serie": {
        "code": "A01",
        "description": "Serie A01"
    },
    "document_status_id": 1202,
    "document_status": {
        "code": "F",
        "description": "Finalizado"
    },
    "salesman_id": null,
    "salesman": null
}
```

{% endtab %}
{% endtabs %}

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