Beasy Integrações v2/v3

A plataforma da Beasy possibilitará a implementação de integrações JSON para importação/exportação de dados. Para a utilização de todos os métodos é necessário enviar no cabeçalho(header) de todas as solicitações o valor do token do usuário, o token é gerado quando o usuário é criado no painel administrativo da Beasy. Para que o webservice interprete qual usuário está solicitando informações é necessário enviar o token em todas as solicitações.

A versão da API também deve ser enviada como version no cabeçalho da requisição. Por padrão o valor é 1.

Este pacote é destinado a integração com o ERP do mercado. Nele estão todas as integrações necessárias para um bom funcionamento do sistema.

Para testes utilize os valores abaixo:

URL: http://sandbox.beasy.mobi
Token: 582bc29a313ad74224b1f996c9fe5a39

Em caso de dúvidas entre em contato.

Responsável

Lucas Chiarello
lucas@beasy.mobi
(054) 3712-5089

v2 - Integração de Cliente 6

Este grupo é responsável por gerenciar as informações de cada cliente individualmente.

Description

Realiza a alteração do cliente no sistema.

Headers
KeyValueDescription
Content-Typeapplication/json
token582bc29a313ad74224b1f996c9fe5a39
version2
Body
{ "id": "371", "nome": "FELIPE DO AMARAL PEREIRA", "cpf": "4555750705", "celular": "00", "nascimento": "28/05/1975", "genero": "1", "cep": "23071440", "estado": "RJ", "cidade": "RIO DE JANEIRO", "bairro": "CAMPO GRANDE", "endereco": "RUA ARI DE OLIVEIRA LIMA", "numero": "S/N", "complemento": "lt 11", "rg": "099574089", "clubes": [ "182" ] }

Description

Este webservice é responsável por buscar os cliente a partir do CPF, o CPF pode ser enviado com pontuação ou sem.

Headers
KeyValueDescription
Content-Typeapplication/json
token582bc29a313ad74224b1f996c9fe5a39
version2

Description

Este webservice é responsável por buscar os cliente a partir do E-mail.

Headers
KeyValueDescription
Content-Typeapplication/json
token582bc29a313ad74224b1f996c9fe5a39
version2

Description

Realiza a busca do cliente a partir do ID da Beasy.

Headers
KeyValueDescription
token582bc29a313ad74224b1f996c9fe5a39
version2

Description

Este webservice é responsável por buscar os cliente a partir do CPF, o CPF pode ser enviado com pontuação ou sem.

O campo “tipo_cadastro” é enviado para distinguir por onde o cliente foi inserido no sistema. Os tipos de clientes são:

1 - Cadastro via Aplicativo 2 - Cadastro via Administrativo 3 - Cadastro via Site 4 - Cadastro via Landing Page 5 - Importação do ERP 6 - Importação de outros CRM’s 7 - Outros

Headers
KeyValueDescription
Content-Typeapplication/json
token582bc29a313ad74224b1f996c9fe5a39
version2
Body
{ "nome": "Martin Igor Heitor", "cpf": "577.938.870-93", "celular": "54999900492", "email": "martinigorheitor@veraparodi.com.br", "nascimento": "20/11/1998", "genero": "1", "cep": "55153775" }

Description

Retorna uma lista de clientes que realizaram o cadastro via aplicativo.

Headers
KeyValueDescription
token582bc29a313ad74224b1f996c9fe5a39
version2
Query
KeyValueDescription
pagina0

v2 - Integração de Clientes Atualização 2

Este grupo é responsável por retornar todos os clientes que necessitam de atualização. Quando um cliente alterar qualquer informação de seu perfil na Beasy, via painel administrativo ou via aplicativo, seus dados atualizados são enviados para esta integração. O ERP deve consultar constantemente esta integração a fim de mantar atualizado os dados de seus clientes no ERP. Após consultar e atualizar os clientes é necessário confirmar a atualização, assim novos clientes são disponibilizados nesta API.

Description

Este webservice é reponsável por informar ao sistema que os clientes retornados na API /rest/clientes foram atualizados com sucesso, com isso o servidor atualiza a lista de clientes e na próxima consulta retorna novos clientes.

Deve ser disparado imediatamente após a atualização dos Clientes.

Headers
KeyValueDescription
Content-Typeapplication/json
token582bc29a313ad74224b1f996c9fe5a39
version2

Description

Este webservice é reponsável por retornar todos os clientes que necessitam de atualização, ou seja, quando um cliente altera qualquer informação referente ao seu perfil é enviado para o este webservice.

