Web service com.senior.g5.co.mct.imp.importarcontrolesembarqueexportacao
Tipo de execução
Para cada tipo de execução, existem diferentes parâmetros que podem ser comuns a todas as portas.
Autenticação
Caso seja utilizada alguma forma de autenticação para integração de informações através de web services, é necessário identificar o tipo no parâmetro <encryption>, conforme seus valores possíveis.
Campos numéricos
Orientação válida para qualquer campo de web service que possui objetivo de receber valores, independentemente do seu tipo ser Integer, Double e String. Estas orientações devem ser seguidas nas requisições efetuadas via SOAP e em execuções efetuadas através do SGI, relatórios e regras LSP.
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
- Envio no formato ZZZZ,ZZ
- É fundamental não enviar os campos numéricos com separador de milhar, pois ocorrerá erro ao executar a requisição
- Obrigatória a utilização do separador decimal com vírgula, e não com ponto
- Obrigatória a utilização do zero a direita. Por exemplo, se o valor for 350,20, a requisição deve ser enviada com este exato valor. Se o valor enviado for enviado como 350,2, o sistema não irá interpretar a requisição adequadamente
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
number(005,2) = 350,20 - o sistema espera que o número digitado contenha até 3 casas antes da vírgula e obrigatoriamente duas após;
number(015,2): 35000,20 - o sistema espera que o número digitado contenha até 13 casas antes da vírgula e obrigatoriamente duas após;
number(008,4) = 3200,2074 - o sistema espera que o número digitado contenha até 4 casas antes da vírgula e obrigatoriamente duas após.
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
- Envio no formato ZZZZ.ZZ
- É fundamental não enviar os campos numéricos com separador de milhar, pois ocorrerá erro ao executar a requisição
- Obrigatória a utilização do separador decimal com ponto, e não com vírgula
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
- number(005,2) = 350.20 - o sistema espera que o número digitado contenha até 3 casas antes da vírgula e obrigatoriamente duas após;
- number(015,2): 35000.20 - o sistema espera que o número digitado contenha até 13 casas antes da vírgula e obrigatoriamente duas após;
- number(008,4) = 3200.2074 - o sistema espera que o número digitado contenha até 4 casas antes da vírgula e obrigatoriamente duas após.
WSDL
- Síncrono: http://example.com/g5-senior-services/sapiens_Synccom_senior_g5_co_mct_imp_importarcontrolesembarqueexportacao?wsdl
- Assíncrono: http://example.com/g5-senior-services/sapiens_Asynccom_senior_g5_co_mct_imp_importarcontrolesembarqueexportacao?wsdl
- Agendado: http://example.com/g5-senior-services/sapiens_Scheduledcom_senior_g5_co_mct_imp_importarcontrolesembarqueexportacao?wsdl
Porta
Importar
Controladoria - Gestão de Tributos - Escrituração - Importar Controles de Embarque de Exportação
Necessita autenticação: sim.
Situação de versão: atual.
Versão: 1
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:Importar> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <gridControle> <codEmp>Integer</codEmp> <codFil>Integer</codFil> <numEbq>Integer</numEbq> <codTra>Integer</codTra> <plaVei>String</plaVei> <codMtr>Integer</codMtr> <nomMot>String</nomMot> <docMot>String</docMot> <dsnEbq>String</dsnEbq> <datSai>String</datSai> <docExp>String</docExp> <numDec>String</numDec> <datDec>String</datDec> <natExp>String</natExp> <numExp>String</numExp> <datExp>String</datExp> <chcEmb>String</chcEmb> <datChc>String</datChc> <datAvb>String</datAvb> <tipChc>Integer</tipChc> <codPai>String</codPai> <docPro>String</docPro> <oriMim>String</oriMim> <codCli>Integer</codCli> <filCon>Integer</filCon> <numMem>String</numMem> </gridControle> <gridNFControle> <codEmp>Integer</codEmp> <codFil>Integer</codFil> <numEbq>Integer</numEbq> <seqEbq>Integer</seqEbq> <filNfv>Integer</filNfv> <codCli>Integer</codCli> <numNfv>Integer</numNfv> <numNff>Integer</numNff> <snfNfv>String</snfNfv> <codTns>String</codTns> <seqInv>Integer</seqInv> </gridNFControle> <gridNFExportado> <codEmp>Integer</codEmp> <codFil>Integer</codFil> <numEbq>Integer</numEbq> <seqEbq>Integer</seqEbq> <seqNex>Integer</seqNex> <datEex>String</datEex> <numNex>Integer</numNex> <serNex>String</serNex> <numDex>String</numDex> </gridNFExportado> </parameters> </ser:Importar> </soapenv:Body> </soapenv:Envelope>
Parâmetros da requisição:
Nome | Tipo | Descrição |
---|---|---|
gridControle | Set | |
gridControle.codEmp | Integer | (Obrigatório) - Number(004) - Empresa |
gridControle.codFil | Integer | (Obrigatório) - Number(005) - Filial |
gridControle.numEbq | Integer | (Obrigatório) - Number(008) - Nr. Emb. |
gridControle.codTra | Integer | (Opcional) - Number(009) - Transp. |
gridControle.plaVei | String | (Opcional) - String(010) - Placa |
gridControle.codMtr | Integer | (Opcional) - Number(006) - Motorista |
gridControle.nomMot | String | (Opcional) - String(040) - Nome Mot. |
gridControle.docMot | String | (Opcional) - String(040) - Documentos |
gridControle.dsnEbq | String | (Opcional) - String(060) - Destino |
gridControle.datSai | DateTime | (Opcional) - Date(000) - Data Saída |
gridControle.docExp | String | (Opcional) - String(001) - Tipo Doc. Exp. - Lista: 0 = Declaração de Exportação, 1 = Declaração Simplificada de Exportação |
gridControle.numDec | String | (Opcional) - String(011) - Nro. Decl. |
gridControle.datDec | DateTime | (Opcional) - Date(000) - Data Decl. |
gridControle.natExp | String | (Opcional) - String(001) - Nat. Exp. - Lista: 0 = Exportação Direta, 1 = Exportação Indireta |
gridControle.numExp | String | (Opcional) - String(012) - Nro Reg. Exp. |
gridControle.datExp | DateTime | (Opcional) - Date(000) - Data Reg. Exp. |
gridControle.chcEmb | String | (Opcional) - String |
gridControle.datChc | DateTime | (Opcional) - Date(000) - Data Conhec. Emb. |
gridControle.datAvb | DateTime | (Opcional) - Date(000) - Data Averb. |
gridControle.tipChc | Integer | (Opcional) - Number(002) - Tipo Conhec. Trans. - Lista: 01 = AWB, 02 = MAWB, 03 = HAWB, 04 = COMAT, 06 = R. Expressas, 07 = Etiq. RExpressas, 08 = HR. Expressas, 09 = AV7, 10 = BL, 11 = MBL, 12 = HBL, 13 = CRT, 14 = DSIC, 16 = COMAT BL, 17 = RWB, 18 = HRWB, 19 = TIF/DTA, 20 = CP2, 91 = NAO IATA, 92 = MNAO IATA, 93 = HNAO IATA, 99 = Outros |
gridControle.codPai | String | (Opcional) - String(004) - País |
gridControle.docPro | String | (Opcional) - String(001) - Doc. Próprio - Lista: S = Sim, N = Não |
gridControle.oriMim | String | (Obrigatório) - String(001) - Ori. Mov. - Lista: C = Comercial, D = Digitado, I = Importação, V = Vetorh, O = Consolidado |
gridControle.codCli | Integer | (Opcional) - Number(009) - Cli. Exp. |
gridControle.filCon | Integer | (Opcional) - Number(005) - Filial Consolidação |
gridControle.numMem | String | (Opcional) - String(015) - Núm. Mem. |
gridNFControle | Set | |
gridNFControle.codEmp | Integer | (Obrigatório) - Number(004) - Empresa |
gridNFControle.codFil | Integer | (Obrigatório) - Number(005) - Filial |
gridNFControle.numEbq | Integer | (Obrigatório) - Number(008) - Nr. Emb. |
gridNFControle.seqEbq | Integer | (Obrigatório) - Number(004) - Seq. |
gridNFControle.filNfv | Integer | (Obrigatório) - Number(005) - Filial NFS |
gridNFControle.codCli | Integer | Código do cliente da nota fiscal de saída |
gridNFControle.numNfv | Integer | (Obrigatório) - Number(009) - Nº NFS |
gridNFControle.numNff | Integer | Sequencial de lançamento da nota fiscal |
gridNFControle.snfNfv | String | (Obrigatório) - String(003) - Série NFS |
gridNFControle.codTns | String | Código da transação |
gridNFControle.seqInv | Integer | Sequencial de lançamento do item |
gridNFExportado | Set | |
gridNFExportado.codEmp | Integer | (Obrigatório) - Number(004) - Empresa |
gridNFExportado.codFil | Integer | (Obrigatório) - Number(005) - Filial |
gridNFExportado.numEbq | Integer | (Obrigatório) - Number(008) - Nr. Emb. |
gridNFExportado.seqEbq | Integer | (Obrigatório) - Number(004) - Seq. |
gridNFExportado.seqNex | Integer | (Obrigatório) - Number(009) - Sequência |
gridNFExportado.datEex | DateTime | (Opcional) - Date(000) - Emissão |
gridNFExportado.numNex | Integer | (Opcional) - Number(009) - Nº NF Exp. |
gridNFExportado.serNex | String | (Opcional) - String(003) - Série Legal |
gridNFExportado.numDex | String | (Opcional) - String(011) - Nro. Decl. Exp. |
Resposta:
Observação
Envelope SOAP de resposta de requisições síncronas. Para requisições assíncronas ou agendamentos, a resposta é apenas uma String chamada "result" com o valor "OK", se foi executado com sucesso ou, caso contrário, a mensagem do erro ocorrido.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:ImportarResponse> <result> <gridRetorno> <codEmp>Integer</codEmp> <codFil>Integer</codFil> <numEbq>Integer</numEbq> <msgRet>String</msgRet> </gridRetorno> <erroExecucao>String</erroExecucao> </result> </ser:ImportarResponse> </soapenv:Body> </soapenv:Envelope>
Atributos da resposta:
Nome | Tipo | Descrição |
---|---|---|
erroExecucao | String | Indica erros ocorridos no servidor ao executar o serviço, podendo conter os seguintes valores:Vazio ou nulo, indicando que a execução foi feita com sucessoA mensagem do erro ocorrido no servidorSó impede a gravação quando o retorno.tipRet for igual a "2" |
gridRetorno | Set | Grade para retornar todas as notas fiscais geradas pelo sistema, descrevendo uma mensagem de retorno quanto a importação de cada nota fiscal.
A mensagem "OK", indica que a nota fiscal, assim como seus itens e demais tabelas associadas, foram importadas com sucesso. Demais mensagens geradas, serão para indicar alguma irregularidade para com o lançamento da nota fiscal. |
gridRetorno.codEmp | Integer | (Obrigatório) - Number(004) - Empresa |
gridRetorno.codFil | Integer | (Obrigatório) - Number(005) - Filial |
gridRetorno.numEbq | Integer | (Obrigatório) - Number(009) - Nº Inicial NFE |
gridRetorno.msgRet | String | (Opcional) - String(120) - Obs. ICMS |