WS001 - Enviar rotas para Comprovei a partir da notfis

Objetivo

Enviar uma rota para a Comprovei. Uma rota é caracterizada por um conjunto de paradas para coleta e/ou entregas e associada a um motorista e um veículo.

Caso as informações do motorista e veículo não sejam enviadas, a rota deve ser liberada manualmente, através do painel web.

As informações que caracterizam uma rota são (campos chave):
  • Nome da rota
  • Data da rota
  • Motorista
  • Placa da veículo principal

Características
  • As chamadas serão realizadas via "SOAP" sobre HTTP;
  • A origem do chamado do web service será o sistema do cliente;

Autenticação

  • As chamadas terão autenticação a nível de transporte (Basic Authentication);
  • Solicite o user / password ao administrador da conta
POST http://54.221.129.119:85/WebServicePOD/server.php HTTP/1.1
Accept-Encoding: gzip,deflate
Content-Type: text/xml;charset=UTF-8
SOAPAction: "urn:WebServiceComprovei#sendDocsToPOD"
Authorization: Basic {user / pass codificado em BASE64}
Content-Length: 117
Host: 54.221.129.119:85
Connection: Keep-Alive
User-Agent: Apache-HttpClient/4.1.1 (java 1.5)

Descrição do método
 Método   sendDocsToPOD
 Endereço de acesso http://54.221.129.119:85/WebServicePOD/server.php?wsdl
 Versão atual 2.1 (31/08/2015)

Parâmetros de entrada
 Atributo Tipo Descrição
 conteudoArquivo MIME Base64 conteúdo do arquivo {nome_do_arquivo.xml} codificado em MIME Base64    
 nomeArquivo conjunto de caracteres {nome_do_arquivo.xml} para identificação no servidor

Parâmetros de saída

 Atributo Tipo Descrição
 status conjunto de caracteres mensagem de retorno informando se o upload e a importação dos dados foram realizados com sucesso.  

Estrutura do arquivo {nome_do_arquivo.xml}

 Atributo Registro Posição(tam) Descrição