Após a requisição é necessário enviar uma confirmação para o webservice via PUT, assim será liberado novos clientes.

Headers
KeyValueDescription
Content-Typeapplication/json
token582bc29a313ad74224b1f996c9fe5a39
version2

v2 - Integração de Clubes - Clientes 2

Estes webservices são responsáveis pelo gerenciamento dos clubes do sistema.

Description

Este webservice é responsável por adicionar o cliente no clube. O ID do clube é o valor cadastrado na Beasy como id_erp.

Headers
KeyValueDescription
Content-Typeapplication/json
token582bc29a313ad74224b1f996c9fe5a39
version2
Body
{ "cpf":"02173318071", "clubes":["84"] }

Description

Este webservice retorna a lista de clientes que participam de um determinado clube. São retornados 25 clientes por página, o último parametro informado na URL é responsável pela paginação da lista de clientes.

Headers
KeyValueDescription
Content-Typeapplication/json
token582bc29a313ad74224b1f996c9fe5a39
version2

v2 - Integração de Clubes - Produtos 4

Description

Este webservice é responsável por alterar as informações dos produtos disponibilizados nos clubes. O produto é vinculado ao código EAN ou código interno, quando o produto possuir o código já cadastrado no clube realiza a alteração do mesmo.

Não é possível alterar em qual clube o produto está disponível.

Headers
KeyValueDescription
Content-Typeapplication/json
token582bc29a313ad74224b1f996c9fe5a39
version2
Body
[ { "codigo":"513569", "nome":"Contra Filé Novilho Especial Kg", "preco_normal":"36.88", "preco":"35.85", "unidade":"kg", "quantidade":"49", "observacao":"Limite de 5 itens por CPF", "data_inicio":"2021-09-01 10:00:00", "data_termino":"2021-10-01 00:00:00", "id_erp": "83", "id_loja_erp": "6" }, { "codigo":"513569", "nome":"Filé Bovino C/ Osso Kg", "preco_normal":"26.88", "preco":"25.85", "unidade":"kg", "quantidade":"123", "observacao":"Limite de 5 itens por CPF", "data_inicio":"2017-09-01 10:00:00", "data_termino":"2017-10-01 00:00:00", "id_erp": "83", "id_loja_erp": "7" } ]

Description

Este webservice é responsável por excluir um produto do clube.

Headers
KeyValueDescription
token582bc29a313ad74224b1f996c9fe5a39
version2

Description

Webservice para cadastro dos produtos do Clube. É enviado via POST os valores em JSON referentes ao produto, é possível enviar mais de um produto por vez. No exemplo abaixo são enviados dois produtos. O id_erp refere-se ao ID do clube criado no sistema ERP do supermercado, o produto pode ser vinculado a mais de um clube, para isso deve ser enviado novamente o produtos alterando o id_erp.

Headers
KeyValueDescription
Content-Typeapplication/json
token582bc29a313ad74224b1f996c9fe5a39
version2
Body
[ { "codigo":"124584", "nome":"Contra Filé Novilho Especial Kg", "preco_normal":"36.88", "preco":"35.85", "unidade":"kg", "quantidade":"49", "observacao":"Limite de 5 itens por CPF", "data_inicio":"2017-09-01 10:00:00", "data_termino":"2017-10-01 00:00:00", "id_erp":"83", "id_loja_erp":"7" }, { "codigo":"513569", "nome":"Filé Bovino C/ Osso Kg", "preco_normal":"26.88", "preco":"25.85", "unidade":"kg", "quantidade":"123", "observacao":"Limite de 5 itens por CPF", "data_inicio":"2017-09-01 10:00:00", "data_termino":"2017-10-01 00:00:00", "id_erp":"83", "id_loja_erp":"6" } ]

Headers
KeyValueDescription
Content-Typeapplication/json
token582bc29a313ad74224b1f996c9fe5a39
version2

v2 - Integração de Compras 4

Este pacote é responsável por inserir todos as compras realizadas pelos clientes do sistema. Não é recebida nenhuma compra que o CPF do cliente não esteja cadastrado no sistema. Os valores enviados na compra devem condizer com os valores pagos pelo cliente.

É de extrema importância que seja enviado apenas compras confirmadas, onde não houve o extorno ou devolução de produtos.

valor - Total pago pelo cliente com descontos

economia - Total economizado pelo cliente na compra

loja - Número da loja informado no ERP

ecf - Emissor do cupom fiscal (Pode ser o numero do PDV)

cupom - Número do cupom fiscal

Description

