Versão 1.4.

0
 ÍNDICE

Sumário
3.1 Visão Geral...........................................................................................................3
4.1 Autenticação.........................................................................................................3
5.1 Via URL................................................................................................................4
5.1.1 ImportarProduto [Obrigatório].............................................................................4
5.1.1.1 Request URL Homologação.............................................................................4
5.1.1.2 Parâmetros da requisição...............................................................................4
5.1.1.3 Detalhamento dos campos:............................................................................4
5.1.1.4 Resposta.....................................................................................................5
5.1.2 VerificarProduto [Opcional]..................................................................................6
5.1.2.1 Request URL................................................................................................6
5.1.2.2 Parâmetros da requisição...............................................................................6
5.1.2.3 Detalhamento dos campos:............................................................................6
5.1.2.4 Resposta.....................................................................................................6
5.1.3 EnviarPedido [Obrigatório]..................................................................................7
5.1.3.1 Parâmetros de envio.....................................................................................7
5.1.3.2 Detalhamento dos campos:............................................................................9
5.1.4 FecharPedido [Obrigatório]................................................................................11
5.1.4.1 Request URL...............................................................................................11
5.1.4.2 Parâmetros da requisição.............................................................................12
5.1.4.3 Detalhamento dos campos:..........................................................................12
5.1.4.4 Resposta....................................................................................................12
5.2 Via App por Banco de Dados.................................................................................13
5.3 Via App por Arquivo TXT......................................................................................14
5.4 Via App por WSDL (WinThor)................................................................................19
5.5 Via App por Conta Azul........................................................................................20

Página 2 de 20
 1 IDENTIFICAÇÃO DO DOCUMENTO

TABELA - IDENTIFICAÇÃO
NOME DO DOCUMENTO: Manual do Usuário

OBJETIVO: O propósito do Manual do Usuário é descrever de forma sucinta e

objetiva os métodos disponíveis para a integração com o sistema
MeuCompras.

2 DEFINIÇÕES E ABREVIATURAS

TABELA - TERMOS
TERMO DESCRIÇÃO

WebService É uma solução utilizada na integração de sistemas e na

comunicação entre aplicações diferentes.
JSON (JavaScript Object Notation - Notação de Objetos JavaScript) é
uma formatação leve de troca de dados.

3 INTRODUÇÃO
A finalidade desta integração é efetuar a migração dos dados de produtos para o sistema
MeuCompras seguindo uma padronização.

3.1 Visão Geral

Neste manual será informado os métodos disponíveis e exemplos de formatação para o envio
dos dados.

4 COMO ACESSAR O SISTEMA

Os métodos disponíveis poderão ser acessados através de uma URL
(www.meucompras.com/ERP/rest/Produto/ImportarProduto) ou através do aplicativo
desenvolvido pela MeuCompras que capta as informações via banco de dados ou arquivos em
TXT que seguem os padrões abaixo, como pré requisito deverá existir um cadastro ativo do
perfil distribuidor dentro do sistema MeuCompras.

Durante o processo de desenvolvimento e homologação os endereços de acesso dos métodos

da API do MeuCompras serão alterados para piloto.meucompras.com. Após a homologação o
endereço final será www.meucompras.com.

Página 3 de 20
4.1 Autenticação
O método de envio direto à URL apresentada neste documento utiliza o padrão REST com
Basic Authentication. A autenticação deverá ser passada com o Username sendo igual à Chave
de Acesso e o Password deve ser deixado em branco.
A utilização do aplicativo requer o preenchimento correto do arquivo config.dat com a chave
de acesso.

5 MÉTODOS DO SISTEMA

5.1 Via URL

5.1.1 ImportarProduto [Obrigatório]
HTTPMethod: POST
Request Format: JSON
Descrição:Método para enviar uma listagem de produtos à serem disponibilizados no sistema
MeuCompras. Os produtos a serem importados/atualizados devem ser enviados todos juntos
na mesma lista. Quando um produto já foi importado anteriormente e não é enviado em uma
nova lista atualizada, terá seu estoque zerado e não será vendido na área do cliente.

5.1.1.1 Request URL Homologação

https://www.meucompras.com/ERP/rest/Produto/ImportarProduto

5.1.1.2 Parâmetros da requisição

 ProdutoJson
