Capítulo7

Serviço cadastrarRegional

7.1 - Requisição

O serviço cadastrarRegional cadastra ou altera uma regional para determinado cliente. Para cadastrar é preciso informar um código identificador da regional, caso já tenha cadastrado no sistema, uma regional com esse código para tal cliente, o sistema irá atualizar as informações da mesma.

Descrição dos campos de requisição

Tag

Descrição

Parent

Formato

Required

codigo

Código identificador da regional no sistema

regional

String

True

descricao

Descrição da regional

regional

String

True

pcc

PCC (Pseudo City Code) / Local Venda GDS

regional

String

False

identificadorBackofficeCliente

Identificador do BackOffice do Cliente

regional

String

False

identificadorBackofficeFranquia

Identificador do BackOffice da Franquia

regional

String

False

ativo

Status da regional

regional

Boolean

True

taxaFee

Valor da Taxa Fee

regional

Double

False

corporateIdGol

Corporate Id Gol

regional

String

False

numeroDK

Número DK

regional

String

False

numeroDkTreinamento

Número DK - Treinamento

regional

String

False

numeroDkEvento

Número DK - Evento

regional

String

False

emitirNotaFiscalEmNomeDoHospede

Emitir nota fiscal em nome do Hóspede

regional

Boolean

False

emitirNotaFiscalEmNomeDaRegional

Emitir nota fiscal em nome da Regional

regional

Boolean

False

idCliente

Número de identificação do Cliente

regional

Inteiro

False

Descrição do campo regionalRef

Tag

Descrição

Parent

Formato

Required

codigo

Código identificador da regional no sistema

regionalRef

String

True


7.2 - Exemplo

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:ser="http://lemontech.com.br/selfbooking/wsselfbooking/services">  
    <soapenv:Header>
        <ser:userPassword>senha</ser:userPassword>
        <ser:userName>usuario</ser:userName>
        <ser:keyClient>chave_da_empresa_cliente</ser:keyClient>
    </soapenv:Header>
    <soapenv:Body>
        <ser:cadastrarRegional>
            <regional>
                <codigo>regional1</codigo>
                <descricao>Regional 1</descricao>
                <pcc>1</pcc>
                <identificadorBackofficeCliente>1</identificadorBackofficeCliente>
                <identificadorBackofficeFranquia>1</identificadorBackofficeFranquia>
                <taxaFee>1.99</taxaFee>
                <ativo>true</ativo>
                <corporateIdGol>GOL123</corporateIdGol>
                <numeroDk>000123</numeroDk>
                <numeroDkTreinamento>000456</numeroDkTreinamento>
                <numeroDkEvento>000789</numeroDkEvento>
                <emitirNotaFiscalEmNomeDoHospede>false</emitirNotaFiscalEmNomeDoHospede>
                <emitirNotaFiscalEmNomeDaRegional>true</emitirNotaFiscalEmNomeDaRegional>
            </regional>
            <!--Optional:-->
            <idCliente>1234</idCliente>
        </ser:cadastrarRegional>
    </soapenv:Body>
</soapenv:Envelope>

7.3 - Resposta

A reposta do serviço é enviada com a tag cadastrarRegionalResponse informando “Sucesso”, caso o cadastro efetuado corretamente, “Erro”, caso ocorra algum problema ou “Alerta” se ocorreu algum problema não-crítico no cadastro ou alteração.

Descrição dos campos Resposta Regional

Tag

Descrição

Parent

Formato

status

Se SUCESSO o cadastro ou alteração foi efetuado corretamente

Se ERRO ocorreu algum problema no cadastro ou alteração

Se ALERTA ocorreu algum problema não-crítico no cadastro ou alteração

resultadoOperacao

String

mensagem

Mensagem com a descrição do status retornado

resultadoOperacao

String


7.4 - Exemplo

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
    <S:Body>
        <ns2:cadastrarRegionalResponse 
        xmlns:ns2="http://lemontech.com.br/selfbooking/wsselfbooking/services">
            <resultadoOperacao>
                <status>SUCESSO</status>
            </resultadoOperacao>
        </ns2:cadastrarRegionalResponse>
    </S:Body>
</S:Envelope>