Webservice para cadastro das compras efetuadas por um cliente. É enviado via POST os valores em JSON referentes à compra, é possível enviar mais de uma compra por vez e mais de um produto por compra. No exemplo abaixo são enviadas dois produtos de exemplo. As compras não são processadas em tempo real. A compra é salva em nosso servidor e processada durante o dia, garantindo uma segurança dos dados recebidos. É possível alterar os valores de uma compra quando enviada novamente. Para que isso ocorra os valores da loja, ecf e cupom devem ser os mesmos. loja - o ID da loja no ERP, esse valor deve ser informado no sistema da Beasy no cadastro do supermercado. ecf - emissor do cupom fiscal ou outro valor que diferencie entre os PDV’s. cupon - cupom fiscal da compra. cpf - o campo CPF deve ser informado somente nas compras onde o cliente informou o CPF. Para compras sem CPF envie o campo em branco. Para realizar a filtragem dos produtos é utilizada a GPC (Classificação Global de Produtos) feita pela GS1 Brasil. Caso o mercado opte por não enviar os campos de filtragem não é necessário inserir os mesmos no JSON.

Headers
KeyValueDescription
Content-Typeapplication/json
token582bc29a313ad74224b1f996c9fe5a39
version2
Body
[ { "cpf":"021.733.180-71", "valor":"133.67", "economia":"3.50", "loja":"6", "ecf":"14548", "cupom":"0001489", "data":"2017-12-20 08:31:41", "produtos":[ { "codigo":"7894900700046", "nome":"Refrigerante Coca-Cola Lata Zero", "quantidade":"1", "preco":"2.99", "marca":"Coca-Cola", "distribuidor":"The Coca-Cola Company", "segmento_gpc":"50000000", "familia_gpc":"50200000", "classe_gpc":"50202300", "bloco_gpc":"10000201", "tipo_atributo_gpc":"20000242", "valor_atributo_gpc":"20000092" }, { "codigo":"7897184000079", "nome":"Refrigerante Mineiro Guaraná", "quantidade":"1", "preco":"1.99", "marca":"Mineiro", "distribuidor":"JLC Distribuição", "segmento_gpc":"50000000", "familia_gpc":"50200000", "classe_gpc":"50202300", "bloco_gpc":"10000201", "tipo_atributo_gpc":"20000242", "valor_atributo_gpc":"20000092" } ] } ]

Description

Esta API é responsável por inserir uma devolução, conhecida como DDM. Quando enviada deve ser vinculada ao valor da compra antes realizada pelo cliente. Deve ser enviada a loja, cupom e ecf para distinguir entre as compras.

É necessário enviar os produtos que foram removidos da compra.

Headers
KeyValueDescription
token582bc29a313ad74224b1f996c9fe5a39
version2
Body
{ "valor":"3.50", "loja":"6", "ecf":"920", "cupom":"201118", "data":"2019-09-10 08:31:41", "produtos":[ { "codigo":"7897184000079", "quantidade":"1" } ] }

Headers
KeyValueDescription
token582bc29a313ad74224b1f996c9fe5a39
version2

Description

Retorna as informações de importação das compras e seu status.

Headers
KeyValueDescription
token582bc29a313ad74224b1f996c9fe5a39
version2

v2 - Integração de Encartes - Produtos 3

Description

Webservice para edição dos produtos do Encarte. É enviado via POST os valores em JSON referentes ao produto, é possível enviar mais de um produto por vez. O id_erp refere-se ao ID do encarte criado no sistema ERP do Supermercado, o encarte pode ser vinculado a um ou mais supermercados.

Headers
KeyValueDescription
Content-Typeapplication/json
token582bc29a313ad74224b1f996c9fe5a39
version2
Body
[ { "codigo":"124584", "nome":"Caixa Termica Mor 34l", "preco_normal":"72.99", "preco":"69.90", "unidade":"un", "quantidade":"10", "observacao":"Compre uma e leve a segunda pela metade do preço!", "categoria_erp":"885" } ]

Description

Webservice responsável por excluir um produto do sistema.

Headers
KeyValueDescription
Content-Typeapplication/json
token582bc29a313ad74224b1f996c9fe5a39
version2

Description

Webservice para cadastro dos produtos do Encarte. É enviado via POST os valores em JSON referentes ao produto, é possível enviar mais de um produto por vez. No exemplo abaixo são enviadas dois produtos de exemplo. O id_erp refere-se ao ID do encarte criado no sistema ERP do Supermercado, o encarte pode ser vinculado a um ou mais supermercados. O destaque é necessário quando o produto deve receber um destaque dos demais produtos pertencentes a este encarte, produtos destaque são os primeiros a aparecer nas buscas e/ou acessos. O link é utilizado para redirecionar o produto para um link específico da Web. Envie o link completo para funcionar corretamente.

