---
title: "Registra a abertura do Caixa/PDV"
method: POST
path: "/v1/caixa/abertura"
tags: ["Vendas Gestão de Caixa"]
---

# Registra a abertura do Caixa/PDV

`POST /v1/caixa/abertura`

Este endpoint permite realizar a abertura de um Caixa/PDV no SankhyaOm. Para que o processo ocorra corretamente, o operador deve estar previamente vinculado ao cadastro do PDV no SankhyaOm. 

É importante observar que o SankhyaOm não permite mais de um "Caixa Aberto" simultaneamente para o mesmo PDV, isso para garantir a integridade da operação.

Ao abrir o Caixa/PDV, a API retornará o identificador codigoCaixa, que representa o "Caixa Aberto" para o período em questão. Esse codigoCaixa deve ser utilizado para realizar o fechamento do caixa e vincular todos os movimentos de venda ao respectivo "Caixa Aberto", garantindo a correta rastreabilidade das operações.

## Request body

- AbrirCaixa
  - `codigoPdv` integer, required — Código do PDV a ser aberto. Esse código é acessível através da nossa API, na entidade "CadastroPDV" (codigoPdv). Obtenha essa informação mantenha seus registros sempre atualizados. Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords)
  - `cpfOperador` string, required — Insira o CPF do operador de Caixa/PDV para localizar o Operador do Caixa vinculado ao PDV. Com essa informação, a API identifica o operador responsável no PDV e o vincula ao movimento. Para mais detalhes sobre o cadastro de usuários, [clique aqui](https://ajuda.sankhya.com.br/hc/pt-br/articles/360044597874-Usu%C3%A1rios)
  - `data` string, required — Data da abertura do Caixa/PDV
  - `hora` string, required — Hora da abertura do Caixa/PDV
  - `observacao` string

## Response `200`

Operação bem sucedida

- RetornoCaixaAberto
  - `codigoCaixa` integer — Identificador do Caixa/PDV aberto.
  - `data` string — Data da abertura do Caixa/PDV
  - `hora` string — Hora da abertura do Caixa/PDV

## Other responses

- `400` — Informações Inválidas. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `401` — Não autenticado. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `403` — Autenticação inválida. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `404` — Dados não encontrados. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `500` — Erro interno no servidor. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `501` — Não implementado. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `502` — Retorno inválido do servidor. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `503` — Serviço indisponível no momento. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `504` — Tempo de execução excedido. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.

---

[API](https://skmtc.net/sankhya/apis/api-sankhya.md) · [All operations](https://skmtc.net/sankhya/apis/api-sankhya/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sankhya/api-sankhya/revisions/0a3e81ca6195/schema)