Capítulo11

Serviço cadastrarFornecedor

11.1 - Requisição

O serviço cadastrarFornecedor cadastra ou altera um fornecedor para determinada agência. Para cadastrar é preciso informar um identificador backoffice do fornecedor, caso o identificador backoffice já exista na base de dados o sistema fará uma alteração no cadastro do fornecedor.

Descrição dos campos de requisição fornecedor

Tag

Descrição

Parent

Formato

Required

identificadorBackofficeFornecedor

Número de identificação do Fornecedor

fornecedor

String

True

nomeFornecedor

Nome do Fornecedor

fornecedor

String

True

razaoSocial

Razão Social do Fornecedor

fornecedor

String

True

cnpj

CNPJ do Fornecedor

fornecedor

String

False

pais

País do Fornecedor

fornecedor

String

False

uf

Sigla do Estado do Fornecedor

fornecedor

String

False

cidade

Cidade do Fornecedor

fornecedor

String

False

bairro

Bairro do Fornecedor

fornecedor

String

True

endereco

Endereço do Fornecedor

fornecedor

String

True

complementoEndereco

Complemento do endereço do Fornecedor

fornecedor

String

False

ddiTelefone

DDI do telefone do Fornecedor

fornecedor

String

True

dddTelefone

DDD do telefone do Fornecedor

fornecedor

String

True

telefone

Telefone do Fornecedor

fornecedor

String

True

ddiFax

DDI do Fax do Fornecedor

fornecedor

String

False

dddFax

DDD do Fax do Fornecedor

fornecedor

String

False

fax

Fax do Fornecedor

fornecedor

String

False

email

E-mail do Fornecedor

fornecedor

String

True

site

Site do Fornecedor

fornecedor

String

False

longitude

Longitude do local do Fornecedor

fornecedor

BigDecimal

False

latitude

Latitude do local do Fornecedor

fornecedor

BigDecimal

False

hotel

Se true o fornecedor trabalha com produto hotel

fornecedor

Boolean

True

carro

Se true o fornecedor trabalha com produto carro

fornecedor

Boolean

True

outro

Se true o fornecedor trabalha com produto outro

fornecedor

Boolean

True

iata

Codigo IATA da cidade do fornecedor

fornecedor

String

False

ativo

Elemento que indica se o fornecedor está ativo

fornecedor

boolean

True

obsConsultor

Observações ao consultor sobre o fornecedor

fornecedor

String

False

Descrição do campo FornecedorRef

Tag

Descrição

Parent

Formato

Required

identificadorBackofficeFornecedor

Código identificador do fornecedor no sistema

fornecedorRef

String

True


11.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:cadastrarFornecedor>
            <fornecedores>
                <fornecedor>
                    <identificadorBackofficeFornecedor>
                        f1233
                    </identificadorBackofficeFornecedor>
                    <nomeFornecedor>lemontech</nomeFornecedor>
                    <razaoSocial>lemontech</razaoSocial>
                    <cnpj>99.999.999/9999-99</cnpj>
                    <pais>BRASIL</pais>
                    <cidade>SAO PAULO</cidade>
                    <bairro>Republica</bairro>
                    <endereco>Av Sao Luiz</endereco>
                    <uf>SP</uf>
                    <complementoEndereco>12B</complementoEndereco>
                    <ddiTelefone>11</ddiTelefone>
                    <dddTelefone>11</dddTelefone>
                    <telefone>22222222</telefone>
                    <ddiFax>11</ddiFax>
                    <dddFax>11</dddFax>
                    <fax>44445555</fax>
                    <email>lemontech@lemontech.com.br</email>
                    <site>www.lemontech.com.br</site>
                    <longitude>11</longitude>
                    <latitude>11</latitude>
                    <hotel>true</hotel>
                    <carro>false</carro>
                    <outro>false</outro>
          <obsConsultor>Obs ao consultor</obsConsultor>
                </fornecedor>
            </fornecedores>
        </ser:cadastrarFornecedor>
    </soapenv:Body>
</soapenv:Envelope>

11.3 - Resposta

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

Descrição dos campos Resposta Conta Contábil

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


11.4 - Exemplo

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