Headers
KeyValueDescription
Content-Typeapplication/json
token582bc29a313ad74224b1f996c9fe5a39
version2
Body
[ { "codigo": "124584", "nome": "Contra Filé Novilho Especial Kg", "preco_normal": "36.88", "preco": "35.85", "unidade": "kg", "quantidade": "49", "link": "https://loja.seusite.com.br/produto/124584", "observacao": "Limite de 5 itens por CPF", "destaque": "1", "status": "1", "categoria_erp": "305", "id_erp": "39" }, { "codigo": "513569", "nome": "Filé Bovino C/ Osso Kg", "preco_normal": "26.88", "preco": "25.85", "unidade": "kg", "quantidade": "123", "link": "", "observacao": "Limite de 5 itens por CPF", "destaque": "0", "status": "2", "categoria_erp": "305", "id_erp": "39" } ]

v2 - Integração de Encartes - Tablóides 3

Description

Este webservice é responsável por modificar um encarte/tablóide de ofertas no sistema. O encarte possui data de início e término das ofertas.

O id_erp é o campo responsável por realizar a integração entre o ERP e o sistema da Beasy. Este valor deve ser único. O campo status pode receber os valores de 1 ou 2, ativo e inativo respectivamente, caso não for enviado o valor padrão é 1.

Headers
KeyValueDescription
Content-Typeapplication/json
token582bc29a313ad74224b1f996c9fe5a39
version2
Body
{ "nome":"Volta as aulas é aqui!", "data_inicio":"2018-01-20", "data_termino":"2018-02-20", "status":"2", "lojas": ["1","2","6"] }

Description

Webservice responsável por excluir um encarte do sistema.

Headers
KeyValueDescription
token582bc29a313ad74224b1f996c9fe5a39
version2

Description

Este webservice é responsável por inserir um novo encarte/tablóide de ofertas no sistema. O encarte possui data de início e término das ofertas.

O id_erp é o campo responsável por realizar a integração entre o ERP e o sistema da Beasy. Este valor deve ser único. O campo status pode receber os valores de 1 ou 2, ativo e inativo respectivamente, caso não for enviado o valor padrão é 1.

Headers
KeyValueDescription
Content-Typeapplication/json
token582bc29a313ad74224b1f996c9fe5a39
version2
Body
{ "id_erp":"59", "nome":"Volta as aulas é aqui!", "data_inicio":"2018-01-20", "data_termino":"2018-02-20", "status":"2", "lojas": ["1","2","6"] }

v2 - Integração de Notificação 1

Estas API’s são responsáveis por enviar notificações para os clientes, conforme desejado.

Description

Envia uma notificação para um cliente em específico conforme o CPF enviado.

Headers
KeyValueDescription
token582bc29a313ad74224b1f996c9fe5a39
version2
Content-Typeapplication/json
Body
{ "cpf":"021.733.180-71", "titulo":"Teste de notificação", "mensagem":"Teste de mensagem" }

v2 - Integração de Ofertas Personalizadas - Clientes 2

Description

Confirma que as últimas ofertas retornadas foram liberadas, retornando novas ofertas pendentes na próxima busca.

Deve ser disparada imediatamente após a liberação das ofertas no frente de caixa.

Headers
KeyValueDescription
token582bc29a313ad74224b1f996c9fe5a39
version2

Description

Retorna as ofertas que foram “pegas” pelos clientes de 25 em 25 para liberar a oferta pelo CPF

Headers
KeyValueDescription
token582bc29a313ad74224b1f996c9fe5a39
version2
Body

v2 - Integração de Ofertas Personalizadas - Ofertas 2

As ofertas personalizadas são ofertas criadas dentro da Beasy para um público específico e único. As ofertas são vinculadas ao CPF dos clientes.

Description

Faz a ligação entre o código da oferta gerado no ERP e a oferta do painel Beasy.

Deve ser disparado imediatamente após o cadastro da oferta no ERP.

Headers
KeyValueDescription
token582bc29a313ad74224b1f996c9fe5a39
version2
Content-Typeapplication/json
Body
[ { "id":"14", "id_erp":"22000" } ]

Description

Retorna a(s) oferta(s) que foram criadas no painel Beasy mas não foram integradas no ERP.

Headers
KeyValueDescription
token582bc29a313ad74224b1f996c9fe5a39
version2

v2 - Integração de Ofertas do Dia - Especiais 3

Description

