Integração de carga
Para a integração de carga, será necessário chamar o método integrarCarga. A chamada desse serviço procede da seguinte forma:
URL
http://ip_servidor:9090/cyberweb/api/processo/integrarCarga
Headers
chave : "epa42b92-d78b-7g88-p538-279qw562h54m"
token : "9166226b-6afd-4298-b6cc-d7dc3aef8f48"
Content-Type : "application/x-www-form-urlencoded"
Body
carga : "JSON Carga"
JSON Carga
{
"operacao": "INSERT",
"erpId": "id_erp",
"numero": 23,
"empresa": "01",
"data": "Mar 13, 2020 12:00:00 AM",
"noRota": 9,
"descRota": "Rota 9",
"noDoca": 3,
"expedicao": false,
"faturado": true,
"prioridade": 1000,
"valor": 22.515,
"veiculoErpId": "TruckMP1254",
"transportadoraErpId": "981100004",
"nomeTransportadora": "Teste Transportadora",
"pedidosCarga": [
{
"operacao": "INSERT",
"erpId": "id_erp",
"empresa": "01",
"data": "Mar 13, 2020 12:00:00 AM",
"noPedido": 0,
"clienteErpId": "06884301",
"nomeCliente": "TESTE CLIENTE CYBERLOG",
"noCliente": 0,
"faturado": false,
"notaFiscal": 0,
"serie": 1,
"clienteRetira": false,
"observacao": "pedido normal",
"prioridade": 50,
"avaria": false,
"dataEntrega": "Mar 13, 2020 12:00:00 AM",
"docasConsolidacao": "3",
"loteInformado": false,
"documento": "pedido 1254",
"noRota": 9,
"descRota": "Rota 9",
"equipe": "Equipe Pedido Normal",
"tipoPedido": "Normal",
"volumes": 0,
"representante": "Motorista pedido",
"vinculo": "pedido x,pedido y,pedido z",
"itensPedido": [
{
"codigoReduzido": "WMS_CYBERLOG_001",
"erpId": "erp_id",
"operacao": "INSERT",
"quantidade": 5,
"qtdAvaria": 0,
"sequenciaERP": "id_erp",
"noLayout": 0,
"loteItensPedido": [
{
"quantidade": 5,
"qtdAvaria": 0,
"nolote": "L1.1",
"validadeLote": "Feb 28, 2021 12:00:00 AM",
"dataFabricacao": "Mar 28, 2019 12:00:00 AM"
}
],
"grades": [
{
"codigo": "grade1",
"quantidade": 3,
"tipoEstrutura": "estrutura1"
},
{
"codigo": "grade2",
"quantidade": 2
}
]
},
{
"codigoReduzido": "WMS_CYBERLOG_002",
"erpId": "erp_id2",
"operacao": "INSERT",
"quantidade": 10,
"qtdAvaria": 0,
"sequenciaERP": "id_erp",
"noLayout": 0,
"loteItensPedido": [],
"grades": [
{
"codigo": "grade1",
"quantidade": 10,
"tipoEstrutura": "estrutura1"
}
]
},
{
"operacao": "INSERT",
"erpId": "id_erp",
"empresa": "01",
"data": "Mar 13, 2020 12:00:00 AM",
"noPedido": 0,
"clienteErpId": "06884301",
"nomeCliente": "TESTE CLIENTE CYBERLOG",
"noCliente": 0,
"faturado": false,
"notaFiscal": 0,
"serie": 1,
"clienteRetira": false,
"observacao": "pedido normal",
"prioridade": 50,
"avaria": false,
"dataEntrega": "Mar 13, 2020 12:00:00 AM",
"docasConsolidacao": "3",
"loteInformado": false,
"documento": "pedido 1254",
"noRota": 9,
"descRota": "Rota 9",
"equipe": "Equipe Pedido Normal",
"tipoPedido": "Normal",
"volumes": 0,
"representante": "Motorista pedido",
"vinculo": "pedido x,pedido y,pedido z",
"itensPedido": [
{
"codigoReduzido": "WMS_CYBERLOG_001",
"erpId": "erp_id",
"operacao": "INSERT",
"quantidade": 5,
"qtdAvaria": 0,
"sequenciaERP": "id_erp",
"noLayout": 0,
"loteItensPedido": [
{
"quantidade": 5,
"qtdAvaria": 0,
"nolote": "L1.1",
"validadeLote": "Feb 28, 2021 12:00:00 AM",
"dataFabricacao": "Mar 28, 2019 12:00:00 AM"
}
]
},
{
"codigoReduzido": "WMS_CYBERLOG_002",
"erpId": "erp_id2",
"operacao": "INSERT",
"quantidade": 10,
"qtdAvaria": 0,
"sequenciaERP": "id_erp",
"noLayout": 0,
"loteItensPedido": {}
}
]
}
]
}
]
}
URL
http://ip_servidor:9090/SyncWS/SyncWS/integrarCarga
Headers
Content-Type : text/xml
Body - (XML) Carga
JSON Carga
{
"operacao": "INSERT",
"erpId": "id_erp",
"numero": 23,
"empresa": "01",
"data": "Mar 13, 2020 12:00:00 AM",
"noRota": 9,
"descRota": "Rota 9",
"noDoca": 3,
"expedicao": false,
"faturado": true,
"prioridade": 1000,
"valor": 22.515,
"veiculoErpId": "TruckMP1254",
"transportadoraErpId": "981100004",
"nomeTransportadora": "Teste Transportadora",
"pedidosCarga": [
{
"operacao": "INSERT",
"erpId": "id_erp",
"empresa": "01",
"data": "Mar 13, 2020 12:00:00 AM",
"noPedido": 0,
"clienteErpId": "06884301",
"nomeCliente": "TESTE CLIENTE CYBERLOG",
"noCliente": 0,
"faturado": false,
"notaFiscal": 0,
"serie": 1,
"clienteRetira": false,
"observacao": "pedido normal",
"prioridade": 50,
"avaria": false,
"dataEntrega": "Mar 13, 2020 12:00:00 AM",
"docasConsolidacao": "3",
"loteInformado": false,
"documento": "pedido 1254",
"noRota": 9,
"descRota": "Rota 9",
"equipe": "Equipe Pedido Normal",
"tipoPedido": "Normal",
"volumes": 0,
"representante": "Motorista pedido",
"vinculo": "pedido x,pedido y,pedido z",
"itensPedido": [
{
"codigoReduzido": "WMS_CYBERLOG_001",
"erpId": "erp_id",
"operacao": "INSERT",
"quantidade": 5,
"qtdAvaria": 0,
"sequenciaERP":1,
"noLayout": 0,
"loteItensPedido": [
{
"quantidade": 5,
"qtdAvaria": 0,
"nolote": "L1.1",
"validadeLote": "Fev 28, 2021 12:00:00 AM",
"dataFabricacao": "Mar 28, 2019 12:00:00 AM"
}
],
"grades": [
{
"codigo": "grade1",
"quantidade": 3,
"tipoEstrutura": "estrutura1"
},
{
"codigo": "grade2",
"quantidade": 2
}
]
},
{
"codigoReduzido": "WMS_CYBERLOG_002",
"erpId": "erp_id2",
"operacao": "INSERT",
"quantidade": 10,
"qtdAvaria": 0,
"sequenciaERP":2,
"noLayout": 0,
"loteItensPedido": [],
"grades": [
{
"codigo": "grade1",
"quantidade": 10,
"tipoEstrutura": "estrutura1"
}
]
},
{
"operacao": "INSERT",
"erpId": "id_erp",
"empresa": "01",
"data": "Mar 13, 2020 12:00:00 AM",
"noPedido": 0,
"clienteErpId": "06884301",
"nomeCliente": "TESTE CLIENTE CYBERLOG",
"noCliente": 0,
"faturado": false,
"notaFiscal": 0,
"serie": 1,
"clienteRetira": false,
"observacao": "pedido normal",
"prioridade": 50,
"avaria": false,
"dataEntrega": "Mar 13, 2020 12:00:00 AM",
"docasConsolidacao": "3",
"loteInformado": false,
"documento": "pedido 1254",
"noRota": 9,
"descRota": "Rota 9",
"equipe": "Equipe Pedido Normal",
"tipoPedido": "Normal",
"volumes": 0,
"representante": "Motorista pedido",
"vinculo": "pedido x,pedido y,pedido z",
"itensPedido": [
{
"codigoReduzido": "WMS_CYBERLOG_001",
"erpId": "erp_id",
"operacao": "INSERT",
"quantidade": 5,
"qtdAvaria": 0,
"sequenciaERP":3,
"noLayout": 0,
"loteItensPedido": [
{
"quantidade": 5,
"qtdAvaria": 0,
"nolote": "L1.1",
"validadeLote": "Fev 28, 2021 12:00:00 AM",
"dataFabricacao": "Mar 28, 2019 12:00:00 AM"
}
]
},
{
"codigoReduzido": "WMS_CYBERLOG_002",
"erpId": "erp_id2",
"operacao": "INSERT",
"quantidade": 10,
"qtdAvaria": 0,
"sequenciaERP":4,
"noLayout": 0,
"loteItensPedido": {}
}
]
}
]
}
]
}
RC's do método integrarCarga
- 1 - Inserido;
- 2 - Alterado;
- 3 - Excluído;
- !4 - Não inserido (depósito informado não possui configuração);
- !5 - Não há configuração de depósito para a empresa: XXXXX;
- !6 - Não inserido (ERPID vazio);
- !8- Não inserido (rota não cadastrada);
- !9 - Não foi possível encontrar a carga;
- !10 - O status da tarefa da carga é diferente de aguardando;
- !11 - Carga não encontrada ou operação da carga diferente de INSERT ou DELETE;
- !12 - Veículo não encontrado;
- !13 - Não é possível vincular o pedido a carga. Status do pedido: XXXXX;
- !14 - Não foi possível localizar o pedido;
- !15 - Erro ao vincular carga ao pedido;
- !16 - Não foi possível vincular pedido a carga. Pedido está sendo executado e carga não é de expedição;
- !17 - Não foi possível vincular pedido a carga. Retorno do pedido: XXXXX;
- !18 - Não foi possível encontrar a carga;
- !19 - O status da tarefa da carga é diferente de aguardando;
- !20 - Carga à ser alterada/deletada não existe no WMS;
- !21 - Nenhuma operação válida enviada (válidas: INSERT, UPDATE, DELETE);
- !22 - Veículo não encontrado;
- !23 - Carga não inserida! Erro em pedido da Carga. Documento pedido: XXXXX Erro: XXXXX;
- !24 - Carga não inserida! Erro em pedido da Carga. Documento pedido: (Documento não enviado ou erro ao carregar) Erro: XXXXX;
- !42 - Erro não cadastrado (informações no log do servidor).
Dicionário de dados - Carga
| Nome | Tipo de Dado | Descrição | Obrigatório | Padrão |
|---|---|---|---|---|
| erpId | varchar(30) | Chave que identifica o registro. | ||
| operacao | varchar(10) | Operação ('INSERT') | ||
| numero | number(10) | Número da carga. | ||
| empresa | varchar(20) | Número da empresa. | ||
| data | datetime | Data da carga. | Formato:"MMM dd, yyyy HH:mm:ss a" Língua:"en" (configurável se necessário) | |
| noRota | number(10) | Número da rota. | ||
| descRota | varchar(100) | Descrição da rota. | ||
| noDoca | number(10) | Número da doca. | ||
| expedicao | boolean | (true) é uma carga de expedição, (false) é uma carga de separação. | false | |
| faturado | boolean | (true) é uma carga já faturada, (false) não. | false | |
| prioridade | number(10) | Prioridade da carga. | 0 | |
| valor | number(15,4) | Valor da carga. | ||
| veiculoErpId | varchar(30) | Chave que identifica o veículo. | ||
| transportadoraErpId | varchar(50) | Chave que identifica a transportadora. | ||
| nomeTransportadora | varchar(100) | Nome da transportadora. | ||
| pedidosCarga | arraylist (Pedidos) | Lista de pedidos a serem integrados. |
Entidade Pedido
Para visualizar o modelo da estrutura da entidade do Pedido, vide a sessão de Integração de Pedidos.