Tipo do parâmetro: body
Formato/Exemplo:
[
{
"Descricao":"Descrição do Produto 1",
"CodigoItemReferencia":"0012041",
"CodigoBarras":"1234567890",
"Valor":1000.50,
"ValorPromocional":1000.00,
"ValorDistribuidor":0,
"QuantidadeMinima":50,
"QuantidadeEstoque":1000,
"Multiplicidade":1,
"PrazoEntrega":15,
"UnidadeMedidaVenda":"DSP"

},
{
"Descricao":"Descrição do Produto 2",
"CodigoItemReferencia":"0023556",
"CodigoBarras":"0987654321",
"Valor":1500.50,
"ValorPromocional":1200.00,
"ValorDistribuidor":0,
"QuantidadeMinima":10,
"QuantidadeEstoque":1000,
"Multiplicidade":1,
"PrazoEntrega":20
"UnidadeMedidaVenda":"CX"
Página 4 de 20
 } ]

5.1.1.3 Detalhamento dos campos:

Campo Tipo Limite Obrigatório Descrição

Descricao String 255 S Descrição do produto
CodigoItemReferenci String 20 S Código referência do
a produto no ERP do
Distribuidor.
CodigoBarras String 13 A 14 S Código de barras do
produto
Valor Decimal* (37,2) S Valor de Venda do
produto
ValorPromocional Decimal* (37,2) S Valor Promocional de
venda, este deve ser
menor que o valor do
produto, ou caso
inexistente “0”.
ValorDistribuidor Decimal* (37,2) S Valor Distribuidor antes
de impostos, usado para
referência interna do
distribuidor, não é
mostrado ao usuário
final.
QuantidadeMinima Inteiro - S Quantidade mínima para
venda
QuantidadeEstoque Inteiro - S Quantidade disponível em
estoque
PrazoEntrega Inteiro - S Prazo de entrega do
produto em dias
Multiplicidade Inteiro - S Múltiplo de compra
UnidadeMedidaVenda String 5 S Descrição da unidade de
venda DSP (Display), UM
(Unidade), CX (caixa),
FRD (fardo) e assim por
diante.
*O separador decimal deverá ser ponto (“.”) ao invés de vírgula (“,”).

5.1.1.4 Resposta
HTTP Status Code: 200 Content-
Type: application/json
Formato/Exemplo:
[
{
"Descricao":"Descrição do Produto 1",
"CodigoBarras":"01234567890",

Página 5 de 20
 "Valor":1000.50,
"ValorPromocional":1000.00,
"ValorDistribuidor":0,
"QuantidadeMinima":50,
"QuantidadeEstoque":1000,
"Multiplicidade":1,
"PrazoEntrega":15,
"StatusProduto":{
"Status":"Concluído",
"Mensagem":"Produto atualizado com sucesso!",
"ConsultadoEm":"2016-09-06T12:46:24Z"
}
},
{
"Descricao":"Descrição do Produto 2",
"CodigoBarras":"09876543210",
"Valor":1500.50,
"ValorPromocional":1200.00,
"ValorDistribuidor":0,
"QuantidadeMinima":10,
"QuantidadeEstoque":1000,
"Multiplicidade":1,
"PrazoEntrega":20,
"StatusProduto":{
"Status":"Concluído",
"Mensagem":"Produto cadastrado com sucesso!",
"ConsultadoEm":"2016-09-06T12:46:24Z"
}
}
]

5.1.2 VerificarProduto [Opcional]

HTTPMethod: POST
Request Format: JSON
Descrição: Método para verificar o status do produto (Pendente, Aprovado, Reprovado).

5.1.2.1 Request URL

https://www.meucompras.com/ERP/rest/Produto/VerificarProduto

5.1.2.2 Parâmetros da requisição

 CodigoBarras
Tipo do parâmetro: body
Formato/Exemplo:
["1234567890", “0123456789”]

5.1.2.3 Detalhamento dos campos:

Campo Tipo Limite Obrigatóri Descrição

o
Página 6 de 20
 Código de Barras STRING 13 A 14 S APENAS NÚMEROS.
Código de barras do
Produto.
5.1.2.4 Resposta
HTTP Status Code: 200 Content-
Type: application/json
Formato/Exemplo:
[
{
"Status":"Pendente",
"Mensagem":"",
"ConsultadoEm":"2016-08-16T11:15:29"
},
{
"Status":"Erro",
"Mensagem":"Código de barras não foi encontrado.",
"ConsultadoEm":"2016-08-16T11:15:29"
}
]

