Docs Pedidos - Banco de Dados
Como Funciona?
A integração ocorre diretamente em nosso integrador (SMI) instalado no ambiente do lojista, após a criação do template que realizará o insert.
Fluxo de uso
Desde a criação do pedido, nosso picking será responvel pelo andamento das etapas em que ele se encontra, o que está totalmente ligado ao start da integração. As etapas do receptor de pedidos são:
| EMITIDO | EM SEPARAÇÃO | SEPARADO | FINALIZADO/CANCELADO |
|---|
A integração do pedido irá entrar em ação após o pedido ficar no status de SEPARADO, nosso integrador (SMI) irá rodar o insert criado dentro de no maximo 1 minuto.
Criação do pedido e configuração do integrador
Para iniciar o desenvolvimento, é necessario que tenha realizado a etapa de cadastro inicial para receber as credenciais necessárias. Após realizado o cadastro é possivel criar pedidos de teste, gerencia-los no receptor de pedidos e configurar sua integração, siga os tutoriais descritos nos links abaixo:
Template
Para a inserção dos dados do pedido em banco de dados, não há um modelo de tabela específico. O parceiro pode utilizar praticamente qualquer informação do pedido para que possa gerar o documento fiscal em seu PDV/emissor fiscal.
Para criar o comando que irá informar ao SMI quais informações deseja inserir no banco, será necessário utilizar comandos que são chamados de Macros e Variáveis.
As macros auxiliam na formatação do template, e ainda fornecem a execução de querys que irão ser executadas no banco de dados onde foi realizada a integração de pedidos.
As variáveis retornam os dados do pedido, por exemplo: {codigo_pedido_loja}, retorna o número interno do pedido, que é o número que irá digitar para imprimir o cupom no PDV.
Para que isso aconteça é essencial que o sistema de PDV tenha a funcionalidade que permita importar dados de pedidos a partir de banco de dados próprio, caso contrário esse modelo não se aplica.
Exemplo
- Template básico configurado no SMI:
{QUERY}
INSERT INTO PEDIDO_IFOOD_CAB (COD_PEDIDO, CPF_CNPJ, PEDIDO_DATA, TOTAL, DESCONTO, ACRESCIMO)
VALUES (
{pedido_codigo_loja}, {cliente_cpf_cnpj}, {pedido_data}, {pedido_total_corrigido}, {pedido_valor_desconto},
{SUM}{pedido_valor_entrega}|{pedido_valor_conveniencia}{/SUM}
)
{LINEBREAK}
{LOOP_ITEMS}
INSERT INTO PEDIDO_IFOOD_ITEM (COD_PRODUTO, VALOR, QTD, SUB_TOTAL)
VALUES (
{pedido_item_codigo_barra}, {pedido_item_valor}, {pedido_item_quantidade}, {pedido_item_valor_total}
)
{LINEBREAK}
{/LOOP_ITEMS}
{/QUERY}- Resultado executado no banco de dados configurado:
INSERT INTO PEDIDO_IFOOD_CAB (COD_PEDIDO, CPF_CNPJ, PEDIDO_DATA, TOTAL, DESCONTO, ACRESCIMO)
VALUES (12345678, 56698016012, 19/02/2021, 87.34, 30.00, 14.00)
INSERT INTO PEDIDO_IFOOD_ITEM (COD_PRODUTO, VALOR, QTD, SUB_TOTAL)
VALUES (0000000000453, 6.69, 2.00, 13.38)
INSERT INTO PEDIDO_IFOOD_ITEM (COD_PRODUTO, VALOR, QTD, SUB_TOTAL)
VALUES (0000000000068, 24.99, 1.00, 24.99)
INSERT INTO PEDIDO_IFOOD_ITEM (COD_PRODUTO, VALOR, QTD, SUB_TOTAL)
VALUES (7891035115608, 12.99, 1.00, 12.99)
INSERT INTO PEDIDO_IFOOD_ITEM (COD_PRODUTO, VALOR, QTD, SUB_TOTAL)
VALUES (7891035070006, 18.99, 1.00, 18.99)
INSERT INTO PEDIDO_IFOOD_ITEM (COD_PRODUTO, VALOR, QTD, SUB_TOTAL)
VALUES (7891035539930, 32.99, 1.00, 32.99)