+Rotas   Indicador de inicio e fim do arquivo .xml
    +Rota 
 Indicador de inicio da estrutura de um rota.  Um único arquivo .xml pode conter várias rotas e elas serão agrupadas na importação.
        Numero     310 004(014) Número ou nome da rota. 
        Data 000
 074(008) Data de inicio da operação da rota. No arquivo notfis está no formato DDMMYY  sendo necessário converter para o formato YYYYMMDD.
        +Transportadora 
 Indicador de inicio da estrutura Transportadora. Uma rota pode conter uma única transportadora
            Codigo N/A Parâmetro

 Código da transportadora. Normalmente é o cnpj sem pontos, traços ou barra. Somente números
            Razao N/A Parametro Nome da transportadora. Pode-se utilizar um nome curto (nome fantasia)
        +Motorista 
 Indicador de inicio da estrutura Motorista. Uma rota pode conter um único motorista. Informação não obrigatória, porém se não forem enviados a liberação da rota deverá ser manual
            Usuario N/A Deixar em branco  Código de usuário do motorista no sistema Comprovei
            PlacaVeiculo 313 146(007) Placa do veículo no formato AAA9999 (sem traço ou espaço)
        +Base   Indicador de inicio da estrutura das bases origem e destino. Essas informações são opcionais e devem ser necessariamente preenchidas nos casos de utilização da roteirização
            +Origem   Indicador de inicio da estrutura da base origem. Uma rota pode ter uma única base origem
                codigo   Código da base de origem
                Nome   Nome da base de origem
                Rua   Logradouro da base de origem (Rua, Avenida, Praça,etc)
                Numero   Número
                Complemento   Complemento do endereço
                Bairro 
 Bairro
                Cidade   Cidade
                Estado   Estado
                CEP   CEP (somente números, sem traço ou espaços)
                Pais   País
            +Destino    Indicador de inicio da estrutura da base destino. Uma rota pode ter uma única base destino
                codigo 
 Código da base de destino
                Nome 
 Nome da base destino
                Rua   Logradouro da base de origem (Rua, Avenida, Praça,etc)
                Numero   Número
                Complemento 
 Complemento do endereço
                Bairro   Bairro
                Cidade   Cidade
                Estado   Estado
                CEP   CEP (somente números, sem traço ou espaços)
                Pais   Pais
        +Paradas   Indicador de inicio da estrutura de paradas. Uma rota pode ter várias paradas
            +Parada
  Indicador de início da estrutura de uma parada
                Numero  313 026(001) Número da parada
                Tipo Fixo Fixo Tipo da Parada (E = Entrega | C = Coleta). No caso fixar = E
                Mensagem 
 Mensagem para Coleta. Deixar em Branco
                +Documento   Indicador de inicio da estrutura de um documento. Uma parada por tem um único documento. No caso de entregas com mais de um documento, deve-se criar uma nova parada para cada documento. O sistema identifica vários documentos em um mesmo endereço e realiza a consolidação
                    Tipo Fixo Fixo Tipo do documento (NFE, OS, CTE, etc). Fixo = "NFS"
                    Serie 313 030(003) Série do documento
                    Emissao 313 041(008) Data de emissão do documento. No arquivo notfis está no formato DDMMYYY  sendo necessário converter para o formato YYYYMMDD.
                    Numero 313 262(009) Número do documento
                    ChaveNota 313 271(044) Chave identificadora do documento fiscal
                    ValorNota 313 086(013,002) Valor total do documento. INCLUIR O PONTO DECIMAL
                    ModeloDoc FIXO   FIXO FIXO = 55
                    Cnpj 312 044(014) CNPJ (ou CPF) do destinatário do documento
                    CnpjEmissor 313 279(014) CNPJ do emitente do documento
                   CnpjTransportador N/A Parâmetro CNPJ do transportador
                +Cliente   Indicador de início da estrutura do cliente. Um documento está associado a um único cliente
                    Codigo 312 044(014) Código identificador do cliente. Pode ser o CNPJ, D-U-N-S number
                    Contato 312 004(040) Nome da pessoa de contato deste cliente
                    Telefone 312 199(035) Celular da pessoa de contado. Não colocar traços, espaços, hifens. SOMENTE NÚMEROS. Esta informação será utilizada para enviar notificações via SMS
                    Email N/A
 Email da pessoa de contato deste cliente. Esta informação será utilizada para enviar notificações por email ao cliente. DEIXAR EM BRANCO
                    Razao 312 044(014) Razão social ou nome fantasia do cliente
                    Endereco 312 073(040) Endereço do cliente. Colocar no formato Logradouro (Rua, Avenida, Praça, etc) Nome, número. NÃO COLOCAR COMPLEMENTOS
                    Bairro 312 113(020) Bairro - RETIRAR ESPAÇOS A DIREITA
                    Cidade 312 133(035) Cidade - RETIRAR ESPAÇOS A DIREITA
                    Estado 312 186(009) Estado - RETIRAR ESPAÇOS A DIREITA
                    Pais FIXO FIXO Pais FIXO = BRASIL
                    CEP 312 168(009) Zipcode - RETIRAR O "-" E DEIXAR SOMENTE NUMEROS
                +SKUs   Indicador de início da estrutura de itens do documento. Um item pode ser um produto, um volume, um palete, etc
                    +SKU   Indicador de início da estrutura do primeiro item deste documento
                        Codigo 313 271(044) Código do item, volume, palete, etc
                        PesoBruto FIXO FIXO Peso bruto em Kg. Números decimais podem ter como separador "." ou ",". FIXO = 0
                        PesoLiquido FIXO FIXO Peso líquido em Kg. Números decimais podem ter como separador "." ou ",". FIXO = 0
                        Volumes FIXO FIXO Quantidade de volumes total do documento. FIXO = 1
                        Descricao 313+311 composição "Pedido "+{313}242(020 retirando os espaços a direita)+" "+{311}134(040 retirando os espaços a direita)
                        Qde FIXO FIXO Quantidade deste item, volume, palete, etc. FIXO = 1
                        UOM FIXO FIXO Unidade de medida deste item, volume, palete, etc. FIXO = DOC
                        Barcode 313 271(044) Barcode associado a este item, volume, palete, etc

