---
title: "Cadastra um caixa"
method: POST
path: "/v1/caixas"
tags: ["Emissão de NFC-e"]
---

# Cadastra um caixa

`POST /v1/caixas`

## Request

- Base URL: `https://api.sudrel.com.br/api`
- URL: `https://api.sudrel.com.br/api/v1/caixas`
- Auth: HTTP bearer

## Request body

- object
  - `empresa_id` string, required
  - `identificador` string, required: Letras, números, ponto, hífen e sublinhado. Único na empresa.
  - `serie` integer, required: Única na empresa; não muda depois da primeira NFC-e do caixa.
  - `descricao` string

## Response `201`

Criado.

- CaixaNfce
  - `id` string
  - `empresa_id` string
  - `identificador` string
  - `descricao` string, nullable
  - `serie` integer
  - `situacao` 'ativo' | 'inativo'
  - `proximo_numero` integer, nullable: Próximo número da série do caixa; nulo antes da primeira NFC-e.
  - `desativado_em` string, date-time, nullable
  - `criado_em` string, date-time
  - `atualizado_em` string, date-time

## Other responses

- `401`: `nao_autenticado`: chave de API ausente, inválida ou revogada.
- `422`: `serie_invalida`, `caixa_serie_duplicada` ou `caixa_identificador_duplicado`.

---

[API](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e.md) · [All operations](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/llms.txt) · [OpenAPI document](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/revisions/efd7baba9e37?raw)