> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bsautomacao.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar uma NFe

> Crirar uma movimentação do tipo NFe

### Authorizations

<ParamField header="X-Api-Key" type="string" required>
  Chave de acesso da API.
</ParamField>

### Body

<ParamField body="movimentation_id" type="string" required>
  ID da movimentação (UUID).
</ParamField>

<ParamField body="recipient" type="object" required>
  Dados do destinatário.

  <Expandable title="properties">
    <ParamField body="id" type="string">
      ID do destinatário (UUID).
    </ParamField>

    <ParamField body="document" type="string" required>
      CPF ou CNPJ (11 a 14 caracteres).
    </ParamField>

    <ParamField body="name" type="string" required>
      Nome ou Razão Social.
    </ParamField>

    <ParamField body="postal_code" type="string" required>
      CEP (ex: 01001000).
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="products" type="Product[]" required>
  Lista de produtos da nota.

  <Expandable title="Product">
    <ParamField body="id" type="string" required>
      ID do produto (UUID).
    </ParamField>

    <ParamField body="unit_price" type="number" required>
      Preço unitário.
    </ParamField>

    <ParamField body="quantity" type="number" required>
      Quantidade.
    </ParamField>

    <ParamField body="subtotal" type="number" required>
      Valor total do item.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="payments" type="Payment[]" required>
  Informações de pagamento.

  <Expandable title="Payment">
    <ParamField body="status" type="integer" required>
      Status do pagamento.
    </ParamField>

    <ParamField body="payment_type" type="integer" required>
      Tipo: `1` (Dinheiro), `2` (Crédito), `3` (PIX).
    </ParamField>

    <ParamField body="value" type="number" required>
      Valor pago.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="subtotal" type="number" required>
  Valor total bruto dos produtos.
</ParamField>

<ParamField body="discount" type="number" required>
  Valor total de desconto.
</ParamField>

<ParamField body="date" type="string" required>
  Data da movimentação em formato ISO (ex: `2025-02-02T12:00:00.000Z`).
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url https://api.example.com/v1/movimentations/nfe \
    --header 'Content-Type: application/json' \
    --header 'X-Api-Key: <x-api-key>' \
    --data '{
      "movimentation_id": "c1a0e1b0-9c9a-4f45-bf42-123456789abc",
      "subtotal": 51.80,
      "discount": 0,
      "date": "2025-02-02T12:00:00.000Z",
      "recipient": {
        "document": "12345678000199",
        "name": "Empresa Exemplo LTDA",
        "postal_code": "01001000"
      },
      "products": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "unit_price": 25.90,
          "quantity": 2,
          "subtotal": 51.80,
          "discount": 0
        }
      ],
      "payments": [
        {
          "status": 1,
          "payment_type": 3,
          "value": 51.80
        }
      ]
    }'
  ```
</RequestExample>