5.1.3 EnviarPedido [Obrigatório]

HTTPMethod: POST
Request Format: JSON
Descrição: Neste método o distribuidor receberá o pedido do sistema MeuCompras a partir de
um documento JSON. Verificar a possibilidade de gravar o número do pedido do MeuCompras
para posterior consulta de XML.

5.1.3.1 Request URL

https://www.meucompras.com/ERP/rest/BuscarPedido/EnviarERP

5.1.3.2 Parâmetros de envio

 Pedido
Tipo do parâmetro: body

{
"NumeroPedido":"123465",
"DataEmissao":"2016-06-03 12:55:55",
"CodigoPagamento":"50,
“TotalParcelas”:5,
"ValorBruto":520.60,
“InformacoesPagamento”:[{
“ValorTotal”:”R$ 45,60”,
“NumeroParcela”:5,
Página 7 de 20
 “DataRetorno”:”2016-12-30”
}]
"Distribuidor":
{
"CNPJ":"02818811000120",
"RazaoSocial":"Distribuidor 1",
"Pagto":
{
"Banco":"Itau",
"Agencia":"1234",
"Conta":"1234",
"TipoConta":"Corrente PJ",
"ValorLiquido":516.60
}
},
"Destinatario":
{
"CNPJ":"02818811000120",
"RazaoSocial":"teste sa",
"NomeFantasia":"testando",
"IE":"123456",
"Telefone":"4130151515",
"Email":"joao@teste.com.br",
"CNAE":
{
"Primario":"0111301",
"Secundario":
[
"0111302",
"0111303"
]
},
"EnderecoEntrega":
{
"Logradouro":"Rua João Negrão",
"Numero":"123",
"Complemento":"bloco A",
"CEP":"82820150",
"Bairro":"Centro",
"CodBairro":8860,
"Cidade":"Curitiba",
"CodCidade":6015,
"UF":"PR",
"Pais":"Brasil"
}
Página 8 de 20
 },
"Pedido":
[

"Descricao":"Maquina Lavar",
"CodigoInterno":"0012041"
"CodigoBarras":"1321321321321"
,
"Quantidade":5,
"ValorUnitario":50.55,
"Desconto":0,
"ValorTotal":260.60,
"Observacao":"teste"
},

"Descricao":"Maquina Lavar 2",

"CodigoInterno":"0023556"
"CodigoBarras":"13213213213212
",
"Quantidade":5,
"ValorUnitario":50.55,
"Desconto":0,
"ValorTotal":260.60,
"Observacao":"teste"
}
]
}

5.1.3.3 Detalhamento dos campos:

Campo Tipo Limite Obrigatório Descrição

Numeropedido Inteiro - S Número do pedido
gerado pelo sistema
MeuCompras
DataEmissao DateTime YYYY- S Data de Emissão do
MMDD pedido
HH:MM:SS
CodigoPagamento Inteiro - S Código do pagamento
do pedido. Códigos
descritos na tabela
abaixo.
TotalParcelas Inteiro - S Informação referente
aos números de