Webservice para edição dos produtos em ofertas no dia. Este webservice é destinado para produtos que devem ganhar um destaque extra entre as demais ofertas. É limitado até 25 itens por loja. O id_loja_erp refere-se ao ID cadastrado no ERP do Supermercado. O ID das lojas deve ser único.

Headers
KeyValueDescription
Content-Typeapplication/json
token582bc29a313ad74224b1f996c9fe5a39
version2
Body
[ { "codigo":"7891008299907", "id_loja_erp":"2", "nome":"PATE ATUM COQUEIRO 170G TRADICIONAL", "preco_normal":"6.99", "preco":"5.89", "unidade":"UN", "quantidade":"5", "observacao":"Limite de 5 itens por CPF", "data_inicio":"2017-09-01 10:00:00", "data_termino":"2017-10-01 00:00:00" } ]

Description

Webservice para cadastro dos produtos em ofertas no dia. Este webservice é destinado para produtos que devem ganhar um destaque extra entre as demais ofertas. É limitado até 25 itens por loja. O id_loja_erp refere-se ao ID cadastrado no ERP do Supermercado. O ID das lojas deve ser único. O id_loja_erp deve ser cadastrado no sistema da Beasy.

Headers
KeyValueDescription
Content-Typeapplication/json
token582bc29a313ad74224b1f996c9fe5a39
version2
Body
[ { "codigo": "7891008299907", "id_loja_erp": "1", "categoria_erp": "767", "nome": "CHOC GAROTO 150G AO LEITE", "preco_normal": "5.45", "preco": "1.99", "data_inicio": "2020-02-17 00:00:01", "data_termino": "2020-02-17 23:59:59" } ]

Description

Webservice responsável por remover uma oferta.

Headers
KeyValueDescription
Content-Typeapplication/json
token582bc29a313ad74224b1f996c9fe5a39
version2

v2 - Integração de Ofertas por Quantidade 2

Headers
KeyValueDescription
Content-Typeapplication/json
token582bc29a313ad74224b1f996c9fe5a39
version2
Body
{ "tipo": "1", "nome": "PROMOCAO TESTE", "data_inicio": "2019-11-01", "data_termino": "2019-11-30", "status": "1", "lojas": [ { "id_loja_erp": 1, "grupos_normais": [ { "id_erp": 1, "nome": "COMPRA", "quantidade": 2, "status": "1", "itens": [ { "id_erp": 20327, "codigo": "6549871324", "nome": "FRALDA PAMPERS CONF SEC PACOT G C20", "unidade": "un", "preco": 28.90, "status": "1" }, { "id_erp": 20333, "codigo": "87654879", "nome": "FRALDA PAMPERS CONF SEC PACOT M C24", "unidade": "un", "preco": 28.90, "status": "1" }, { "id_erp": 22562, "codigo": "89765415", "nome": "FRALDA PAMPERS CONF SEC PACOT M C28", "unidade": "un", "preco": 28.90, "status": "1" }, { "id_erp": 20336, "codigo": "254897812", "nome": "FRALDA PAMPERS CONF SEC PACOT XG 18", "unidade": "un", "preco": 28.90, "status": "1" }, { "id_erp": 20350, "codigo": "21564787", "nome": "FRALDA PAMPERS CONF SEC PACOT XXG18", "unidade": "un", "preco": 28.90, "status": "1" } ] } ], "grupos_promocionais": [ { "id_erp": 50, "nome": "GANHE", "quantidade": 1, "status": "1", "itens": [ { "id_erp": 20327, "codigo": "6549871324", "nome": "FRALDA PAMPERS CONF SEC PACOT G C20", "unidade": "un", "preco": 28.90, "preco_promocional": 0.01, "percentual": "", "status": "1" }, { "id_erp": 20333, "codigo": "87654879", "nome": "FRALDA PAMPERS CONF SEC PACOT M C24", "unidade": "un", "preco": 28.90, "preco_promocional": 0.01, "percentual": "", "status": "1" }, { "id_erp": 22562, "codigo": "89765415", "nome": "FRALDA PAMPERS CONF SEC PACOT M C28", "unidade": "un", "preco": 28.90, "preco_promocional": 0.01, "percentual": "", "status": "1" }, { "id_erp": 20336, "codigo": "254897812", "nome": "FRALDA PAMPERS CONF SEC PACOT XG 18", "unidade": "un", "preco": 28.90, "preco_promocional": 0.01, "percentual": "", "status": "1" }, { "id_erp": 20350, "codigo": "21564787", "nome": "FRALDA PAMPERS CONF SEC PACOT XXG18", "unidade": "un", "preco": 28.90, "preco_promocional": 0.01, "percentual": "", "status": "1" } ] } ] }, { "id_loja_erp": 2, "grupos_normais": [ { "id_erp": 8, "nome": "COMPRA", "quantidade": 2, "status": "1", "itens": [ { "id_erp": 20327, "codigo": "6549871324", "nome": "FRALDA PAMPERS CONF SEC PACOT G C20", "unidade": "un", "preco": 28.90, "status": "1" }, { "id_erp": 20333, "codigo": "87654879", "nome": "FRALDA PAMPERS CONF SEC PACOT M C24", "unidade": "un", "preco": 28.90, "status": "1" }, { "id_erp": 22562, "codigo": "89765415", "nome": "FRALDA PAMPERS CONF SEC PACOT M C28", "unidade": "un", "preco": 28.90, "status": "1" }, { "id_erp": 20336, "codigo": "254897812", "nome": "FRALDA PAMPERS CONF SEC PACOT XG 18", "unidade": "un", "preco": 28.90, "status": "1" }, { "id_erp": 20350, "codigo": "21564787", "nome": "FRALDA PAMPERS CONF SEC PACOT XXG18", "unidade": "un", "preco": 28.90, "status": "1" } ] } ], "grupos_promocionais": [ { "id_erp": 9, "nome": "GANHE", "quantidade": 1, "status": "1", "itens": [ { "id_erp": 20327, "codigo": "6549871324", "nome": "FRALDA PAMPERS CONF SEC PACOT G C20", "unidade": "un", "preco": 28.90, "preco_promocional": 0.01, "percentual": "", "status": "1" }, { "id_erp": 20333, "codigo": "87654879", "nome": "FRALDA PAMPERS CONF SEC PACOT M C24", "unidade": "un", "preco": 28.90, "preco_promocional": 0.01, "percentual": "", "status": "1" }, { "id_erp": 22562, "codigo": "89765415", "nome": "FRALDA PAMPERS CONF SEC PACOT M C28", "unidade": "un", "preco": 28.90, "preco_promocional": 0.01, "percentual": "", "status": "1" }, { "id_erp": 20336, "codigo": "254897812", "nome": "FRALDA PAMPERS CONF SEC PACOT XG 18", "unidade": "un", "preco": 28.90, "preco_promocional": 0.01, "percentual": "", "status": "1" }, { "id_erp": 20350, "codigo": "21564787", "nome": "FRALDA PAMPERS CONF SEC PACOT XXG18", "unidade": "un", "preco": 28.90, "preco_promocional": 0.01, "percentual": "", "status": "1" } ] } ] } ] }

