WS001-StCruz - Enviar rotas para Comprovei

Objetivo

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

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);
  • Para a conta da Santa Cruz o user é stcruz e a senha admin
POST http://soap.comprovei.com.br/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: soap.comprovei.com.br
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://soap.comprovei.com.br/WebServicePOD/server.php?wsdl
 Versão atual 4.0 (30/04/2016) - Incluído numeros de danfes associados ao documento

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 Tipo Obrigatório Descrição
+Rotas  sim Indicador de inicio e fim do arquivo .xml
    +Rota  sim 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     string sim Número da rota. Ex. 155
        Data string sim Data de inicio da operação da rota. Obrigatório o formato YYYYMMDD
        +Transportadora  não Indicador de inicio da estrutura Transportadora. Uma rota pode conter uma única transportadora
            Codigo string não

 Código da transportadora. Normalmente é o cnpj sem pontos, traços ou barra. Somente números. Ex 500032
            Razao string não Nome da transportadora. Pode-se utilizar um nome curto (nome fantasia)
        +Motorista  não 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 string não Código de usuário do motorista no sistema Comprovei (Utilizar 0017, 0018 ou 0019 para os testes de performance)
            PlacaVeiculo string não 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 string não Código da base de origem - *** Deixar em branco *** para os testes de performance
                Nome string não Nome da base de origem  - *** Deixar em branco *** para os testes de performance
                Rua string não Logradouro da base de origem (Rua, Avenida, Praça,etc)  - *** Deixar em branco *** para os testes de performance
                Numero string não Número  - *** Deixar em branco *** para os testes de performance
                Complemento string não Complemento do endereço  - *** Deixar em branco *** para os testes de performance
                Bairro string não Bairro  - *** Deixar em branco *** para os testes de performance
                Cidade string não Cidade  - *** Deixar em branco *** para os testes de performance
                Estado string não Estado  - *** Deixar em branco *** para os testes de performance
                CEP string não CEP (somente números, sem traço ou espaços)  - *** Deixar em branco *** para os testes de performance
                Pais string não País  - *** Deixar em branco *** para os testes de performance
            +Destino    Indicador de inicio da estrutura da base destino. Uma rota pode ter uma única base destino
                codigo string não Código da base de destino  - *** Deixar em branco *** para os testes de performance
                Nome string não Nome da base destino  - *** Deixar em branco *** para os testes de performance
                Rua string não Logradouro da base de origem (Rua, Avenida, Praça,etc)  - *** Deixar em branco *** para os testes de performance
                Numero string não Número  - *** Deixar em branco *** para os testes de performance
                Complemento string não Complemento do endereço  - *** Deixar em branco *** para os testes de performance
                Bairro string não Bairro  - *** Deixar em branco *** para os testes de performance
                Cidade string não Cidade  - *** Deixar em branco *** para os testes de performance
                Estado string não Estado  - *** Deixar em branco *** para os testes de performance
                CEP string não CEP (somente números, sem traço ou espaços)  - *** Deixar em branco *** para os testes de performance
                Pais string não Pais  - *** Deixar em branco *** para os testes de performance
        +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 string  sim Número da parada. Começar da parada 1 e com incremento de 1. Uma parada corresponde a um manifesto
                Tipo string sim Tipo da Parada (E = Entrega | C = Coleta). Fixar = E
                Mensagem string não Mensagem para Coleta.  - *** Deixar em branco *** para os testes de performance
                +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 string sim Tipo do documento (NFE, OS, CTE, etc). Não existe validação para esta informação e serve apenas para referência. Fixar MFE
                    Serie string não Série do documento (no caso de NFe). Fixar = 0
                    Emissao string sim Data de emissão do documento. Obrigatório o formato YYYYMMDD
                    Numero string sim Número do documento. Numero do Manifesto
                    ChaveNota string sim Chave identificadora do documento fiscal.  Igual ao numero do Manifesto ou conteúdo do código de barras para os testes de performance
                    ValorNota string não Valor total do documento. Números decimais podem ter como separador "." ou ",".  - Fixar = 0 para os testes de performance
                    ModeloDoc string   não Modelo fiscal do documento (verificar junto a SEFAZ os modelos disponíveis). Fixar = 25
                    Cnpj string não CNPJ (ou CPF) do destinatário do documento. *** Atenção *** somente números, sem ".","," ou "-"
                    CnpjEmissor string não CNPJ do emitente do documento.  *** Atenção *** somente números, sem ".","," ou "-"
                   CnpjTransportador string não CNPJ do transportador.  *** Atenção *** somente números, sem ".","," ou "-"
                +Cliente   Indicador de início da estrutura do cliente. Um documento está associado a um único cliente
                    Codigo string sim Código identificador do cliente. Pode ser o CNPJ, D-U-N-S number. No caso colocar o codigo interno do cliente. Ex V101
                    Contato string não Nome da pessoa de contato deste cliente. 
                    Telefone string não 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 string não Email da pessoa de contato deste cliente. Esta informação será utilizada para enviar notificações por email ao cliente
                    Razao string sim Razão social ou nome fantasia do cliente
                    Endereco string sim Endereço do cliente. Colocar no formato Logradouro (Rua, Avenida, Praça, etc) Nome, número. NÃO COLOCAR COMPLEMENTOS
                    Bairro string sim Bairro
                    Cidade string sim Cidade
                    Estado string sim Estado
                    Pais string sim Pais
                    CEP string sim Zipcode
                    Regiao string não Região
                +DANFEs   Indicador de início da estrutura das danfe's associadas ao documento de entrega
                    +DANFE   Indicador de início da primeira DANFE deste documento
                        NumDanfe string não Numero da NFe
                        SerieDanfe string não Serie da NFe
                        ChaveDanfe string não Chave da Danfe
                        DataEmissaoDanfe string não Data de emissão desta Danfe. Obrigatório estar no formato YYYYMMDD
                +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 string sim Código do item, volume, palete, etc. Preencher com o conteúdo do código de barras
                        PesoBruto string não Peso bruto em Kg. Números decimais podem ter como separador "." ou ",". Fixar = 0
                        PesoLiquido string não Peso líquido em Kg. Números decimais podem ter como separador "." ou ",". Fixar = 0
                        Volumes string sim Quantidade de volumes total do documento. Fixar = 1
                        Descricao string sim Descriçao do item, volume, palete, etc. Ex. Volume 01/20
                        Qde string sim Quantidade deste item, volume, palete, etc. Fixar = 1
                        UOM string sim Unidade de medida deste item, volume, palete, etc. Fixar = VOL
                        Barcode string sim Barcode associado a este item, volume, palete, etc. Conteúdo do barcode do volume

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>