parcelas em que o
pedido foi pago.
Página 9 de 20
InformacoesPagamento Objeto - S Informação sobre o
parcelamento do
pedido.
- DataRetorno Date YYYY- S Data retorno da
MMDD parcela.
- NumeroParcela Inteiro - S Número indicativo
sobre o número da
parcela descrito.
- ValorTotal Decimal 18,2 S Valor indicativo sobre o
valor total da parcela
descrita.
ValorBruto Decimal 18,2 S Valor bruto do pedido
Distribuidor Objeto - S Dados do Distribuidor
- CNPJ String 14 S CNPJ do Distribuidor
- RazaoSocial String 255 S Razão Social do
Distribuidor
- Pagto Objeto - S Dados referente a
conta bancário onde o
distribuidor será
ressarcido
-- Banco String 100 S Descrição do Banco
-- Agencia String 50 S Agência
-- Conta String 50 S Conta Corrente
-- TipoConta String 100 S Tipo de Conta:
{Corrente PJ, Corrente
PF, Poupança PJ,
Poupança PF}
-- ValorLiquido Decimal 18,2 S Valor liquido a ser
transferido para a
conta.
Destinatario Objeto - S Dados do Comprador
-CNPJ String 14 S CNPJ do comprador
- RazaoSocial String 255 S Razão Social
- NomeFantasia String 255 N Nome Fantasia
- IE String 255 N Inscrição Estadual
- Telefone String 255 S Telefone
- Email String 255 S Email
- CNAE Objeto - S Cnae
-- Primario String 7 S Código do CNAE
principal
-- Secundario String 7 N Lista do código do Cnae
secundário
- EnderecoEntrega Objeto - S Endereço de Entrega
-- Logradouro String 255 S Logradouro
Página 10 de 20
-- Numero String 50 N Número
-- Complemento String 100 N Complemento
-- CEP String 8 S CEP
-- Bairro String 100 S Bairro
-- CodBairro Inteiro - S Código dos correios
para o Bairro
-- Cidade String 255 S Cidade
-- CodCidade Inteiro - S Código dos correios
para a Cidade
-- UF String 2 S UF
-- Pais String 255 S País
Pedido Objeto - S Lista de dados
referente ao pedido
- Descricao String 255 S Descrição do produto
- CodigoInterno String 20 S Código do produto no
Distribuidor.
- CodigoBarras String 255 S Código de Barras
- Quantidade Inteiro - S Quantidade do produto
- ValorUnitario Decimal 18,2 S Valor unitário do
produto
- Desconto Decimal 18,2 N Desconto para o
produto
- ValorTotal Decimal 18,2 S Valor Total do Produto
- Observacao String 255 N Observação referente
ao produto

Códigos de Pagamento:
Código Descrição
50 Pagamento por boleto bancário à vista.
1 Pagamento por cartão de crédito à vista.
2 Pagamento por cartão de crédito parcelado.

5.1.4 FecharPedido [Obrigatório]

HTTPMethod: POST
Request Format: JSON
Descrição: Neste método o distribuidor informará ao MeuCompras que o pedido está em
processo de envio. Será enviado o número do pedido MeuCompras que foi gravado quando o
pedido foi enviado posteriormente.

5.1.4.1 Request URL

https://www.meucompras.com/ERP/rest/Pedido/FecharPedido
Página 11 de 20
 5.1.4.2 Parâmetros da requisição
• NumeroPedido
• NumeroPedidoERP
• NFe
Tipo do parâmetro: body
Formato/Exemplo:
{
"NumeroPedido": 83,
"NumeroPedidoERP": 112,
"NFe": "<?xml version='1.0' encoding='UTF-8'?><nfeProc>…</nfeProc>"
}

5.1.4.3 Detalhamento dos campos:

Campo Tipo Limite Obrigatório Descrição

Numeropedido Inteiro - S Número do pedido gerado
pelo sistema do
MeuCompras
NumeropedidoERP Inteiro - S Número do pedido gerado
pelo ERP do distribuidor
Nfe String - S Nfe gerado pelo sistema
do distribuidor
5.1.4.4 Resposta
HTTP Status Code: 200 Content-
Type: application/json
Formato/Exemplo:
{
"Mensagem":""Comprador informado e pedido atualizado com sucesso!"",
"Status":"Concluído",
"ConsultadoEm":"2016-08-17T18:48:41Z"
}

5.2 Via App por Banco de Dados FlexMobile (PostgreSQL)

O app previamente fornecido pelo MeuCompras deverá ser instalado em computador Windows
que tenha acesso ao computador onde o ERP está sendo executado e com acesso direto ao
banco de dados.

Para que este procedimento funcione é necessário a configuração do arquivo config.dat com
as seguintes entradas:

Página 12 de 20
[base_dados]
ip = 192.168.1.2
porta = 5432
usuario = selfsupply
senha = selfsupply
database = nomedabasededados
distribuidor = nomedodistribuidor

Campo Descrição
ip Endereço IP da base de dados onde o ERP
está instalado.
porta Porta de conexão da base de dados.
usuario Nome de login do usuário de conexão ao
banco de dados.
senha Senha de conexão ao banco de dados
database Nome da base de dados.
distribuidor Nome do distribuidor.

Estes dados podem ser fornecidos pela empresa que desenvolve o ERP.