Headers
KeyValueDescription
token582bc29a313ad74224b1f996c9fe5a39
version2
Content-Typeapplication/json
Body
{ "tipo": "1", "id_erp": 99, "nome": "PROMOCAO TESTE", "data_inicio": "2019-11-01", "data_termino": "2019-11-30", "status": "1", "lojas": [ { "id_loja_erp": 1, "grupos_normais": [ { "id_erp": 1, "nome": "COMPRA", "quantidade": 2, "status": "1", "itens": [ { "id_erp": 20327, "codigo": "6549871324", "nome": "FRALDA PAMPERS CONF SEC PACOT G C20", "unidade": "un", "preco": 28.90, "status": "1" }, { "id_erp": 20333, "codigo": "87654879", "nome": "FRALDA PAMPERS CONF SEC PACOT M C24", "unidade": "un", "preco": 28.90, "status": "1" }, { "id_erp": 22562, "codigo": "89765415", "nome": "FRALDA PAMPERS CONF SEC PACOT M C28", "unidade": "un", "preco": 28.90, "status": "1" }, { "id_erp": 20336, "codigo": "254897812", "nome": "FRALDA PAMPERS CONF SEC PACOT XG 18", "unidade": "un", "preco": 28.90, "status": "1" }, { "id_erp": 20350, "codigo": "21564787", "nome": "FRALDA PAMPERS CONF SEC PACOT XXG18", "unidade": "un", "preco": 28.90, "status": "1" } ] } ], "grupos_promocionais": [ { "id_erp": 50, "nome": "GANHE", "quantidade": 1, "status": "1", "itens": [ { "id_erp": 20327, "codigo": "6549871324", "nome": "FRALDA PAMPERS CONF SEC PACOT G C20", "unidade": "un", "preco": 28.90, "preco_promocional": 0.01, "percentual": "", "status": "1" }, { "id_erp": 20333, "codigo": "87654879", "nome": "FRALDA PAMPERS CONF SEC PACOT M C24", "unidade": "un", "preco": 28.90, "preco_promocional": 0.01, "percentual": "", "status": "1" }, { "id_erp": 22562, "codigo": "89765415", "nome": "FRALDA PAMPERS CONF SEC PACOT M C28", "unidade": "un", "preco": 28.90, "preco_promocional": 0.01, "percentual": "", "status": "1" }, { "id_erp": 20336, "codigo": "254897812", "nome": "FRALDA PAMPERS CONF SEC PACOT XG 18", "unidade": "un", "preco": 28.90, "preco_promocional": 0.01, "percentual": "", "status": "1" }, { "id_erp": 20350, "codigo": "21564787", "nome": "FRALDA PAMPERS CONF SEC PACOT XXG18", "unidade": "un", "preco": 28.90, "preco_promocional": 0.01, "percentual": "", "status": "1" } ] } ] }, { "id_loja_erp": 2, "grupos_normais": [ { "id_erp": 1, "nome": "COMPRA", "quantidade": 2, "status": "1", "itens": [ { "id_erp": 20327, "codigo": "6549871324", "nome": "FRALDA PAMPERS CONF SEC PACOT G C20", "unidade": "un", "preco": 28.90, "status": "1" }, { "id_erp": 20333, "codigo": "87654879", "nome": "FRALDA PAMPERS CONF SEC PACOT M C24", "unidade": "un", "preco": 28.90, "status": "1" }, { "id_erp": 22562, "codigo": "89765415", "nome": "FRALDA PAMPERS CONF SEC PACOT M C28", "unidade": "un", "preco": 28.90, "status": "1" }, { "id_erp": 20336, "codigo": "254897812", "nome": "FRALDA PAMPERS CONF SEC PACOT XG 18", "unidade": "un", "preco": 28.90, "status": "1" }, { "id_erp": 20350, "codigo": "21564787", "nome": "FRALDA PAMPERS CONF SEC PACOT XXG18", "unidade": "un", "preco": 28.90, "status": "1" } ] } ], "grupos_promocionais": [ { "id_erp": 50, "nome": "GANHE", "quantidade": 1, "status": "1", "itens": [ { "id_erp": 20327, "codigo": "6549871324", "nome": "FRALDA PAMPERS CONF SEC PACOT G C20", "unidade": "un", "preco": 28.90, "preco_promocional": 0.01, "percentual": "", "status": "1" }, { "id_erp": 20333, "codigo": "87654879", "nome": "FRALDA PAMPERS CONF SEC PACOT M C24", "unidade": "un", "preco": 28.90, "preco_promocional": 0.01, "percentual": "", "status": "1" }, { "id_erp": 22562, "codigo": "89765415", "nome": "FRALDA PAMPERS CONF SEC PACOT M C28", "unidade": "un", "preco": 28.90, "preco_promocional": 0.01, "percentual": "", "status": "1" }, { "id_erp": 20336, "codigo": "254897812", "nome": "FRALDA PAMPERS CONF SEC PACOT XG 18", "unidade": "un", "preco": 28.90, "preco_promocional": 0.01, "percentual": "", "status": "1" }, { "id_erp": 20350, "codigo": "21564787", "nome": "FRALDA PAMPERS CONF SEC PACOT XXG18", "unidade": "un", "preco": 28.90, "preco_promocional": 0.01, "percentual": "", "status": "1" } ] } ] } ] }

