Informações E-commerce

Para enviar os campos complementares de e-commerce de um pedido já integrado ao WMS, será necessário chamar o método informacoesEcommerce. A chamada desse serviço procede da seguinte forma:

REST

URL

http://ip_servidor:9090/cyberweb/api/processo/informacoesEcommerce

Headers

chave : "epa42b92-d78b-7g88-p538-279qw562h54m"

token : "9166226b-6afd-4298-b6cc-d7dc3aef8f48"

Content-Type : "application/x-www-form-urlencoded"

Body

informacoesEcommerce : "JSON InformacoesEcommerce"

JSON InformacoesEcommerce

{
    "erpId": "erp_id",
    "noPedido": 1254,
    "empresa": "01",
    "razaoSocial": "Empresa X LTDA",
    "cnpjCpf": "30.444.718/0001-38",
    "ie": "110.042.490.114",
    "enderecoDestinatario": "Rua Y, 100 - São Paulo, SP - 01000-000",
    "tributosTotais": "R$ 10,00",
    "dadosAdicionais": "Informações complementares do pedido",
    "nomeContato": "Fulano de Tal",
    "telefoneContato": "11999998888",
    "etiquetaTransporte": "JVBERi0xLjQKJeLj... (PDF em Base64)"
}

Response

{
    "CyberWeb": "Informações de e-commerce salvas com sucesso"
}

Mensagens de retorno do método informacoesEcommerce

• Informações de e-commerce salvas com sucesso; (HTTP 200)
• !Informe erpId ou noPedido para identificar o pedido; (HTTP 400)
• !empresa é obrigatória quando informado erpId; (HTTP 400)
• !Não há configuração de depósito para a empresa: XXXXX; (HTTP 400)
• !Pedido não encontrado: erpId=XXXXX (ou noPedido=XXXXX); (HTTP 400)
• !Etiqueta de transporte excede o tamanho máximo de 20 MB; (HTTP 400)
• !Erro ao executar informacoesEcommerce! (HTTP 500)

Dicionário de dados - InformacoesEcommerce

Nome	Tipo de Dado	Descrição	Obrigatório	Padrão
erpId	varchar(30)	Chave que identifica o pedido no ERP (mesma usada em integrarPedido). Alternativa ao noPedido.
noPedido	number(10)	Número do pedido no WMS. Usado para localizar o pedido quando o erpId não é informado.
empresa	varchar(20)	Código da empresa (resolve o depósito via Sincronizador). Obrigatória quando o pedido é identificado por erpId; dispensável quando se usa noPedido.	Condicional
razaoSocial	varchar(100)	Razão social do cliente.
cnpjCpf	varchar(18)	CNPJ/CPF do cliente.
ie	varchar(15)	Inscrição Estadual do cliente.
enderecoDestinatario	varchar(150)	Endereço completo do destinatário.
tributosTotais	varchar(100)	Valor total de tributos (ex: "R$ 10,00").
dadosAdicionais	varchar(1000)	Informações/observações complementares do pedido (texto livre).
nomeContato	varchar(100)	Nome do contato do cliente.
telefoneContato	varchar(20)	Telefone do contato.
etiquetaTransporte	text (Base64)	PDF da etiqueta de transporte codificado em Base64. Tamanho máximo: 20 MB.

Atenção

Informe erpId ou noPedido para identificar o pedido — ao menos um dos dois é obrigatório. Quando ambos forem enviados, o erpId tem prioridade.

O campo empresa só é obrigatório quando o pedido é identificado pelo erpId (é a empresa que resolve o depósito onde o erpId é único). Ao identificar o pedido pelo noPedido, o empresa é dispensável e o depósito é herdado do próprio pedido.

O pedido informado já deve existir no WMS (integrado previamente via integrarPedido). Caso contrário a API retorna "Pedido não encontrado". O reenvio para o mesmo pedido atualiza os dados já salvos (upsert).