Com estas configurações o app coleta as informações dos produtos e envia diretamente para a
base de dados do MeuCompras. Para os pedidos realizados o app coleta as informações e
cadastra os clientes e pedidos na base de dados do distribuidor. Após o faturamento do pedido
e geração da DANFE, o app coleta os dados do XML gerado e envia para a base de dados do
MeuCompras, encerrando o ciclo do pedido.

O XML gerado precisará também ser enviado por email para xml@meucompras.com.

Para que o pedido seja importado corretamente é necessário a configuração dos seguintes
parâmetros no arquivo config.dat:

[erp]
codcliente = 900000
filial = 1
tabela = 80
vendedor = 100
formapgto = 130
condicaopgto = 1
operacao = 501

Campo Descrição
codcliente Código inicial de cadastro automático dos
clientes enviados pelo MeuCompras no ERP.
Neste caso os clientes que estiverem com
cadastro acima de 900000 são identificados
como sendo enviados pelo MeuCompras.
filial Código da filial do distribuidor que será
utilizado no cadastro dos pedidos.
Página 13 de 20
tabela Código da tabela de preços utilizado para
cadastro do pedido.
vendedor Código do vendedor do pedido. Geralmente é
cadastrado um vendedor com o nome
MeuCompras no ERP para identificar pedidos
realizados pelo sistema.
formapgto Código da forma de pagamento.
condicaopgto Código da condição de pagamento.
operacao Código da operação realizada.

5.3 Via App por Arquivo TXT

O app previamente fornecido pelo MeuCompras deverá ser instalado em computador Windows
que tenha acesso às pastas configuradas para verificação dos arquivos a serem
importados/exportados.

Para que este procedimento funcione é necessário a configuração do arquivo config.dat com
as seguintes entradas:

[paths]
path_produtos = d:\\temp\\produtos\\
path_pedidos = d:\\temp\\pedidos\\
path_xml = d:\\temp\\xml\\

Campo Descrição
path_produtos Caminho no computador Windows onde os
arquivos TXT de produtos estarão disponíveis
para importação na base de dados do
MeuCompras.
path_pedidos Caminho no computador Windows onde os
arquivos TXT de pedidos estarão disponíveis
para importação na base de dados do
distribuidor.
path_xml Caminho no computador Windows onde os
arquivos de XML da nota fiscal estarão
disponíveis para importação na base de
dados do MeuCompras.

Os arquivos XML precisarão manter a nomenclatura com o número do pedido MeuCompras,

exemplo: Pedido MeuCompras número 1250 deve ter um arquivo XML com o nome 1250.xml.

O app de integração pode se comunicar com servidor FTP para busca e envio dos arquivos TXT
para outro servidor onde o ERP poderá se comunicar. O ERP exportará e importará nas pastas
do servidor FTP e o app buscará no mesmo servidor. Se o distribuidor utilizar servidor FTP
para comunicação com o servidor ERP, o arquivo config.dat deverá ser configurado nas
seguintes linhas:

Página 14 de 20
[FTP]
usaFTP = false
passvFTP = true
host =
user =
senha =
pathftp = /public_html/temp/

Campo Descrição
usaFTP Define se o app utilizará um servidor FTP
para troca de arquivos entre o computador
onde o app estará e o servidor onde o ERP
buscará os dados.
passvFTP Define se o servidor FTP utiliza modo passivo
ou ativo na comunicação.
host Endereço IP do servidor FTP.
user Usuário de autenticação do servidor FTP.
senha Senha de autenticação do servidor FTP.
pathftp Pasta raiz onde estarão 3 subpastas para
integração dos produtos, pedidos e XML.
Dentro da pasta no servidor FTP definida
nesta variável deverão existir as seguintes
subpastas:
/produtos/
/pedidos/
/xml/

O arquivo TXT dos produtos deve obedecer ao seguinte layout, sendo um produto por linha
com separador :|: (dois pontos, traço vertical, dois pontos):

DESCRICAO:|:CODIGOINTERNO:|:CODIGODEBARRAS:|:VALOR:|:VALORPROMOCIONAL:|:QUANTIDADEMI
NIMA:|:QUANTIDADEESTOQUE:|:MULTIPLICIDADE:|:PRAZOENTREGA:|:UNIDADEMEDIDA:|:

Campo Tipo Limite Obrigatório Descrição