v2 - Integração do Banco de Fotos 3

Headers
KeyValueDescription
token582bc29a313ad74224b1f996c9fe5a39
version2

Headers
KeyValueDescription
token582bc29a313ad74224b1f996c9fe5a39
version2

Headers
KeyValueDescription
token582bc29a313ad74224b1f996c9fe5a39
version2

v3 - Integração de Categorias 1

Description

API para cadastro das categorias do Encarte. É enviado via POST os valores em JSON referentes a categoria. , O id_erp refere-se ao ID da categoria criado no sistema ERP do supermercado, a categoria pode ser vinculado a mais de um encarte, para isso deve ser enviado novamente o encarte alterando o id_erp. O id_pai refere-se ao ID da categoria do qual esta categoria herda. O id_pai não é um itém obrigatório. O codigo_erp_pai refere-se ao ID da categoria pai criado no sistema ERP do supermercado, a categoria pai pode ser vinculado a mais de uma categoria filha.

Headers
KeyValueDescription
token582bc29a313ad74224b1f996c9fe5a39
version3
Body
{ "codigo_erp":"01", "nome":"Exemplo categoria", "descricao":"Esta é uma categoria de Exemplo" }

v3 - Integração de Clientes 1

Description

Está API Rest retorna os últimos clientes que tiveram alguma atualização nas suas informações cadastradas dentro do intervalo de tempo específicado na url.

