A integração remota da Cielo Smart tem como objetivo permitir que o lojista continue utilizando sua própria solução de frente de caixa (como sistemas de Automação Comercial ou PDV) e a conecte ao módulo de pedidos e pagamentos da Cielo Smart por meio de uma API desenvolvida com o padrão RESTful.

Dessa forma, toda a gestão do estabelecimento permanece sob responsabilidade da Automação Comercial. No momento do pagamento, a solução da Cielo Smart é acionada para realizar a transação de forma integrada e segura.

Siga o passo-a-passo abaixo para completar a integração remota com sucesso:

Fluxo de integração do pedido

Abaixo, estão descritas as etapas necessárias para que um pedido seja criado, transmitido e processado até seu recebimento na Cielo Smart.

Montagem do pedido: O cliente ou sistema inicia a criação do pedido com todos os itens e informações necessárias.
Envio do pedido: O pedido é finalizado e transmitido para o sistema central via API.
Processamento na nuvem: A API recebe o pedido e o envia para a nuvem, onde ele é armazenado e preparado para distribuição.
Recebimento na Cielo Smart: O dispositivo acessa a nuvem, recupera o pedido e o exibe para processamento ou finalização.

É assim que um pedido será enviado para a Cielo Smart utilizando a API Order Manager:

A API Order Manager da Cielo oferece os seguintes recursos:

Utiliza semântica REST, permitindo acesso via chamadas HTTP padrão;
Retorna códigos de status HTTP para indicar sucesso ou erro nas requisições;
Todas as requisições e respostas são estruturadas no formato JSON, garantindo simplicidade e compatibilidade.

Status do pedido

Durante o ciclo de vida de um pedido, ele pode assumir os seguintes status:

Código	Status	Descrição
0	`Draft`	Pedido criado, mas ainda não finalizado ou enviado.
1	`Entered`	Pedido registrado no sistema e aguardando processamento.
2	`Paid`	Pedido foi pago e está pronto para ser processado ou entregue.
3	`Closed`	Pedido finalizado, sem ações pendentes.
4	`Re-entered`	Pedido foi modificado ou reenviado após uma alteração. Foi marcado como Paid ou Closed e voltou para Entered.

Exemplo de código

Acesse o exemplo de código da integração entre a Automação Comercial e a API Order Manager da Cielo diretamente no GitHub. Esse exemplo demonstra como conectar sistemas de automação de vendas com a plataforma da Cielo, permitindo o gerenciamento de pedidos de forma eficiente e integrada