Descricao String 255 S Descrição do produto
CodigoInterno String 20 S Código referência do
produto no ERP do
Distribuidor.
CodigoBarras String 13 A 14 S Código de barras do
produto
Valor Decimal* (37,2) S Valor de Venda do produto
ValorPromocional Decimal* (37,2) S Valor Promocional de
venda, este deve ser
menor que o valor do
produto, ou caso
inexistente “0”.

Página 15 de 20
QuantidadeMinima Inteiro - S Quantidade mínima para
venda
QuantidadeEstoque Inteiro - S Quantidade disponível em
estoque
PrazoEntrega Inteiro - S Prazo de entrega do
produto em dias
Multiplicidade Inteiro - S Múltiplo de compra
Unidadedemedida String 5 S Descrição da unidade de
venda DSP (Display), UM
(Unidade), CX (caixa), FRD
(fardo) e assim por diante.

A primeira linha deverá conter o cabeçalho com os títulos dos campos conforme acima.

O arquivo TXT de pedidos será gerado pelo MeuCompras e seguirá o seguinte layout, sendo
uma linha para os dados do pedido:

NUMERO DO PEDIDO ; DATA DE EMISSAO ; CODIGO DE PAGAMENTO ; VALOR BRUTO ;

QUANTIDADE DE PRODUTOS (LINHAS)

Campo Tipo Limite Obrigatório Descrição

Numeropedido Inteiro - S Número do pedido
gerado pelo sistema do
MeuCompras
DataEmissao DateTime YYYY- S Data de Emissão do
MMDD pedido
HH:MM:SS
CodigoPagamento Inteiro - S Código do pagamento
do pedido. Códigos
descritos na tabela
abaixo.
ValorBruto Decimal 18,2 S Valor bruto do pedido
Quantidade de produtos Inteiro 4 S Quantidade de itens
unitários do pedido
(para determinar
quantas linhas de
produtos existem no
arquivo)

A segunda linha do arquivo mostra os dados do distribuidor:

CNPJ ; RAZAO SOCIAL ; NOME DO BANCO ; AGENCIA ; NUMERO DA CONTA ; TIPO DE CONTA
; VALOR LIQUIDO DO PEDIDO DO DISTRIBUIDOR ; TOKEN ; URL DO WEBSERVICE ; CODIGO
DO DISTRIBUIDOR NA SELFSUPPLY

Campo Tipo Limite Obrigatório Descrição

Página 16 de 20
- CNPJ String 14 S CNPJ do Distribuidor
- RazaoSocial String 255 S Razão Social do
Distribuidor
- Banco String 100 S Descrição do Banco
- Agencia String 50 S Agência
- Conta String 50 S Conta Corrente
- TipoConta String 100 S Tipo de Conta:
{Corrente PJ, Corrente
PF, Poupança PJ,
Poupança PF}
- ValorLiquido Decimal 18,2 S Valor liquido a ser
transferido para a
conta.
- Token Informação de uso do
MeuCompras

- URL do Webservice Informação de uso do

MeuCompras

- Código do distribuidor Informação de uso do

MeuCompras

A terceira linha mostra os dados do cliente que efetuou a compra:

CNPJ ; RAZAO SOCIAL ; NOME FANTASIA ; INSCRICAO ESTADUAL ; TELEFONE ; EMAIL ;

CNAE PRIMARIO ; LOGRADOURO ; NUMERO ; CEP ; BAIRRO ; CODIGO DO BAIRRO ;
CIDADE ; CODIGO DA CIDADE ; UF ; PAIS

Campo Tipo Limite Obrigatório Descrição

-CNPJ String 14 S CNPJ do comprador
- RazaoSocial String 255 S Razão Social
- NomeFantasia String 255 N Nome Fantasia
- IE String 255 N Inscrição Estadual
- Telefone String 255 S Telefone
- Email String 255 S Email
-- Primario String 7 S Código do CNAE
principal
-- Logradouro String 255 S Logradouro
-- Numero String 50 N Número
-- Complemento String 100 N Complemento
-- CEP String 8 S CEP

Página 17 de 20
-- Bairro String 100 S Bairro
-- CodBairro Inteiro - S Código dos correios
para o Bairro
-- Cidade String 255 S Cidade
-- CodCidade Inteiro - S Código dos correios
para a Cidade
-- UF String 2 S UF
-- Pais String 255 S País

Da quarta linha em diante os itens do pedido são apresentados pelo número total de itens
cadastrados na linha 1:

DESCRICAO ; CODIGO DE BARRAS ; QUANTIDADE ; VALOR UNITARIO ; VALOR TOTAL DO

ITEM

Campo Tipo Limite Obrigatório Descrição

- Descricao String 255 S Descrição do produto
CodigoInterno String 20 S Código referência do
produto no ERP do
Distribuidor.
- CodigoBarras String 255 S Código de Barras
- Quantidade Inteiro - S Quantidade do produto
- ValorUnitario Decimal 18,2 S Valor unitário do
produto
- ValorTotal Decimal 18,2 S Valor Total do Produto

5.4 Via App por WSDL (WinThor)

O app previamente fornecido pelo MeuCompras deverá ser instalado em computador Windows
que tenha acesso ao computador onde o ERP está sendo executado e com acesso direto
webservice WSDL.

Para que este procedimento funcione é necessário a configuração do arquivo config.dat com
as seguintes entradas:

[wsdl]
endereco = 192.168.0.15
filial = 1
pais = 1058
excluir_departamentos = 1,2,3,4,...
excluir_marcas = 1,2,3,4,...
excluir_categorias = 1,2,3,4,...
excluir_subcategorias = 1,2,3,4,...
Página 18 de 20
excluir_secoes = 1,2,3,4,...
excluir_produtos = 1,2,3,4,...

Campo Descrição
endereco Endereço IP de acesso ao WSDL (geralmente
um IP interno dentro da rede da empresa).
filial Código da filial no WinThor que utilizará a
integração.
pais Código do país no WinThor.
excluir_departamerntos Código dos departamentos que serão
excluídos da integração (se não tiver
nenhum, pode ficar em branco).
excluir_marcas Código das marcas que serão excluídas da
integração (se não tiver nenhuma, pode ficar
em branco).
excluir_categorias Código das categorias que serão excluídas da
integração (se não tiver nenhuma, pode ficar
em branco).
excluir_subcategorias Código das subcategorias que serão excluídas
da integração (se não tiver nenhuma, pode
ficar em branco).

Com estas configurações o app coleta as informações dos produtos e envia diretamente para a
base de dados do MeuCompras. Para os pedidos realizados o app coleta as informações e
cadastra os clientes e pedidos na base de dados do distribuidor. Após o faturamento do pedido
e geração da DANFE, o app coleta os dados do XML gerado e envia para a base de dados do
MeuCompras, encerrando o ciclo do pedido.

5.5 Via App por Conta Azul

O app previamente fornecido pelo MeuCompras deverá ser instalado em computador Windows
que tenha acesso à internet para consulta direto na API Conta Azul. O app solicitará
autenticação do usuário da Conta Azul para poder gerar um token de acesso.

Para que este procedimento funcione é necessário a configuração do arquivo config.dat com
as seguintes entradas:

[contaazul]
redirecturi = https://www.meucompras.com/ERP/rest/ContaAzul2/Oauth
produtosid = f2ac12b7-28ba-4011-a7b0-1fc639cf9c10,0479d4a0-f1f0-4c42-bd2a-
b4f237954e7e,9116ad98-04dd-416c-ba95-7e9d6882c859

[valores]
f2ac12b7-28ba-4011-a7b0-1fc639cf9c10 = 15
0479d4a0-f1f0-4c42-bd2a-b4f237954e7e = 30
9116ad98-04dd-416c-ba95-7e9d6882c859 = 9

Página 19 de 20
Campo Descrição
redirecturi Endereço de redirecionamento para
autenticação da Conta Azul.
produtosid Lista de Ids de produtos que serão integrados
com o MeuCompras, separados por vírgula.
valores Cada ID adicionado no campo produtosid
deverá ser adicionado para definir o valor de
venda do produto.

Com estas configurações o app coleta as informações dos produtos e envia diretamente para a
base de dados do MeuCompras. Para os pedidos realizados o app coleta as informações e
cadastra os clientes e pedidos na base de dados do distribuidor. Após o faturamento do pedido
e geração da DANFE, o app coleta os dados do XML gerado e envia para a base de dados do
MeuCompras, encerrando o ciclo do pedido.

6 INFORMAÇÕES ADICIONAIS
A chave de acesso será gerada na aprovação do cadastro, esta chave poderá ser gerenciada
acessando o sistema MeuCompras.

Página 20 de 20