Headers
KeyValueDescription
token582bc29a313ad74224b1f996c9fe5a39
version3
Body

v3 - Integração de Mercados 1

Description

Esta API faz a integação com o ERP inserindo uma loja por vez no banco de dados.

Headers
KeyValueDescription
token582bc29a313ad74224b1f996c9fe5a39
version3
Body
{ "id_erp": "01", "nome": "Mercado Exemplo", "telefone": "(54)99999-9999", "email": "sac@exemplo.com", "site": "www.mercadoexemplo.com", "endereco": "Rua Exemplo, 120", "cidade": "Exemplo", "localizacao": "-27.648406,-52.245991", "funcionamento": { "segunda": { "inicio": "08:00", "termino": "18:00" }, "terca": { "inicio": "08:00", "termino": "18:00" }, "quarta": { "inicio": "08:00", "termino": "18:00" }, "quinta": { "inicio": "08:00", "termino": "18:00" }, "sexta": { "inicio": "08:00", "termino": "18:00" }, "sabado": { "inicio": "08:00", "termino": "18:00" }, "domingo": { "inicio": "08:00", "termino": "18:00" }, "feriados": { "inicio": "08:00", "termino": "18:00" } }, "nome_responsavel": "Exemplo", "email_responsavel": "funcionario.exemplo@exemplo.com", "telefone_responsavel": "(54)99999-9999", "area_entrega": [ [ { "lat": -27.619619158500125, "lng": -52.27630313967287 }, { "lat": -27.622794706564157, "lng": -52.27211889360964 }, { "lat": -27.627186882672206, "lng": -52.26724800203859 }, { "lat": -27.6334038641902, "lng": -52.267698613153094 }, { "lat": -27.640684990647017, "lng": -52.276903954492205 }, { "lat": -27.644942879409385, "lng": -52.28849145983277 }, { "lat": -27.64190154720372, "lng": -52.29664573763428 }, { "lat": -27.642433786443377, "lng": -52.31170920466003 }, { "lat": -27.643726356673557, "lng": -52.31904790972289 }, { "lat": -27.639012203293497, "lng": -52.31999240969237 }, { "lat": -27.633840581736763, "lng": -52.313083039270005 }, { "lat": -27.62821245348816, "lng": -52.3092635736328 } ], [ { "lat": -27.61885865743353, "lng": -52.243429985986346 }, { "lat": -27.62437319682303, "lng": -52.236477700219744 }, { "lat": -27.63627485973203, "lng": -52.231242028222674 }, { "lat": -27.639468420562654, "lng": -52.27544628237303 }, { "lat": -27.623117395378564, "lng": -52.27252803896483 } ] ], "preco_entrega": { "1": "5.90", "2": "6.90", "3": "7.90", "4": "8.90" }, "delivery": "true" }

v3 - Integração de Pedidos 4

Description

Esta API deve ser requisitada apenas após a integração dos pedidos com o ERP, pois essa API altera o estado dos pedidos informando que eles já foram integrados.

Headers
KeyValueDescription
token582bc29a313ad74224b1f996c9fe5a39
version3

Description

Estorna um pedido que tenha sido realizado no delivery

Headers
KeyValueDescription
token582bc29a313ad74224b1f996c9fe5a39
version3
Body
{ "id_pedido":156 }

Description

Retorna os dados do pedido identificado pelo id que é passado como parâmetro na URL.

Headers
KeyValueDescription
token582bc29a313ad74224b1f996c9fe5a39
version3

Description

Retorna os ultimos cinco pedidos que estão prontos para a integração com o ERP para a emissão de Nota Fiscal.

Headers
KeyValueDescription
token582bc29a313ad74224b1f996c9fe5a39
version3

v3 - Integração de Produtos 1

Description

Esta API faz a integração do ERP com a plataforma, cadastrando os produtos, um por vez, e relacionado-os com as lojas no qual ele estará disponível. O loja_erp refere-se ao ID da loja criado no sistema ERP do supermercado.

Headers
KeyValueDescription
token582bc29a313ad74224b1f996c9fe5a39
version3
Body
{ "codigo":"789123412344", "id_produto_erp": "8972", "nome":"Contra Filé Novilho Especial Kg", "preco_normal":"36.88", "quantidade":"49", "unidade":"kg", "status":"1", "categoria_erp":"7", "preco":[ { "loja_erp":"1", "valor":"34.50" }, { "loja_erp":"7", "valor":"35.79" } ] }