Exemplo de arquivo xml
<?xml version="1.0" encoding="UTF-8"?>
<Rotas>
  <Rota numero="12/1/9999">
    <Data>20150710</Data>
    <Transportadora>
      <Codigo>0</Codigo>
      <Razao>SEM TRANSPORTADORA</Razao>
    </Transportadora>
    <Motorista>
      <Usuario>0017</Usuario>
      <PlacaVeiculo>EIJ9079</PlacaVeiculo>
    </Motorista>
    <Base>
      <Origem codigo="1">
        <Nome>BASE1</Nome>
        <Rua>Rua Prefeito Tigre Maia</Rua>
        <Numero>650</Numero>
        <Complemento></Complemento>
        <Bairro>Pinheirinho</Bairro>
        <Cidade>Itajubá</Cidade>
        <Estado>MG</Estado>
        <CEP>37500182</CEP>
        <Pais>Brasil</Pais>        
      </Origem>
      <Destino codigo="2">
        <Nome>BASE2</Nome>
        <Rua>Rua Antonio Simão Mauad</Rua>
        <Numero>444</Numero>
        <Complemento></Complemento>
        <Bairro>Pinheirinho</Bairro>
        <Cidade>Itajubá</Cidade>
        <Estado>MG</Estado>
        <CEP>37500356</CEP>
        <Pais>Brasil</Pais>
      </Destino>
    </Base>
    <Paradas>
      <Parada numero="1">
        <Tipo>E</Tipo>
        <Mensagem>Entrega</Mensagem>
        <Documento>
          <Tipo>NFS</Tipo>
          <Serie>1</Serie>
          <Emissao>20150710</Emissao>
          <Numero>01</Numero>
        </Documento>
        <Cliente>
          <Codigo>35231360001</Codigo>
          <Contato>UNIFEI</Contato>
          <Telefone></Telefone>
          <Email></Email>
          <Razao>UNIFEI</Razao>
          <Endereco>Av. Benedito Pereira Santos, 1303</Endereco>
          <Bairro>Pinheirinho</Bairro>
          <Cidade>Itajubá</Cidade>
          <Estado>MG</Estado>
          <Pais>Brasil</Pais>
          <CEP>37500903</CEP>
        </Cliente>  
        <SKUs>
          <SKU codigo="2100050000000000000000000000000000000000000">
            <PesoBruto>40</PesoBruto>
            <PesoLiquido>36</PesoLiquido>
            <Volumes>3</Volumes>
            <Descricao>Produto 1</Descricao>
            <Qde>3</Qde>
            <Uom>CX</Uom>
            <Barcode>9003579311295</Barcode>
          </SKU>
        </SKUs>
      </Parada>
      <Parada numero="2">
        <Tipo>E</Tipo>
        <Mensagem>Entrega</Mensagem>
        <Documento>
          <Tipo>NFS</Tipo>
          <Serie>1</Serie>
          <Emissao>20150711</Emissao>
          <Numero>02</Numero>
        </Documento>
        <Cliente>
          <Codigo>35231360002</Codigo>
          <Contato>Renato</Contato>
          <Telefone></Telefone>
          <Email></Email>
          <Razao>Renato</Razao>
          <Endereco>Rua Coronel Rennó, 07</Endereco>
          <Bairro>Centro</Bairro>
          <Cidade>Itajubá</Cidade>
          <Estado>MG</Estado>
          <Pais>Brasil</Pais>
          <CEP>37500050</CEP>
        </Cliente>  
        <SKUs>
          <SKU codigo="2100050000000000000000000000000000000000000">
            <PesoBruto>40</PesoBruto>
            <PesoLiquido>36</PesoLiquido>
            <Volumes>3</Volumes>
            <Descricao>Produto 1</Descricao>
            <Qde>3</Qde>
            <Uom>CX</Uom>
            <Barcode>9003579311295</Barcode>
          </SKU>
        </SKUs>
      </Parada>
      <Parada numero="3">
        <Tipo>E</Tipo>
        <Mensagem>Entrega</Mensagem>
        <Documento>
          <Tipo>NFS</Tipo>
          <Serie>1</Serie>
          <Emissao>20150712</Emissao>
          <Numero>03</Numero>
        </Documento>
        <Cliente>
          <Codigo>35231360003</Codigo>
          <Contato>Jonathan</Contato>
          <Telefone></Telefone>
          <Email></Email>
          <Razao>Jonathan</Razao>
          <Endereco>Rua São Judas Tadeu, 65</Endereco>
          <Bairro>Centro</Bairro>
          <Cidade>Itajubá</Cidade>
          <Estado>MG</Estado>
          <Pais>Brasil</Pais>
          <CEP>37500172</CEP>
        </Cliente>  
        <SKUs>
          <SKU codigo="2100050000000000000000000000000000000000000">
            <PesoBruto>40</PesoBruto>
            <PesoLiquido>36</PesoLiquido>
            <Volumes>3</Volumes>
            <Descricao>Produto 1</Descricao>
            <Qde>3</Qde>
            <Uom>CX</Uom>
            <Barcode>9003579311295</Barcode>
          </SKU>
        </SKUs>
      </Parada>
      <Parada numero="4">
        <Tipo>E</Tipo>
        <Mensagem>Entrega</Mensagem>
        <Documento>
          <Tipo>NFS</Tipo>
          <Serie>1</Serie>
          <Emissao>20150713</Emissao>
          <Numero>04</Numero>
        </Documento>
        <Cliente>
          <Codigo>35231360004</Codigo>
          <Contato>Rafael</Contato>
          <Telefone></Telefone>
          <Email></Email>
          <Razao>Rafael</Razao>
          <Endereco>Rua Oswaldo Cruz, 78</Endereco>
          <Bairro>Varginha</Bairro>
          <Cidade>Itajubá</Cidade>
          <Estado>MG</Estado>
          <Pais>Brasil</Pais>
          <CEP>37501168</CEP>
        </Cliente>  
        <SKUs>
          <SKU codigo="2100050000000000000000000000000000000000000">
            <PesoBruto>40</PesoBruto>
            <PesoLiquido>36</PesoLiquido>
            <Volumes>3</Volumes>
            <Descricao>Produto 1</Descricao>
            <Qde>3</Qde>
            <Uom>CX</Uom>
            <Barcode>9003579311295</Barcode>
          </SKU>
        </SKUs>
      </Parada>
      <Parada numero="5">
        <Tipo>E</Tipo>
        <Mensagem>Entrega</Mensagem>
        <Documento>
          <Tipo>NFS</Tipo>
          <Serie>1</Serie>
          <Emissao>20150714</Emissao>
          <Numero>05</Numero>
        </Documento>
        <Cliente>
          <Codigo>35231360005</Codigo>
          <Contato>Paulo</Contato>
          <Telefone></Telefone>
          <Email></Email>
          <Razao>Paulo</Razao>
          <Endereco>Rua Bartolomeu Tadei, 189A</Endereco>
          <Bairro>Pinheirinho</Bairro>
          <Cidade>Itajubá</Cidade>
          <Estado>MG</Estado>
          <Pais>Brasil</Pais>
          <CEP>37500186</CEP>
        </Cliente>  
        <SKUs>
          <SKU codigo="2100050000000000000000000000000000000000000">
            <PesoBruto>40</PesoBruto>
            <PesoLiquido>36</PesoLiquido>
            <Volumes>3</Volumes>
            <Descricao>Produto 1</Descricao>
            <Qde>3</Qde>
            <Uom>CX</Uom>
            <Barcode>9003579311295</Barcode>
          </SKU>
        </SKUs>
      </Parada>
    </Paradas>
  </Rota>    
</Rotas>