Pular para conteúdo

Integração de expedição de carga

Para a integração da montagem de carga de expedição, será necessário chamar o método integrarExpedicaoCarga. Nesse método deve ser enviado as informações da carga e quais os pedidos que vão fazer parte dela (pedidos devem existir no WMS), os pedidos serão buscados pelo ErpId, NoPedido, ou Documento (deve ser enviado pelo menos uma dentre essas 3 informações). A chamada desse serviço procede da seguinte forma:

URL

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

Headers

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

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

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

Body

carga : "JSON Expedição Carga"

JSON Expedição 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,
    "faturado": false,
    "prioridade": 1000,
    "valor": 22.515,
    "veiculoErpId": "TruckMP1254",
    "transportadoraErpId": "981100004",
    "nomeTransportadora": "Teste Transportadora",
    "pedidosCarga": [
        {
            "erpId": "id_erp",
            "noPedido": 0,
            "documento": "pedido 1254"
        },
        {
            "erpId": "id_erp",
            "noPedido": 0,
            "documento": "pedido 1254"
        }
    ]
}

Response

{
    "CyberWeb": "1 - Inserido"
}

URL

http://ip_servidor:9090/SyncWS/SyncWS/integrarExpedicaoCarga

Headers

Content-Type : text/xml

Body - (XML) Expedição Carga

<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
    <Body>
        <integrarExpedicaoCarga xmlns="http://soap.cyber/">
            <sessionId xmlns="">SessionId</sessionId>
            <carga xmlns="">JSON Expedição Carga</carga>
        </integrarExpedicaoCarga>
    </Body>
</Envelope>

JSON Expedição 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,
    "faturado": false,
    "prioridade": 1000,
    "valor": 22.515,
    "veiculoErpId": "TruckMP1254",
    "transportadoraErpId": "981100004",
    "nomeTransportadora": "Teste Transportadora",
    "pedidosCarga": [
        {
            "erpId": "id_erp",
            "noPedido": 7857,
            "documento": "pedido 1254"
        },
        {
            "erpId": "id_erp_2",
            "noPedido": 57446,
            "documento": "pedido 4325"
        }
    ]
}

Response

<?xml version='1.0' encoding='UTF-8'?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
    <S:Body>
        <ns2:integrarExpedicaoCargaResponse xmlns:ns2="http://soap.cyber/">
            <return>1 - Inserido</return>
        </ns2:integrarExpedicaoCargaResponse>
    </S:Body>
</S:Envelope>

RC's do método integrarExpedicaoCarga

  • 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);
  • !7- Não inserido (rota não cadastrada);
  • !8 - O status da tarefa da carga é diferente de aguardando;
  • !9 - Não é possível vincular o pedido a carga. Status do pedido: XXXXX;
  • !10 - Não foi possível encontrar a carga;
  • !11 - O status da tarefa da carga é diferente de aguardando;
  • !12 - Carga à ser alterada/deletada não existe no WMS;
  • !13 - Nenhuma operação válida enviada (válidas: INSERT, UPDATE, DELETE);
  • !14 - Veículo não encontrado;
  • !15 - Carga não inserida! Erro em pedido da Carga. Documento pedido: XXXXX Erro: XXXXX;
  • !16 - 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​:​m​m​:​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.
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.

Dicionário de dados - pedidosCarga

Nome Tipo de Dado Descrição Obrigatório Padrão
erpId varchar(30) Chave que identifica o registro.
noPedido number(10) Número do pedido.
documento varchar(1000) Documento de identificação do pedido.