Professional Documents
Culture Documents
Guia de Referncia
Sapiens SID
Servio Interativo Dinmico
(C) Senior
Sapiens SID
(C) Senior
Julho 2013
(C) Senior
Sapiens SID
NDICE ANALTICO
1 GUIA DE REFERNCIA............................................................................................................................................4
2 AES SID...........................................................................................................................................................6
3 SIDXML.............................................................................................................................................................. 94
(C) Senior
GUIA DE REFERNCIA
Nota a respeito do Conector: A partir da verso 5.7, o 'conector.exe' utilizado somente nas instalaes em modo de
compatibilidade. Para as instalaes com o novo middleware, utiliza-se somente 'conector'.
Os exemplos citados nesse documento so baseados no novo middleware, utilizando apenas 'conector'.
Se a validao do usurio for efetivada, o retorno da requisio acima dever ser um "cdigo de conexo", que ser repassado
posteriormente como parmetro para validar e garantir a autenticidade das demais aes.
IMPORTANTE: Deve-se utilizar uma conta de usurio Sapiens exclusivamente para este fim.
Exemplo:
http://servidor/sapiensweb/conector?
SIS=CO&LOGIN=SID&ACAO=EXESENHA&NOMUSU=USUARIO&SENUSU=SENHA
Exemplo de retorno devolvido pelo Sapiens Server, caso login seja bem sucedido:
38659379861527810
Exemplo de retorno devolvido pelo Sapiens Server, caso erro:
http://<servidor>:<porta>/<diretrio_virtual>/conector?
SIS=CO&LOGIN=SID&USER=<usurio>&CONNECTION=<cdigo_de_conexo>&ACAO=<ao>&<parmetro>=<valor>&...
Exemplo:
http://servidor/sapiensweb/conector?
SIS=CO&LOGIN=SID&USER=USUARIO&CONNECTION=38659379861527810&ACAO=SID.PED.GRAVAR&CODCLI=99
Neste exemplo, envia-se uma requisio ao Sapiens Server para que seja gerado um pedido (cabealho) na base Sapiens,
cujo cdigo de cliente seja 99. A ao SID.PED.GRAVAR retorna o nmero do pedido gerado (caso no ocorra erro).
Parmetro opcional:
AcceptEmptyField
Indica
se os campos passados sem valor ("CAMPO=") devem ser considerados ou no nas aes. Valores possveis: "0" - no considera;
"1" (padro) - considera.
Observao: No so usados cookies para manter a sesso, sendo exclusivamente mantidas pelos parmetros User e
Connection, obrigatrios no corpo da ao.
Formato:
http://<servidor>:<porta>/<diretrio_virtual>/conector?
SIS=CO&LOGIN=SID&ACAO=EXESENHA&NOMUSU=<usurio>&SENUSU=<senha>&PROXACAO=<ao_a_executar_aps_login
>&<parmetro>=<valor>&...
Exemplo:
http://servidor/sapiensweb/conector?
SIS=CO&LOGIN=SID&ACAO=EXESENHA&NOMUSU=USUARIO&SENUSU=SENHA&PROXACAO=SID.PED.GRAVAR&CODCLI=99
Recomenda-se limpar o retorno das aes, ou seja, remover eventuais "CR+LF" e excesso de espaos.
Toda ao enviada sempre retorna alguma informao, seja ela, uma simples literal "OK" ou vrias linhas de dados.
Algumas aes possuem um parmetro opcional denominado "Delim". Sua funo determinar o caractere separador dos
campos de retorno da ao. O valor padro ";" (ponto-e-vrgula).
O cdigo de conexo perde a validade aps a execuo da ao de LOGOFF ou quando o tempo de ociosidade expira. Quando
isso ocorrer, necessrio um efetuar novo login.
Os valores de cada parmetro devem ser sempre atribudos diretamente sem caracteres tipo aspas, independente do tipo de
dado esperado pelo parmetro (Exemplo: NOMCLI=SENIOR, CODCLI=33, DATATU=01/01/2003, VALDSC=199.50). No deve
ser utilizado espaos antes ou depois do caractere "=" (Exemplo incorreto: CODCLI = 123 Exemplo correto: CODCLI=123).
Todas as operaes sero realizadas sempre baseadas na empresa/filial ativa do usurio utilizado no login. Deve-se criar um
usurio Sapiens exclusivo para o SID. Havendo necessidade de operar em mltiplas empresas/filial, deve-se criar e posicionar
um usurio distinto para cada uma delas.
O separador decimal utilizado nos parmetros numricos deve ser o ponto ".".
recomendvel consistir o retorno de cada ao para certificar-se que a mesma foi executada com sucesso. Na maioria delas,
basta verificar se o retorno igual ao literal "OK". J em outras (exemplo SID.PED.GRAVAR) interessante verificar se o retorno
um nmero vlido, ou seja, contendo apenas dgitos numricos.
O servidor (Sapiens Server) gera sempre um histrico de aes recebidas e processadas por ele. Estes arquivos so gerados no
diretrio de LOGs do sistema, com o nome: SAPIENSRV_DUMPLOG_<nnn>_<DATAHORA>.LOG.
IMPORTANTE: O tempo mximo de processamento de uma ao cinco minutos (limite do IIS). Depois deste tempo, a
comunicao interrompida seguida de uma mensagem de time-out. Deve-se ficar atento esta limitao, principalmente
quando utilizar o recurso SIDXML.
AES SID
Segue abaixo a relao das aes implementadas no Sapiens Server at a data de reviso deste documento.
22222
Observao:
Esta ao deve ser utilizada com cautela, pois modifica a empresa/filial ativa do usurio utilizado na autenticao.
Alteraes de empresa/filial no Sapiens podem conflitar com as aes SID, assim como aes concorrentes, caso estejam todos
usando o mesmo usurio. Recomenda-se criar e usar um usurio distinto para cada empresa/filial. Esta ao no deve ser utilizada
em situaes em que no ocorre a autenticao do usurio (como no WebService de invocao SID).
22222
Parmetros opcionais:
Todo parmetro adicional passado com algum valor, poder ser utilizado internamente pela regra, bastando criar uma
varivel de mesmo nome (definir alfa <parmetro>)
Retorno:
O retorno da regra dever ser atribudo varivel alfa "ValStr".
22222
* Acrescentar sempre o termo "Dado_" antes do nome do campo definido nos parmetros de entrada do modelo
* Utilizar este parmetro se desejar imprimir ao invs de apenas executar
* Utilizar este parmetro para gerar uma imagem JPEG ao inves de apenas executar
Retorno:
<definido pelo modelo>
Ou
"OK"
(caso seja informado o parmetro "Impressora=...")
Ou
"<caminho do arquivo JPEG>"
(caso seja informado o parmetro "Formato=JPEG")
Ou
"<caminho do arquivo PDF>"
(caso seja informado o parmetro "Formato= PDF")
Observao: Esta ao no compatvel com chamada via Web Service (com.senior.g5.co.ger.sid).
22222
22222
Observaes:
Esta ao respeita os formatos de sada e a lgica definida nos modelos, com exceo das definies de impressora
(selecionar impressora, impressora padro, etc), por exemplo, se o objetivo a "impresso para arquivo", isto deve ser definido no
modelo do relatrio, pelo gerador de relatrios.
O modelo de nota fiscal de sada no pode estar configurado para pr-visualizar o relatrio ou imprimir para vdeo, caso
contrrio a ao retornar um erro.
A impressora a ser usada (passada por parmetro) deve obrigatoriamente estar instalada no servidor e ser do tipo texto.
Importante ressaltar que, no SapiensWeb, o diretrio padro para gerao dos arquivos de relatrio definido no CFG (chave
REPORTS) ignorado e sempre usado o diretrio temporrio para este fim.
22222
22222
FatPed
Retorno:
<NumPed>
Observao:
Esta ao aceita campos de usurio.
22222
* O campo codpvp no existe fisicamente na tabela de pedidos, mas usado no cabealho da funo apenas para atribuir a data final do
perodo data de previso do pedido
Retorno:
<NumPed>
Observao:
Esta ao aceita campos de usurio.
22222
Parmetros opcionais:
TnsPro
Transao para produtos
UniVen*
Unidade de medida de venda
QtdVen*
Quantidade de medida de venda
PreVen*
Preo de venda
PedCli
Nmero do pedido no cliente
SeqPcl
Sequncia do pedido no cliente
CplIpd
Complemento da descrio do produto
CodDep
Cdigo do depsito
CodLot
Nmero do lote
QtdCan
Quantidade cancelada
DatEnt
Data da entrega
PerOfe
Percentual de oferta
PerDsc
Percentual de desconto
PerCom
Percentual de comisso
SitIpd
Situao do item
ResEst
Reserva estoque (S=sim, N=no)
IdxGrd
Indexador da Grade
CodFxa
Cdigo da faixa da grade
CodCcu
Cdigo do centro de custo
CtaRed
Cdigo da conta contbil reduzida
PerIpi
Percentual de IPI
PerIcm
Percentual de ICMS
PerIrf
Percentual de IRRF
PerCff
Percentual de COFINS
PerPif
Percentual de PIS
PerCrt
Percentual de COFINS Retido
PerPit
Percentual de PIS Retido
PerCsl
Percentual de CSLL Retido
NumPrj
Nmero do projeto
CodFpj
Cdigo da fase do projeto
CtaFin(n)*
Conta financeira
CtaRed(n)*
Conta contbil reduzida
CodCcu(n)*
Cdigo do centro de custo
PerCta(n)*
VlrCta(n)*
PerRat(n)*
VlrRat(n)*
VlrDsc
NumPrj(n)*
CodFpj(n)*
ObsRat(n)*
Retorno:
<SeqIpd>
Sequncia do item
* (n) = Sequncia incremental da linha do rateio, iniciando sempre em 1 (um) No utilizar os parnteses.
* Informar apenas o percentual ou valor.
* Utilizar estes campos para entrar com uma unidade de medida diferente da padro no informar QtdPed, PreUni.
Observao:
Esta ao aceita campos de usurio.
22222
* Utilizar estes campos para entrar com uma unidade de medida diferente da padro no informar QtdPed.
* Informando valor para esse campo, ser sobreposta qualquer sugesto feita com base nos dados gerais do pedido ou a partir do cdigo do
perodo de produo e venda.
* Ao informar o campo CodPvp o sitema faz automaticamente a busca da data final do perodo e atribui esta ao item de produto.
Retorno:
<SeqIpd>
Sequncia do item
Observao:
Esta ao aceita campos de usurio.
22222
Parmetros opcionais:
TnsSer
Transao para servios
PedCli
Nmero do pedido no cliente
SeqPcl
Sequncia do pedido no cliente
CplIsp
Complemeo da descrio do servio
QtdCan
Quantidade cancelada
DatEnt
Data da entrega
PerDsc
Percentual de desconto
PerCom
Percentual de comisso
SitIsp
Situao do item
CodCcu
CtaRed
PerIpi
PerIcm
PerIss
PerIns
PerIrf
PerCff
PerPif
PerCrt
PerPit
PerCsl
NumPrj
CodFpj
CtaFin(n)*
CtaRed(n)*
CodCcu(n)*
PerCta(n)*
VlrCta(n)*
PerRat(n)*
VlrRat(n)*
NumPrj(n)*
CodFpj(n)*
ObsRat(n)*
Retorno:
<SeqIsp>
Sequncia do item
* (n) = Sequncia incremental da linha do rateio, iniciando sempre em 1 (um) No utilizar os parnteses.
** Depende da parametrizao.
*** Informar apenas o percentual ou valor.
Observao:
Esta ao aceita campos de usurio.
22222
FECHAR PEDIDO
Ao:
SID.Ped.Fechar (RVPE)
Parmetros obrigatrios:
NumPed
Nmero do pedido
Parmetros opcionais:
RecPed
Recalcular o pedido (0=No*, 1=Sim-buscando valores, 2=Sim-sem buscar valores)
* Valor padro
Retorno:
"OK"
22222
22222
EXCLUIR PEDIDO
Ao:
SID.Ped.Excluir (RVPE)
Parmetros obrigatrios:
NumPed
Nmero do pedido
PedCli
Nmero do pedido do Cliente
Retorno:
"OK"
Observaes:
Se o parmetro NumPed for informado, no necessrio informar o PedCli, e vice-versa.
22222
Observao:
Esta ao aceita campos de usurio.
Parmetros opcionais:
CodEmp
Cdigo da empresa
CodFil
Cdigo da filial
Retorno:
"OK"
</pedido>
.
. (demais pedidos)
.
</pedidos>
A descrio de cada delimitador e sua funcionalidade ou obrigatoriedade est a seguir
<pedidos></pedidos>
Delimitadores da Sequncia de pedidos a serem importados. Indicam que dentro dos mesmos existe uma Sequncia de
pedidos a serem importados. Esses delimitadores so obrigatrios na estrutura.
<pedido></pedido>
Delimitadores de um pedido. Devem existir um para cada pedido, e dentro desses delimitadores devem estar os campos e
valores de um pedido. Esses delimitadores so obrigatrios na estrutura.
<codcli></codcli>
Dentro desses delimitadores deve estar o cdigo do cliente do pedido, que obrigatrio. Deve ser um cliente que esteja nos
cadastros de clientes de um contrato e ativo no contrato e no sistema.
<pedcli></pedcli>
Delimitadores do cdigo do nmero do pedido de cliente. opcional, porm se no contrato ou nas definies do cliente for
exigido que deve ser informado o nmero do pedido do cliente, a importao desse pedido exigir como consistncia esse campo. Se
o mesmo no vier informado, a importao do pedido ser cancelada, passando ao prximo pedido
<ctrcli></ctrcli>
Delimitadores onde deve estar o nmero do contrato do cliente para o pedido. Este campo opcional desde que nas
definies do cliente exista o cdigo do contrato padro para o cliente do pedido. Pode ser informado independentemente disto,
inclusive um nmero de contrato diferente do padro. Se informado, o sistema ir consistir se o contrato existe, est ativo, e possui
o cliente do pedido informado nos seus clientes. Se no for informado e no houver um contrato padro nas definies do cliente, ou
ocorrer algum erro de consistncia, a importao do pedido cancelada e ser passado ao prximo pedido.
<numemp></numemp>
Delimitadores do nmero de empenho do contrato. Este campo opcional, e no deve ser informado se o contrato no
controlado por empenho. Se o contrato controlar por empenho e este campo no for informado, ser gerado um erro de consistncia
informando que o contrato controla por empenho e o mesmo deve ser informado. Se o empenho informado for vlido, o sistema
consiste se o mesmo existe no contrato informado.
<datent></datent>
Delimitadores onde entre eles deve estar a data de entrega do pedido. Este campo opcional. Se no for informada,
sugerida a data corrente para o pedido. O valor atribudo a este campo (seja informado ou a data corrente), ser sugerido aos itens
se no for informada data de entrega nos mesmos. A data de entrega consistida com o perodo de inatividade do cliente do pedido
informado no contrato e se for controlado por empenho, ir consistir contra a validade do empenho.
<seqent></seqent>
Delimitador onde entre eles deve estar cdigo do endereo de entrega do pedido. Este campo opcional, mas se no
cadastro de filial vendas estiver definido que o pedido deve conter o endereo de entrega esse campo obrigado a ser informado.
<itens></itens>
Delimitadores que indicam que dentro dos mesmos existe uma Sequncia de itens do pedido a serem importados. Esses
delimitadores so obrigatrios na estrutura e devem estar dentro dos delimitadores <pedido></pedidos>.
<item></item>
Delimitador que indica a existncia de um item de pedido a ser importado. Dentro desses delimitadores deve estar a
Sequncia de campos e valores do item do pedido a importar. Esses delimitadores so obrigatrios na estrutura e devem ser
internos aos delimitadores <itens></itens>.
pedido.
Os delimitadores abaixo devem estar dentro dos delimitadores <item></item> e se referem aos campos dos itens do
<procli></procli>
Delimitadores onde deve estar o cdigo do produto do cliente para o contrato atual. A funcionalidade dessse campo em
conjunto com a funcionalidade do campo cdigo do produto, e documentada logo a seguir documentao deste campo, logo
abaixo.
<codpro></codpro>
Delimitadores onde deve estar o cdigo do produto do Sapiens para o contrato atual
Ao menos um dos cdigos de produto acima deve ser informado. Tambm ambos podem ser informados ao mesmo tempo,
mas a precedncia ou o que ocorre em caso de erro descrita a seguir:
a) Se ambos forem informados, o sistema busca primeiramente o cdigo do produto do cliente e o cdigo
associado ao produto Sapiens. Se este existir, o cdigo do produto do Sapiens ignorado. Se no existir o cdigo
do produto do cliente, o sistema utiliza o cdigo do produto do Sapiens. Se estiver correto assumido o cdigo do
produto Sapiens e caso contrrio o sistema gera um erro e interrompe a importao do pedido atual, passando ao
prximo pedido.
b) Se apenas o cdigo do produto do cliente for informado, e se este existir, utilizado, sendo que o sistema busca
o cdigo do produto do Sapiens associado. Caso contrrio gerado um erro e interrompida a importao do pedido
atual, passando ao prximo pedido.
c) Se apenas o cdigo do produto do Sapiens for informado, e se este existir, utilizado. Caso contrrio gerado
um erro e interrompida a importao do pedido atual, passando ao prximo.
<datent></datent>
Delimitadores onde deve estar a data de entrega do item do pedido. O valor do campo opcional, pois sugerido por
padro a data de entrega dos dados gerais do pedido. Porm est disponvel para o caso em que seja necessrio possuir itens com
datas de entrega diferentes em um mesmo pedido, sobrescrevendo a sugesto dos dados gerais do pedido.
<qtdped></qtdped>
Delimitadores da quantidade pedida do item. O valor nesse campo obrigatrio (deve ser igual a zero quando informa-se
valores para a unidade de medida de venda) e se no for informado gerado um erro e interrompida a importao do pedido atual,
passando ao prximo pedido. O valor informado consistido contra a quantidade mnima e mxima do item do contrato, e com o
saldo de quantidade desse item no contrato.
<univen></univen>
Delimitadores da unidade de medida de venda do item. O valor nesse campo opcional, no entanto, caso for informado, a
quantidade de venda e o preo de venda devem obrigatoriamente ser informados tambm.
<qtdven></qtdven>
Delimitadores da quantidade de venda do item. O valor nesse campo opcional, no entanto, deve ser informado caso uma
unidade de medida de venda seja informada para o item. O valor informado consistido e a converso para a unidade de estoque
(quantidade pedida) feita automaticamente pelo sistema. A quantidade pedida ento consistida contra a quantidade mnima e
mxima do item do contrato, e com o saldo de quantidade desse item no contrato.
<preven></preven>
Delimitadores do preo de venda do item. O valor nesse campo opcional, no entanto, deve ser informado caso a unidade
de medida de venda seja informada para o item.
Retorno da ao
O retorno da ao um texto tambm em formato XML, dentro dos delimitadores <retorno></retonro>. Dentro desses
delimitadores indicado o erro ou o sucesso na importao para cada pedido dentro da Sequncia de pedidos, ordenados
numericamente pela Sequncia de entrada e iniciando em 1 (um) e envolvidos nos delimitadores <pedido ></pedido>. O nmero
de ordenao exibido no retorno no o nmero de pedido no Sapiens.
O formato geral do retorno para um pedido :
<retorno>
<pedido pedido= 'Sequncia_do_pedido' [item='Sequncia_do_item'] resultado='erro ou sucesso'>texto do
erro
ou nmero do pedido</pedido>
.
.
.
(demais pedidos)
</retorno>
delimitadores <pedido></pedido>
'nmero_pedido_sapiens' o nmero do pedido gerado pelo Sapiens
Com sucesso:
<retorno><pedido pedido='2' resultado='sucesso'>numero pedido gerado = 12</pedido></retorno>
.
</campos_usuario >
</pedido>
<pedido>
</pedido>
.
.
.
.
<pedido>
<pedidos>
Dentro desses delimitadores deve estar o cdigo da Sequncia do endereo de cobrana do cliente, que opcional, a no
ser que seja exigido se o cliente possuir mais de um endereo de cobrana.
<seqcto></seqcto>
Dentro desses delimitadores deve estar o cdigo da Sequncia do cdigo do contato do cliente, que opcional.
<codven></codven>
Dentro desses delimitadores deve estar o cdigo do vendedor do pedido, que opcional. Se no for informado, ser
utilizado o cdigo do vendedor nas definies do cliente.
<codtra></codtra>
Dentro desses delimitadores deve estar o cdigo da transportadora do pedido, que opcional. Se no for informado, ser
utilizado o cdigo da transportadora nas definies do cliente. Pode ser informado com vazio, sobrescrevendo a sugesto padro.
<codred></codred>
Dentro desses delimitadores deve estar o cdigo da transportadora de redespacho do pedido, que opcional. Se no for
informado, ser utilizada a sugesto do sistema para o redespacho. Pode ser informado com vazio, sobrescrevendo a sugesto
padro.
<cepfre></cepfre>
Dentro desses delimitadores deve estar o cdigo do CEP de frete para o pedido, que opcional. Se no for informado, ser
utilizado a sugesto do sistema. Pode ser informado com vazio, sobrescrevendo a sugesto padro.
<codfpg></codfpg>
Dentro desses delimitadores deve estar o cdigo da forma de pagamento para o pedido, que opcional. Se no for
informado, pode ser exigido se no cadastro do usurio existir um parmetro que obriga a informao desse campo.
<itens></itens>
Delimitadores que indicam que dentro dos mesmos existe uma Sequncia de itens grade do pedido a serem importados.
Esses delimitadores so obrigatrios na estrutura e devem estar dentro dos delimitadores <pedido></pedidos>.
<item></item>
Delimitador que indica a existncia de um item grade de pedido a ser importado. Dentro desses delimitadores deve estar a
Sequncia de campos e valores do item grade do pedido a importar. Esses delimitadores so obrigatrios na estrutura e devem ser
internos aos delimitadores <itens></itens>.
Os delimitadores abaixo devem estar dentro dos delimitadores <item></item> e se referem aos campos dos itens do
pedido.
<codpro></codpro>
Delimitadores onde deve estar o cdigo do produto. Este campo obrigatrio, e pode ser um cdigo de produto que no
existe. Se no existir, so exigidos o cdigo da famlia e cdigo do modelo no documento XML, pois sem os quais no possvel
gerar o cdigo do novo produto. O novo produto ser gerado dentro das condies do sistema, avaliando se a montagem e estrutura
do mesmo esto corretas.
<codfam></codfam>
Delimitadores onde deve estar o cdigo da famlia do produto. Este campo obrigatrio apenas se o produto for um novo
produto (no existente no sistema). Pode ser informado mesmo que o produto seja j existente, pois no ser considerado se o
produto j existir.
<codmod></codmod>
Delimitadores onde deve estar o cdigo do modelo de produo ligado ao produto. Este campo obrigatrio apenas se o
produto for um novo produto (no existente no sistema). Pode ser informado mesmo que o produto seja j existente, pois no ser
considerado se o produto j existir.
<codfxa></codfxa>
Delimitadores onde deve estar o cdigo da faixa do produto. Este campo obrigatrio.
<codpgr></codpgr>
Delimitadores onde deve estar o cdigo da proporcionalidade da faixa do produto. Este campo no obrigatrio. Se for
informado, o sistema ir desconsiderar caso estejam sendo passadas derivaes e quantidades logo abaixo dos delimitares
<derivacoes></derivacoes> no item atual, e ir gerar o item com as derivaes da proporcionalidade. Se no for passado,
obrigatria a passagem de valores dentro dos delimitadores <derivacoes></derivacoes>. Nesse caso o sistema ir avaliar as
derivaes corretamente e buscar ou gerar uma nova proporcionalidade conforme as derivaes passadas.
<qtdgrd></qtdgrd>
Delimitadores onde deve estar a quantidade de grades do item do pedido. opcional, sendo assumido o valor 1 se no for
informado. Se ocorrer a exploso de grades, o mesmo desconsiderado.
<codclc></codclc>
Delimitadores onde deve estar o valor do campo coleo do item. Se a coleo no for informada, sugerida a coleo
padro do produto.
<derivacoes></derivacoes>
Delimitadores onde devem estar internamente a eles as derivaes e respectivas quantidades de cada derivao. Os valores
internos a esses delimitadores so considerados sempre que no for informada uma proporcionalidade para o item grade do pedido.
Dentro dos delimitadores, para cada par derivao/quantidade, devem existir so seguintes delimitadores:
<derivacao></derivacao>
Dentro desses delimitadores deve estar informado um cdigo de derivao do produto.
<quantidade></quantidade>
Dentro desses delimitadores deve estar informada a quantidade da derivao imediatamente anterior
Os dois delimitadores acima devem ser sempre em pares, com a derivao em primeiro e em seguida a sua respectiva
quantidade. Se no existirem em forma de pares o sistema ir gerar erro e a importao do pedido atual no ser feita.
<observacoes></observacoes>
Delimitadores da Sequncia de observaes a serem importadas para o pedido. Devem estar dentro dos delimitadores
<pedido></pedido>. Indicam que dentro dos mesmos existe uma Sequncia de observaes a serem importados. Esses
delimitadores no so obrigatrios na estrutura. ignorada se no existirem as Sequncias de observaes.
<observacao></observacao>
Delimitadores de uma observao do pedido. Para cada observao deve existir um delimitador destes. Dentro desses
delimitadores estaro os campos de observao permitidos para importao, que esto descritos a seguir. Cada item observao
gravado como uma observao manual na tabela de observaes do pedido atual. A situao da observao G (gravada). Se no
existirem delimitadores internos a esse delimitador, no gravada observao. Observao: se for utilizado o controle de bloqueio
por rea na filial e o parmetro E:AGRINGS no aplicativo, as observaes so geradas com a rea da empresa VEN (vendas) e no
aprovadas.
<obsped></obsped>
Texto de uma observao do pedido. opcional, sendo ignorado se no existir valor ou o valor for vazio e no existir o
cdigo do motivo da observao. Se existir apenas o cdigo do motivo, a observao gravada em branco.
<codmot></codmot>
Cdigo do motivo de uma observao do pedido. opcional, sendo ignorado se no existir valor ou o valor for vazio.
<campos_usuario></campos_usuario>
Delimitadores de campos de usurio a serem importadas para o pedido. Devem estar dentro dos delimitadores
<pedido></pedido>. Indicam que dentro dos mesmos existe campos de usurio a serem importados. Esses delimitadores no so
obrigatrios na estrutura. ignorada se no existirem os campos de usurios.
<campo_usurio></campo_usurio>
Delimitadores de um campo de usurio do pedido. Para cada campo de usurio deve existir um delimitador destes. Dentro
desses delimitadores estaro os valores dos campos de usurio permitidos para importao, que esto descritos a seguir.
<nomcmp></nomcmp>
Nome do campo de usurio do pedido na base de dados. obrigatrio, uma vez que seu valor usado para encontrar o
campo de usurio onde o valor deve ser inserido.
<vlrcmp></vlrcmp>
Valor do campo de usurio do pedido na base de dados. obrigatrio e representa o valor do campo de usurio a ser
importado para a base de dados. Para campos numricos ou hora deve ser informado apenas o valor inteiro. Para campos de valor
real deve ser informado o valor com vrgula. Para campos texto ou data, deve ser informado por extenso, sem aspas simples ou
dupla.
Parmetros no obrigatrios:
ManErrFec
Indica que, se ocorrer erro no fechamento, o pedido no deva ser descartado, apenas gerado sem fechar.
O nmero de pedido gerado, a situao (no fechado) e o erro ocorrido no fechamento sero evidenciados no retorno.
ManErrIte
Indica que, se ocorrer erro na gerao de um item de pedido, o pedido no deva ser descartado, e os
demais itens devam ser processados normalmente, sem interromper todo o processo do pedido a ser importado. O pedido ser
apenas gerado sem fechar. O nmero de pedido gerado, a situao (no fechado) e os erros ocorridos nos itens sero evidenciados
no retorno.
Retorno da ao
O retorno da ao um texto tambm em formato XML, dentro dos delimitadores <retorno></retonro>. Dentro desses
delimitadores indicado o erro ou o sucesso na importao para cada pedido dentro da Sequncia de pedidos, ordenados
numericamente pela Sequncia de entrada e iniciando em 1 (um) e envolvidos nos delimitadores <pedido ></pedido>. O nmero
de ordenao exibido no retorno no o nmero de pedido no Sapiens.
O formato geral do retorno para um pedido :
erro
<retorno>
<pedido pedido= 'Sequncia_do_pedido' [item='Sequncia_do_item'] resultado='erro ou sucesso'>texto do
ou nmero do pedido</pedido>
.
.
.
.
(demais pedidos)
'Sequncia_do_item'
o nmero de Sequncia do item grade que est sendo processado dentro do pedido, caso o erro tenha
ocorrido em um item delimitado pelos delimitadores <itens></itens>. A Sequncia do item reiniciada
para cada pedido. Se o erro for gerado pelos dados gerais ou outra consistncia no fechamento do
pedido e validao dos valores contra o contrato, esse texto no exibido.
'texto_do_erro'
a informao textual do erro ocorrido pela consistncia ou pela verificao da estrutura do comando
XML para um pedido.
'nmero_pedido_sapiens'
'fechado ou no fechado'
ir exibir o valor 'fechado' quando o pedido for fechado com sucesso ou 'no fechado' caso o
parmetro ManErrFec for igual a 'S' e ocorrer erro no fechamento do pedido, sendo este apenas
gravado
(sem os colchetes) ir ser exibido somente caso o parmetro ManErrFec for igual a 'S' e ocorre erro
no fechamento do pedido, evidenciando o motivo do no fechamento do pedido, caso em que ser
apenas gravado e no descartado o pedido
O formato do retorno quando do uso do parmetro no obrigatrio ManErrIte para um determinado pedido com sucesso
durante a importao do pedido (dados gerais, itens do pedido e fechamento) :
<pedido pedido = 'Sequncia_do_pedido' resultado='sucesso'> <mensagem> informaes sobre o pedido
gerado pelo Sapiens </mensagem> </pedido>
O formato do retorno quando do uso do parmetro no obrigatrio ManErrIte para um determinado pedido com erro no
fechamento ou na gerao do pedido, durante a importao :
<pedido pedido = 'Sequncia_do_pedido' resultado = 'erro'> <mensagem> texto_do_erro </mensagem>
</pedido>
O formato do retorno quando do uso do parmetro no obrigatrio ManErrIte para um determinado pedido com erro nos
itens, durante a importao :
<pedido pedido = 'Sequncia_do_pedido' resultado = 'sucesso no pedido, com erros na gravao dos itens'>
<mensagem> <itens> <item item= 'Sequncia_do_item_do_pedido'> texto_do_erro_do_item </item> </itens>
</mensagem> </pedido>
O formato do retorno quando do uso do parmetro no obrigatrio ManErrIte para um determinado pedido com erro no
fechamento do pedido e erros nos itens, durante a importao :
<pedido pedido = 'Sequncia_do_pedido' resultado = 'erro no pedido, com erros na gravao dos itens'>
<mensagem> texto_do_erro_do_pedido </mensagem> <itens> <item item= 'Sequncia_do_item_do_pedido'>
texto_do_erro_do_item </item> </itens> </pedido>
Documentaes adicionais:
Dentro dos delimitadores <pedidos></pedidos> podero ser informados vrios pedidos e dentro de cada delimitador
<itens></itens> devem ser informados os vrios itens do pedido. A ao pode ser chamada individualmente para um pedido
apenas, porm recomenda-se a utilizao de vrios pedidos dentro de uma nica ao, que confere um desempenho melhor
importao.
A funo ir processar pedido a pedido que estiver dentro dos delimitadores <pedidos></pedidos>. Caso ocorra um erro
em um pedido, este pedido todo descartado e a funo segue processando o prximo pedido na Sequncia. O pedido gerado
automaticamente fechado. Se ocorrer erro no fechamento, o pedido descartado, a no ser que exista o parmetro ManFecErr igual
a 'S', que no caso ir apenas gravar o pedido se houver erro no fechamento. Ao final, ser gerado o retorno da funo indicando,
para cada pedido com sucesso gerado, o seu nmero e para cada pedido no processado, o erro correspondente, na mesma
Sequncia que foi informada no documento XML.
A rotina possui o mesmo funcionamento da rotina da tela do Comercial\Vendas\Pedidos\Via Grade de Produto, gerando
pedidos fechados. A filial e empresa em que so gerados os pedidos so o da filial logada no Sapiens Server e no permitido
indicar filial ou empresa na ao.
Em relao ao documento XML a ser enviado ao, este deve ser plano, ou seja, sem quebras de linha e sem espaos
entre os delimitadores. Os valores dentro dos delimitadores podem ter espaos entre os mesmos, desde que o valor no seja
numrico.
Segue um exemplo de uma ao com um pedido e dois itens:
acao=sid.ped.gravarpedidograde
sidxml=
<pedidos>
<pedido>
<codmar>SUPERMARCA</codmar>
<codcli>3</codcli>
<codrep>3</codrep>
<itens>
<item>
<codpro>FCAL00010017</codpro>
<codfxa>FAIXA DE CAL 01</codfxa>
<derivacoes>
<derivacao>33</derivacao>
<quantidade>1</quantidade>
<derivacao>34</derivacao>
<quantidade>2</quantidade>
<derivacao>35</derivacao>
<quantidade>2</quantidade>
<derivacao>36</derivacao>
<quantidade>5</quantidade>
</derivacoes>
</item>
<item>
<codpro>FCAL00010011</codpro>
Com sucesso:
<retorno><pedido pedido='2' resultado='sucesso'>numero pedido gerado = 1050</pedido></retorno>
Observaes:
necessrio informar apenas um parmetro, porm possvel informar os dois.
GRAVAR COTAO
Ao:
SID.Cot.Gravar (SCCP)
Parmetros obrigatrios:
NumSol
Nmero da solicitao
SeqSol
Sequncia da solicitao
CodFor
Cdigo do fornecedor
QtdCot
Quantidade cotada
PreCot
Preo da cotao
PrzEnt
Prazo de entrega
Parmetros opcionais:
TipRet
Tipo de retorno da ao, quando bem sucedida (ver Retorno para mais detalhes)
DscCot
Percentual de Desconto
IpiCot
Percentual de IPI
IcmCot
Percentual de ICMS
CodCpg
Condio de pagamento
DatPrv
Data de previso de entrega
ObsCot
Observao da cotao de preo de compra
CifFob
Indicativo se o frete CIF ou FOB
Retorno:
Se o parmetro TipRet (tipo de retorno da ao) for:
- 0 (padro): "OK"
- 1: <NumCot>/<SeqCot> (Nmero e Sequncia da cotao gerada)
CodEmb
QtdEmb
PesBru
PesLiq
PerDs1
PerDs2
PerDs3
PerDs4
PerEnc
PerFre
ObsNfv
VlrDar
PrcNfv
PreImp
PlaVei
TraMtr
CodMtr
PerDs1
PerDs2
PerDs3
PerDs4
PerDs5
VlrPar(n)*
VctPar(n)*
GerBai(n)*
TnsBai(n)*
Cdigo da embalagem
Quantidade de embalagens
Peso bruto
Peso lquido
Percentual de desconto-1
Percentual de desconto-2
Percentual de desconto-3
Percentual de desconto-4
Percentual de encargos
Percentual do frete
Observao da nota
Valor de arredondamento (- desconto, + acrscimo)
Procedncia da nota
Nmero pr-impresso do formulrio da nota fiscal
Placa do veculo da nota fiscal
Transportadora do motorista
Cdigo do motorista
Percentual de desconto 1 do cliente
Percentual de desconto 2 do cliente
Percentual de desconto 3 do cliente
Percentual de desconto 4 do cliente
Percentual de desconto 5 do cliente
Valor da parcela a ser gerada**
Data de vencimento da parcela**
Indica se liquida o ttulo imediatamente aps sua gerao (S=sim, N=no)
Transao utilizada para baixar o ttulo
Retorno:
<NumNfv>
Observaes:
Somente incluso de notas fiscais tipo 1. Outros tipos podem ser includos, mas tipos de notas que possuem composio
ou ligaes com outras tabelas no sero contemplados de forma automtica.
Esta ao aceita campos de usurio.
22222
Parmetros opcionais:
NumIni
Nmero da nota fiscal inicial (fechamento agrupado)
NumFim
Nmero da nota fiscal final (fechamento agrupado)
DatIni
Data inicial para fechamento (fechamento agrupado)
DatFim
Data final para fechamento (fechamento agrupado)
RecNot
Indicativo para recalcular nota (0=no, 1=sim*)
BusVal
Indicativo para buscar valores (0=no, 1=sim*)
GerNfe
Indicativo para gerar arquivo de notas fiscais eletrnicas (0=no*, 1=sim, 2=Somente gera o
arquivo eletrnico)
MsgBlo
Indicativo se deve exibir o motivo do bloqueio no retorno
(0=no*, 1=sim)
* Valor padro
Retorno:
"OK"
22222
* Valor padro
Retorno:
"OK"
Observao:
O parmetro ExcUlt somente ir excluir a nota fiscal de sada se ela estiver com situao de digitao (E140Nfv.SitNfv = 1),
alm de ser a ltima nota da srie fiscal.
22222
22222
"OK"
Observao:
Esta ao aceita campos de usurio.
O parmetro PreUni torna-se opcional quando CodTpr informado. Ao informar CodTpr no necessrio informar
PreUni, pois o preo unitrio passado(PreUni) ser substitudo pelo valor unitrio da tabela de preo.
Caso o cliente da nota possua uma tabela de preo associada nas suas definies, PreUni e CodTpr no precisam ser
informados, pois o sistema busca a tabela de preo das definies do cliente e atribui para o item. Com isso o sistema busca o preo
unitrio do item conforme tabela de preo.
Quando for enviada a alquota de ICMS como parmetro, o cdigo de ICMS Especial da transao ou do produto ser
ignorado e a alquota de ICMS enviada ser mantida.
22222
O parmetro PreUni torna-se opcional quando CodTpr informado. Ao informar CodTpr no necessrio informar
PreUni, pois o preo unitrio passado(PreUni) ser substitudo pelo valor unitrio da tabela de preo.
Caso o cliente da nota possua uma tabela de preo associada nas suas definies, PreUni e CodTpr no precisam ser
informados, pois o sistema busca a tabela de preo das definies do cliente e atribui para o item. Com isso o sistema busca o preo
unitrio do item conforme tabela de preo.
Quando for enviada a alquota de ICMS como parmetro, o cdigo de ICMS Especial da transao ou do servio ser
ignorado e a alquota de ICMS enviada ser mantida.
22222
CANCELAR FATURA
Ao:
SID.Nfv.CancelarFatura (RFNF)
Parmetros obrigatrios:
NumNff
Nmero da fatura a ser cancelada
Retorno:
"OK"
22222
Observaes:
Alm de listar as embalagens de uma nota, essa ao verifica o controle de embarque. Passando-se 0 no parmetro
NumEbq um novo nmero de controle de embarque gerado e retornado, seno consistida a existncia de um controle de
embarque com tal nmero.
22222
Observaes:
Antes dessa ao deve ser executada a SID.Nfv.ListarEmbCtrlEbq, que se encarregar de gerar um nmero de controle de
embarque, devendo este ser passado para esta ao pelo parmetro NumEbq.
Observao:
1 - Campos obrigatrios de um retorno de NF-e autorizada, cancelada, denegada ou inutilizada.
2 - Campos obrigatrios de um retorno de problema na solicitao de autorizao/cancelamento/inutilizao.
* DesMot[x] s vlido para retorno de problema na solicitao de autorizao ou problema na solicitao de
cancelamento/inutilizao.
Quando a situao do documento for 7- Solicitado Cancelamento e o SitNel informado for 3- Autorizado o sistema ir
alterar internamente esse valor para 9- Cancelada por motivo de compatibilidade com o evento de cancelamento.
**TipDoe pode ser 5 Evento de Cancelamento, 6 Cincia da Operao, 7 Confirmao da Operao, 8 Operao no
Realizada ou 9 Manifesto Eletrnico de Documentos Fiscais.
*** TipCtg de preenchimento obrigatrio quando for autorizao em contingncia (SitNel = 16 Autorizao em
Contingncia).
3 - ChvCtg de preenchimento obrigatrio quando for autorizao em contingncia (SitNel = 16 Autorizao em
Contingncia) e o TipCtg for igual a 5 FS-IA ou 6 FS-DA.
O uso desta ao SID exclusivo para clientes que possuem a integrao IENF (Nota Fiscal Eletrnica) ativada em sua
proprietria.
4 - Para que seja feito o retorno de uma contingncia via ao SID necessrio que seja informado a Chave da
Contingncia(ChvCtg) e o Tipo de Contingncia(|TipCtg) pois quando esses campos so informados utilizado o webservice
de Importao de Retorno verso 4. Quando esses campos no so informados o sistema utiliza a verso 2.
No retorno da CC-e s podero ser informadas as situaes: 3- Autorizada, 4 Rejeitada , 5 Denegada e 10=Erro
Gerao.
Ao informar SeqEve assume-se que a solicitao se trata de uma CC-e.
Documentaes adicionais:
Retornos esperados na nota fiscal eletrnica.
Situao do
documento no
Sapiens
Retorno esperado
2 = Enviada
3 = Autorizada
2 = Enviada
4 = Rejeitada
2 = Enviada
5 = Denegada
2 = Enviada
10 = Erro Gerao
6 = Solicitado
Inutilizao
6 = Solicitado
Inutilizao
8 = Inutilizada
12 = Erro Solicitao
Inutilizao
7 = Solicitado
Cancelamento
9 = Cancelada
7 = Solicitado
Cancelamento
11 = Erro Solicitao
Cancelamento
Retorno esperado
2 = Enviada
3 = Autorizada
2 = Enviada
4 = Rejeitada
2 = Enviada
5 = Denegada
2 = Enviada
10 = Erro Gerao
Retorno esperado
2 = Enviada
2 = Enviada
3 = Autorizada
4 = Rejeitada
2 = Enviada
10 = Erro de gerao
Retorno esperado
2 = Enviada
3 = Autorizada
2 = Enviada
4 = Rejeitada
2 = Enviada
10 = Erro gerao
Caso ocorra uma situao totalmente incomum, como por exemplo a situao do documento no Sapiens ser 3 = Autorizada,
e receber um retorno 3 = Autorizada ser retornada a mensagem "No foi solicitado um retorno para esse documento
eletrnico. ".
Retorno esperado
2 = Enviada
3 = Autorizada
2 = Enviada
4 = Rejeitada
2 = Enviada
5 = Denegada
2 = Enviada
10 = Erro Gerao
6 = Solicitado
Inutilizao
6 = Solicitado
Inutilizao
7 = Solicitado
Cancelamento
7 = Solicitado
Cancelamento
8 = Inutilizada
12 = Erro Solicitao
Inutilizao
9 = Cancelada
11 = Erro Solicitao
Cancelamento
Retorno esperado
2 = Enviada
3 = Autorizada
2 = Enviada
4 = Rejeitada
2 = Enviada
10 = Erro de gerao
Caso ocorra uma situao totalmente incomum, como por exemplo a situao do documento no Sapiens ser 3 = Autorizada,
e receber um retorno 3 = Autorizada ser retornada a mensagem "No foi solicitado um retorno para esse documento
eletrnico. ".
Retorno esperado
2 = Enviada
3 = Autorizada
2 = Enviada
4 = Rejeitada
2 = Enviada
10 = Erro Gerao
7 = Solicitado
Cancelamento
7 = Solicitado
Cancelamento
9 = Cancelada
11 = Erro Solicitao
Cancelamento
PesLiq
PerDs1
PerDs2
PerFin
VlrDzf
VlrFre
VlrDs1
VlrDs2
VlrDar
VlrFin
NumLot
VlrInf
IntImp
TipNdi
NumDoi
DatDoi
LocDes
DatDes
UfsDes
CodExp
VlrFei
VlrSei
VlrOui
CifFob
SomFre
CodSel
CodSsl
ChvNel
DatParSid
VlrBic
VlrIbs
VlrIcm
VlrIsn
VlrSeg
VlrEmb
VlrEnc
VlrOut
VlrFrd
VlrOud
Retorno:
<NumNfc>
Nmero da nota
Observaes:
* Somente incluso de notas fiscais tipo 1.
* Outros tipos podem ser includos, mas tipos de notas que possuem composio ou ligaes com outras tabelas no sero
contemplados de forma automtica. de responsabilidade do desenvolvedor que ir utilizar as aes SID de nota fiscal de entrada
cujo tipo for diferente de 1 (no contemplado) definir todos os campos de ligao, tabelas relacionadas, valores, enfim tudo que o
sistema faz de forma automtica quando utilizado a tela em si.
* Valor financeiro dos dados gerais da nota fiscal de entrada (VlrFin) ser sempre o somatrio do (VlrFin) dos itens de
produto / servio, portanto no h necessidade de aliment-lo na ao SID dos dados gerais. Por uma questo de compatibilidade o
campo ser mantido no layout. O seu zeramento ocorre internamente para que o somatrio ocorra durante a insero dos itens.
* Aceita campos de usurio.
* Os valores diversos (exemplo: Frete, Arredondamento, Encargos e etc) devem ser informados nos dados gerais da nota.
A distribuio para os itens se d no fechamento da nota fiscal de entrada (para os processos SID e Webservice), na digitao
ocorre conforme a insero dos itens pelo usurio. As informaes destes valores nos itens tambm possvel (a ao SID produto
e servio permitem), porm a soma dos valores atribudos aos itens deve bater com o valor informado nos dados gerais, do
contrrio haver uma redistribuio baseada no valor informado nos dados gerais. Independente de reclculo da nota (RecNot).
PreUni
Parmetros opcionais:
SeqIpc
Sequncia do item na nota fiscal de entrada
NopPro
Cdigo da natureza de operao
FilOcp
Cdigo da filial da ordem de compra
NumOcp
Nmero da ordem de compra da nota fiscal de entrada
SeqIpo
Sequncia do item na ordem de compra da nota fiscal de entrada
CodClf
Cdigo da classificao fiscal do item da nota fiscal de entrada
OriMer
Origem fiscal da mercadoria
CodStr
Situao tributria do item da nota fiscal de entrada
CodTic
Cdigo do ICMS especial
CodTrd
Cdigo de reduo de impostos
CodTst
Cdigo do ICMS substitudo
CodStp
Cdigo de substituio do PIS
CodStc
Cdigo de substituio do COFINS
CodDep
Cdigo do depsito para entrada de estoque do produto
CodLot
Cdigo do lote de estocagem
DatVlt
Data de validade do lote
UniNfc
Cdigo da unidade de medida da nota fiscal de entrada
QtdAjb
Quantidade de Ajuste de Balana para Efeito de Estoque
QtdDev
Quantidade devolvida do item da nota fiscal de entrada
UniMed
Unidade de medida de estoque do item da nota fiscal de entrada
QtdEst
Quantidade de entrada conforme unidade de medida de estoque
VlrFum
Valor do frete por unidade de medida quando CIF
QtdFre
Quantidade base na unidade do produto valida para o valor do frete
ForFre
Cdigo do fornecedor para gerao ttulo de frete
PesBru
Peso bruto do item da nota fiscal de entrada
PesLiq
Peso lquido do item da nota fiscal de entrada
PreEst
Preo do item conforme unidade de medida de estoque
PreBas
Preo unitrio base para o movimento de estoque
PerDsc
Percentual de desconto do item da nota fiscal de entrada
PerDs3
Percentual de desconto 3
PerDs4
Percentual de desconto 4
PerDs5
Percentual de desconto 5
PerIpi
Percentual de IPI do item da nota fiscal de entrada
PerIcm
Percentual do ICMS do item da nota fiscal de entrada
PerIsn
Percentual do ICMS Simples Nacional do item da nota fiscal de entrada
PecIcm
Percentual de ICMS creditado efetivamente
PerFun
Percentual do Funrural ou INSS
NumPrj
Nmero do projeto
CodFpj
Cdigo da fase do projeto
CtaFin
Conta financeira reduzida
CtaRed
Conta contbil reduzida
CodCcu
Cdigo do centro de custo
VlrFre
Valor frete
VlrSeg
Valor do seguro
VlrEmb
Valor embalagem
VlrEnc
Valor encargos financeiros
VlrOut
Valor outras despesas
VlrDar
Valor para arredondamento
VlrFrd
Valor frete destacado
VlrOud
Valor outras despesas destacado
VlrBru
Valor bruto do item da nota fiscal de entrada
VlrDsc
Valor do desconto do item da nota fiscal de entrada
VlrDs1
Valor do desconto 1
VlrDs2
Valor do desconto 2
VlrDs3
Valor de desconto 3
VlrDs4
Valor de desconto 4
VlrDs5
Valor de desconto 5
VlrDzf
Valor do desconto referente zona franca
VlrBfu
Valor base do Funrural ou INSS
VlrFun
Valor do Funrural ou INSS
VlrBip
Valor base IPI
VlrIpi
Valor do IPI do item da nota fiscal de entrada
VlrBid
Valor base IPI presumido (50% compra no comrcio)
VlrIpd
Valor do IPI presumido (50% compra no comrcio)
VlrBic
Valor base do ICMS
VlrIbs
Valor base do ICMS Simples Nacional
VlrIcm
Valor do ICMS do item da nota fiscal de entrada
VlrIsn
Valor do ICMS Simples Nacional do item da nota fiscal de entrada
VlrDfa
Valor da diferena de alquota inter-estadual
VlrBsi
Valor base ICMS substitudo
VlrIcs
Valor do ICMS substitudo do item da nota fiscal de entrada
VlrBsd
Valor base ICMS substitudo destacado
VlrIsd
Valor ICMS substitudo destacado
VlrBsp
Valor base da substituio tributrio do PIS
VlrStp
VlrBsc
VlrStc
VlrIip
VlrIic
VlrOip
VlrOic
VlrLpr
VlrLou
VlrLiq
VlrFin
AcrFin
EmpNfv
FilNfv
SnfNfv
NumNfv
SeqIpv
CodFab
NumEpi
VlrBpi
VlrPis
FilCtr
NumCtr
SeqCcp
VlrBcr
VlrCor
PerIim
VlrBii
VlrIim
VlrRis
PerPit
VlrBpt
VlrPit
PerCrt
VlrBct
VlrCrt
PerCsl
VlrBcl
VlrCsl
PerOur
VlrBor
VlrOur
PerIrf
VlrBir
VlrIrf
PerDs1
PerDs2
BecIpi
VecIpi
BecIcm
VecIcm
VlrFei
VlrSei
VlrOui
BcoImp
CofImp
BpiImp
PisImp
VlrBpf
PerPif
VlrPif
VlrBcf
PerCff
VlrCff
IgnOcp
RecNot
NumAdi
SeqAdi
DscAdi
FabEst
BasCre
DatParSid
CodFam
CodTpr
CplIpc
SalCan
QtdBpf
QtdBcf
AliPif
AliCff
CstPis
CstCof
CstIpi
VlrImp
CoeFci
CodFci
Retorno:
<SeqIpc>
Observao:
Esta ao aceita campos de usurio.
* Os valores diversos (exemplo: Frete, Arredondamento, Encargos e etc) devem ser informados nos dados gerais da nota.
A distribuio para os itens se d no fechamento da nota fiscal de entrada (para os processos SID e Webservice), na digitao
ocorre conforme a insero dos itens pelo usurio. As informaes destes valores nos itens tambm possvel (a ao SID produto
e servio permitem), porm a soma dos valores atribudos aos itens deve bater com o valor informado nos dados gerais, do
contrrio haver uma redistribuio baseada no valor informado nos dados gerais. Independente de reclculo da nota (RecNot).
NumNfv
NumEpi
CodClf
OriMer
CodStr
CodTic
CodTrd
CodTst
PerIpi
PerIcm
PerIsn
VlrDzf
VlrBip
VlrIpi
VlrBid
VlrIpd
VlrBic
VlrIbs
VlrIcm
VlrIsn
VlrDfa
VlrBsi
VlrIcs
VlrBsd
VlrIsd
VlrIip
VlrIic
VlrOip
VlrOic
VlrBpi
VlrPis
FilCtr
NumCtr
VlrBcr
VlrCor
VlrBct
VlrCrt
PerCrt
VlrBpt
VlrPit
PerPit
VlrBcl
VlrCsl
PerCsl
VlrBor
VlrOur
PerOur
VlrRis
PerDs1
PerDs2
PerDs3
PerDs4
PerDs5
VlrDs3
VlrDs4
VlrDs5
BecIpi
VecIpi
BecIcm
VecIcm
PecIcm
VlrBie
VlrIem
VlrOui
BcoImp
CofImp
BpiImp
PisImp
SeqIsp
VlrBpf
PerPif
VlrPif
VlrBcf
PerCff
VlrCff
IgnOcp
RecNot
BasCre
DatParSid
NumNfv
SeqIsv
QtdBpf
QtdBcf
AliPif
AliCff
CstPis
CstCof
CstIpi
Retorno:
<SeqIsc>
Observao:
Esta ao aceita campos de usurio.
* Os valores diversos (exemplo: Frete, Arredondamento, Encargos e etc) devem ser informados nos dados gerais da nota.
A distribuio para os itens se d no fechamento da nota fiscal de entrada (para os processos SID e Webservice), na digitao
ocorre conforme a insero dos itens pelo usurio. As informaes destes valores nos itens tambm possvel (a ao SID produto
e servio permitem), porm a soma dos valores atribudos aos itens deve bater com o valor informado nos dados gerais, do
contrrio haver uma redistribuio baseada no valor informado nos dados gerais. Independente de reclculo da nota (RecNot).
1
O ndice (n) indica o nmero da parcela ao qual o parmetro se referencia. Este ndice
deve iniciar em 1 e, para cada nova parcela, ser incrementado em 1.
Na execuo desta ao so eliminadas todas as parcelas j definidas, manualmente ou no, para a nota fiscal de entrada
sendo referenciada.
A soma do valor financeiro das parcelas deve ser igual ao valor financeiro da nota fiscal de entrada, caso contrrio as
parcelas no sero gravadas.
Esta ao deve ser executada aps a incluso de todos os itens de produto e servio da nota fiscal de entrada, se aps a
chamada desta ao for includo mais algum item de produto ou servio as parcelas sero recalculadas conforme parametrizao do
sistema.
* (n) = Sequncia incremental da linha do rateio, iniciando sempre em 1 (um) No utilizar os parnteses, exemplo: CtaFin1 PerCta1.
** Depende da parametrizao.
*** Informar apenas o percentual ou valor.
NumNfc
CodSnf
SeqIsc
CtaFin(n)*
CtaRed(n)*
CodCcu(n)*
PerCta(n)*
VlrCta(n)*
PerRat(n)*
VlrRat(n)*
NumPrj(n)*
CodFpj(n)*
Parmetros opcionais:
ObsRat(n)*
Observao do rateio
Retorno:
"OK"
Observaes:
* (n) = Sequncia incremental da linha do rateio, iniciando sempre em 1 (um) No utilizar os parnteses, exemplo: CtaFin1 PerCta1.
** Depende da parametrizao.
*** Informar apenas o percentual ou valor.
*O campo NumOcp dever ser informado quando se deseja gravar uma alterao. Para ordens de compra novas no deve ser informado
valor. Caso informado o nmero da nova ordem de compra na ao SID, o sistema no atualizar o controle de numerao da ordem.
Observao:
Esta ao aceita campos de usurio
NumOcp
CodSer
QtdPed
Parmetros opcionais:
SeqIso
Sequncia do item de servio na ordem de compra
TnsSer
Transao de servio do item da OC
CplIso
Complemento da descrio do servio
CodFam
Cdigo da famlia do servio
CodTri
Cdigo de tributao para emisso da DARF
QtdPed
Quantidade pedida do servio da ordem de compra
UniMed
Unidade de medida do servio da ordem de compra
CodTpr
Cdigo da tabela de preo do servio
PreUni
Preo unitrio do servio da ordem de compra
PerDsc
Percentual de desconto do servio da ordem de compra
PerIss
Percentual do ISS do servio da ordem de compra
PerIrf
Percentual do IRRF do servio da ordem de compra
PerIns
Percentual do INSS
PerIpi
Percentual de IPI do servio da ordem de compra
PerIcm
Percentual de ICM do servio da ordem de compra
VlrDsc
Valor do desconto do servio da ordem de compra
VlrEnc
Valor encargos financeiros
VlrOut
Valor outras despesas
VlrDar
Valor para arredondamento
CtaFin
Conta financeira reduzida
CtaRed
Conta contbil reduzida
CodCcu
Cdigo do centro de custo
CodMoe
Cdigo da moeda que o item da ordem de compra est representado
DatMoe
Data da cotao da moeda ou ndice do item da ordem de compra
CotMoe
Valor da cotao da moeda ou ndice do item da ordem de compra
FecMoe
Indicativo de o valor da cotao fechado
NumPrj
Nmero do projeto
CodFpj
Cdigo da fase do projeto
RecOrd
Indica se deve executar o reclculo de valores dos itens (0=no, 1=sim*). *Padro
VlrOud
Valor de outras despesas destacado
Retorno:
<SeqIso>
Observao:
Esta ao aceita campos de usurio
Retorno:
"OK"
222222
GERAR REQUISIO
Ao:
SID.Est.Requisitar (SERE)
Parmetros obrigatrios:
CodPro
Cdigo do produto movimentado
CodDer
Cdigo da derivao do produto movimentado
QtdEme
Quantidade do documento de movimento de estoque
Parmetros opcionais:
NumEme
Nmero do documento de entrada do movimento de estoque
SeqEme
Sequncia do produto ou servio no documento
CodTns
Cdigo da transao de movimentao de estoque
CplPro
Complemento da descrio do produto ou servio
UniMed
Unidade de medida
CodAge
Cdigo de agrupamento para o estoque
CodAgc
Cdigo de agrupamento para compras
DatPrv
Data de previso de entrega do produto ou servio
NumPrj
Nmero do projeto
CodFpj
Cdigo da fase do projeto
CtaFin
Conta financeira reduzida
CtaRed
Conta contbil reduzida
QtdApr
Quantidade aprovado do movimento de estoque
UsuAtd
Usurio atendente do movimento de estoque
UsuSol
Usurio responsvel pela solicitao do movimento
UsuRes
Usurio responsvel pela aplicao do produto ou servio movimentado
CcuRes
Centro de custo responsvel pela aplicao do produto ou servio
UsuRec
Usurio recebedor do produto ou servio solicitado
ObsEme
Observao da solicitao de movimento de estoque
ResEst1
Indicativo se o estoque do produto da requisio deve ser reservado(S=sim, N=no)
CodDep
Cdigo do depsito para reserva
ProSer2
Indicativo se a requisio de servio (S=Servio)
NumDoc
Nmero de documento da requisio
CodBem
Cdigo do bem
FilPed
Filial do pedido
NumPed
Nmero do pedido
SeqIpd
Sequncia do item pedido
Observao:
1
Quando for solicitada a Reserva de Estoque, obrigatrio que seja informado o Cdigo do Depsito.
2
O parmetro obrigatrio no caso de ser uma requisio de servio, caso seja uma requisio de produto este no precisa
ser informado.
Retorno:
<NumEme/SeqEme>
22222
ATENDER REQUISIO
Ao:
SID.Est.AtenderRequisicao (SERE)
Parmetros obrigatrios:
NumEme
Nmero do documento de entrada do movimento de estoque
SeqEme
Sequncia do produto ou servio no documento
QtdAtd
Quantidade atendida do movimento de estoque
Parmetros opcionais:
CodDep
Cdigo do depsito movimentado
DepTrf
Cdigo do depsito transferido (para movimentos de transferncia)
CodTns
Cdigo da transao de movimentao de estoque
CtaFin
Conta financeira reduzida
CtaRed
Conta contbil reduzida
CcuRes
Centro de custo responsvel pela aplicao do produto ou servio
DatMov
Data da movimentao do estoque
CodLot
Cdigo do lote de fabricao para estocagem
NumSep
Cdigo da srie do produto
Observao:
No processo de atendimento de requisio via Sid, no existe a possibilidade de gerar solicitao de compras
automtica.
Caso no seja informada quantidade atendida (QtdAtd=0), a requisio ser cancelada com a quantidade
aprovada.
Retorno:
"OK"
22222
EXCLUIR REQUISIO
Ao:
SID.Est.ExcluirRequisicao (SERE)
Parmetros obrigatrios:
NumEme
Nmero do documento de entrada do movimento de estoque
SeqEme
Sequncia do produto ou servio no documento
Retorno:
"OK"
22222
* (n) = Sequncia incremental da linha do rateio, iniciando sempre em 1 (um) No utilizar os parnteses.
** Depende da parametrizao.
*** Informar apenas o percentual ou valor.
Retorno:
"OK"
22222
MOVIMENTAR ESTOQUE
Ao:
SID.Est.Movimentar (SECE)
Parmetros obrigatrios:
CodPro
Cdigo do produto movimentado
CodDer
Cdigo da derivao do produto movimentado
CodTns
Cdigo da transao de movimento do estoque
CodDep
Cdigo do depsito movimentado
QtdMov
Quantidade do movimento
VlrMov*
Valor do movimento *(obrigatrio quando a transao exigir)
Parmetros opcionais:
DatMov
Data da movimentao do estoque
ProTrf
Cdigo do produto transferido (para movimentos de transferncia)
DerTrf
Cdigo da derivao do produto transferido (p/ movimentos de transferncia)
DepTrf
Cdigo do depsito transferido (para movimentos de transferncia)
CodCli
Cdigo do cliente para os movimentos consignados
CodFor
Cdigo do forencedor para os movimentos consignados
NumDoc
Nmero de documento base da movimentao
CodLot
Cdigo do lote de fabricao para estocagem
CodCcu
Cdigo do centro de custo do usurio responsvel
DatVlt
Data de validade do produto no depsito
CtaRed
Cdigo da conta contbil reduzida
NumSep
Cdigo da srie do produto
NumPrj
Nmero do projeto
CodFpj
Cdigo da fase do projeto
CtaFin
Conta financeira reduzida
Retorno:
<SeqMov>
Sequncia do movimento
Observao:
Esta ao aceita campos de usurio;
Esta ao SID no suporta o conceito de valorizao individual de srie(E075PRO.CTRVIS).
22222
22222
22222
Parmetros obrigatrios:
CodEmp
Cdigo da empresa
NumEmb
Nmero da embalagem
Retorno:
"OK"
22222
Pode-se no informar o campo CodPro, e conseqentemente o campo CodDer. Neste caso os campos CplPro, UniMed e
PreSol tornam-se obrigatrios.
2
Os campos CodSer e DatPrv so obrigatrios no caso de ser uma solicitao de servio, caso seja uma solicitao de
produto estes no devem ser informados.
1
Parmetros opcionais:
NumSol
Nmero do documento da solicitao
SeqSol
Sequncia do item na solicitao de compra
CplPro
Complemento da descrio do produto
CodTns
Cdigo da transao da solicitao de compras
UniMed3
Unidade de medida
PreSol3
Preo da solicitao
CodDep4
Cdigo do depsito movimentado
DatPrv
Data prevista de entrega do produto
CtaFin
Conta financeira reduzida
CtaRed
Conta contbil reduzida
UsuSol
Usurio responsvel pela solicitao do produto
UsuRes
Usurio responsvel pela aplicao do produto solicitado
CcuRes
Centro de custo responsvel pela aplicao do produto
CodBem
Cdigo do bem
SolInt
Cdigo da solicitao no sistema integrado
ObsSol
Observao da solicitao de compra
CtaFin(n)5 6
Conta financeira
CtaRed(n) 5 6
Conta contbil reduzida
CodCcu(n) 5
Cdigo do centro de custo
PerCta(n) 5 7
Percentual do rateio da conta
VlrCta(n) 5 7
Valor do rateio da conta
PerRat(n) 5 7
Percentual do rateio
VlrRat(n) 5 7
Valor do rateio
NumPrj(n) 5
Nmero interno do projeto
CodFpj(n) 5
Cdigo da fase do projeto
ObsRat(n) 5
Observao do rateio
Os campos UniMed e PreSol somente sero considerados se no for informado o campo CodPro.
O campo CodDep s ser considerado se for informado o campo CodPro.
5
Campos para informao do rateio, onde:
* (n) = Sequncia incremental da linha do rateio, iniciando sempre em 1 (um) No utilizar os parnteses.
6
Depende da parametrizao.
7
Informar apenas o percentual ou apenas o valor.
3
4
Retorno:
"OK"
Retorno:
Xml contendo o cdigo do produto, derivao e preo mdio, conforme exemplo:
<?xml version="1.0"?>
<produto>
<codpro>5207</codpro>
<codder>A</codder>
<premed>7.5845</premed>
</produto>
<produto>
<codpro>5210</codpro>
<codder> </codder>
<premed>8.668</premed>
</produto>
<produtos>
<linha>
<NumLin></NumLin>
<CodMod></CodMod>
<CodPro></CodPro>
<DesPro></DesPro>
<QtdEmb></QtdEmb>
<derivacoes>
<CodDer></CodDer>
<QtdDer></QtdDer>
.
.
.
</derivacoes>
<QtdTot></QtdTot>
<CodEmb></CodEmb>
<CodDep></CodDep>
<CodClc></CodClc>
<CodAge></CodAge>
<CodPgr></CodPgr>
<CodFxa></CodFxa>
<CodMar></CodMar>
<CodFam></CodFam>
</linha>
.
.
.
<produtos>
<retorno>
A descrio de cada delimitador e sua funcionalidade est a seguir
<produtos></produto>
Delimitadores onde esto internamente todos os produtos lidos da consulta
<linha></linha>
Delimitadores onde existe um para cada conjunto produto/embalagem/depsito/faixa/proporcionalidade retornado da
consulta. O que est delimitado dentro de uma linha so todos os campos e valores a seguir:
<numlin></numlim>
Dentro desses delimitadores est apenas como informativo o nmero de cada linha da consulta
<codmod></codmod>
Dentro desses delimitadores est o cdigo do modelo do produto
<codpro></codpro>
Dentro desses delimitadores est o cdigo do produto
<despro></despro>
Dentro desses delimitadores est a descrio do produto, formada pela descrio e complemento do cadastro do produto
<qtdemb></qtdemb>
Dentro desses delimitadores est a quantidade de embalagens, se no estiver exibindo o estoque avulso do produto (sem
embalagens)
<derivacoes></derivacoes>
Dentro desses delimitadores esto aninhadas as derivaes do produto, com sua quantidade em estoque, estando esses
campos sempre em pares, conforme abaixo e tantos pares quanto possuir a faixa de grade informada no filtro para cada produto:
<codder></codder>
Dentro desses delimitadores est o cdigo da derivao do produto
<qtdder></qtddder>
Dentro desses delimitadores est a quantidade da derivao imediatamente acima. Quando o produto est embalado, o
mesmo exibe a proporcionalidade apenas. Se for um produto avulso, a quantidade em avulso.
<qtdtod></qtdtot>
Dentro desses delimitadores est a quantidade total de todas as derivaes da linha de produto.
<codemb></codemb>
Dentro desses delimitadores est o cdigo da embalagem do produto. Se for uma linha de estoque avulso, no h valor
nesse delimitador.
<coddep></coddep>
Dentro desses delimitadores est o cdigo da depsito consultado do produto. Se a consulta agrupar depsitos, com o
parmetro TIPAGP = 1, o mesmo no apresenta valor.
<codclc></codclc>
Dentro desses delimitadores est o cdigo da coleo do produto.
<codage></codage>
Dentro desses delimitadores est o cdigo de agrupamento de estoque do produto
<codpgr></codpgr>
Dentro desses delimitadores est o cdigo da proporcionalidade da embalagem do produto. Se a linha estiver exibindo
estoque avulso, no h valor neste delimitador.
<codfxa></codfxa>
Dentro desses delimitadores est o cdigo da faixa consultada do produto.
<codmar></codmar>
Dentro desses delimitadores est o cdigo da marca do produto.
<codfam></codfam>
Dentro desses delimitadores est o cdigo da famlia do produto.
Observao:
1
Deve ser informado o campo NumEmb, ou o campo CodBar, ou os campos CodPro e CodDer, sendo usado o primeiro, na
ordem em que esto listados, que contenha um valor.
2
O campo QtdPro desconsiderado caso seja informado NumEmb, assumindo automaticamente valor 1.
Parmetros opcionais:
EmpOri
Cdigo da empresa de origem
EmpDes
Cdigo da empresa de destino
Retorno:
"OK"
22222
22222
CodEmp
CodFil
NumAne
NumPfa
CodEmb
NumEmb
Cdigo da empresa
Cdigo da filial
Nmero da anlise de embarque
Nmero da pr-fatura
Cdigo da embalagem
Nmeros das embalagens
Parmetros opcionais:
QtdEmb
Quantidade de embalagens
NumNiv
Nvel da Embalagem
VolOcu
Volume j ocupado da embalagem
PesBru
Peso bruto das embalagens e produtos
PesLiq
Peso lquido dos produtos
ObsEmb
Texto da observao das embalagens
Retorno:
<SeqEmb>
22222
22222
22222
TriIpi
TriPis
TriCof
CodPdv
IdeCli
Tributa
Tributa
Tributa
Cdigo
Cdigo
Retorno:
<CodCli>
Observao:
Esta ao aceita campos de usurio.
22222
CtaRcr
CtaFdv
CtaFcr
CriEdv
FveTns
FveFpg
FveCpg
CifFob
Retorno:
"OK"
Observao:
Esta ao aceita campos de usurio.
22222
EXCLUIR CLIENTE
Ao:
SID.Cli.Excluir
Parmetros obrigatrios:
CodCli
Cdigo do cliente
CodEmp
Cdigo da empresa
Retorno:
"OK"
22222
22222
22222
Retorno:
"OK"
22222
InfSpc
NomInv
CarCre
NumCre
ValCre
VctCre
NomCre
DepCre
NasCre
GraCre
EmpAnt
TemAnt
FonAnt
RamAnt
ResAnt
NomAva
CpfAva
EndAva
EenAva
CepAva
CidAva
EstAva
FonAva
Retorno:
"OK"
Observao:
Esta ao aceita campos de usurio.
22222
22222
Ao:
SID.Cli.ExcluirContato
Parmetros obrigatrios:
CodCli
Cdigo do cliente
SeqCto
Sequncia do contato
Retorno:
"OK"
Retorno:
<SeqCob>
Observao:
Esta ao aceita campos de usurio.
22222
fiscais
fiscais
OurCom
Indicativo se as outras retenes esto na base de comisso dos pedidos, pr-faturas e notas
PifCom
CffCom
Indicativo se o PIS Faturamento est na base de comisso dos pedidos, pr-faturas e notas fiscais
Indicativo se o COFINS Faturamento est na base de comisso dos pedidos, pr-faturas e notas
RecAdc
RecAoc
RecPcj
RecPcm
RecPcc
RecPce
RecPco
Indicativo
Indicativo
Indicativo
Indicativo
Indicativo
Indicativo
Indicativo
se
se
se
se
se
se
se
Parmetros opcionais:
PerCom
Percentual de comisso padro para produtos do representante
PerCos
Percentual de comisso padro para servios do representante
ComFat
Percentual da comisso pago ao representante no faturamento
ComRec
Percentual da comisso pago ao representante no recebimento dos ttulos
PerIrf
Percentual do IRRF para o clculo das comisses
PerIss
Percentual do ISS para o clculo das comisses
PerIns
Percentual do INSS para o clculo das comisses
RepSup
Cdigo do representante superior do representante
ComSup
Percentual da comisso pago ao representante superior
CodBan
Cdigo do banco da conta corrente do representante
CodAge
Cdigo da agncia do banco da conta corrente do representante
CcbRep
Nmero da conta corrente do representante
TipCol
Tipo de Colaborador
NumCad
Nmero do Cadastro do Representante como Colaborador
VenVmp
Valor mnimo aceito para pedidos
RecVmt
Valor mnimo aceito para ttulos do contas a receber
PerCqt
Percentual das cotas sobre as quantidades de venda
PerCvl
Percentual das cotas sobre os valores de venda
CtaRed
Conta contbil reduzida - 1
CtaRcr
Conta contbil reduzida - 2
CtaFdv
Conta contbil reduzida - 3
CtaFcr
Conta contbil reduzida - 4
Retorno:
"OK"
Observao:
Esta ao aceita campos de usurio.
22222
EXCLUIR REPRESENTANTE
Ao:
SID.Rep.Excluir
Parmetros obrigatrios:
CodRep
Cdigo do representante
Retorno:
"OK"
22222
Observao:
Esta ao aceita campos de usurio.
CodFor
Cdigo do fornecedor
Retorno:
"OK"
Parmetros opcionais:
CodMoe
Cdigo da moeda do ttulo a receber
CodNtg
Cdigo da natureza de gasto
CodSac
CodCrp
ObsTcr
CodMpt
DatPpt
VlrBco
VlrCom
PerCom
ComRec
DatDsc
TolDsc
PerDsc
VlrDsc
PerJrs
TipJrs
JrsDia
TolJrs
PerMul
TolMul
CheBan
CheAge
CheCta
CheNum
DatNeg
TitBan
NumArb
CodOcr
CodIn1
CodIn2
JrsNeg
MulNeg
DscNeg
OutNeg
CpgNeg
TaxNeg
CtaFin
CtaRed
CodCcu
NumPrj
CodFpj
CodBar
CtaFinCap(n)*
CtaRedCap(n)*
PerCtaCap(n)*
CodCcuCap(n)*
PerRatCap(n)*
CodCnv
Cdigo do sacado
Cdigo do grupo de contas a receber
Observao para o ttulo
Cdigo do motivo de prorrogao do titulo
Data do provvel pagamento do ttulo
Valor base/Valor da comisso do ttulo**
Valor comisso**
Percentual comisso**
Percentual de comisso pago no recebimento**
Data/Tolerncia vlidas para desconto do ttulo
Dias de tolerncia para desconto
Percentual/Valor do desconto do ttulo
Valor do desconto a ser concedido ao ttulo a receber
Percentual de juros de mora ao mes do ttulo a receber
Indicativo se os juros de mora simples ou composto
Valor de juros de mora ao dia do ttulo a receber
Dias de tolerncia para os juros de mora do ttulo a receber
Percentual de multa prevista para o ttulo a receber
Dias de tolerncia para a multa prevista para o ttulo a receber
Nmero do banco na FEBRABAN do cheque
Nmero da agncia do banco do cheque
Numero da conta no banco do cheque
Nmero do cheque no banco
Data base dos juros negociados data at
Nmero do ttulo no banco nosso nmero
Nmero de arquivo de remessa para banco
Cdigo da ocorrncia de remessa para banco
Cdigo da primeira instruo bancria
Cdigo da segunda instruo bancria
Valor dos juros negociados
Valor da multa negociada
Valor dos descontos negociados
Valor de outros valores negociados
Cdigo da condio de pagamento negociada
Taxa negociada
Conta financeira reduzida
Conta contbil reduzida
Cdigo do centro de custo
Nmero interno do projeto
Cdigo da fase do projeto
Cdigo de barras do Ttulo
Conta financeira do rateio da comisso
Conta contbil reduzida do rateio da comisso
Percentual do rateio da conta da comisso
Cdigo do centro de custo do rateio da comisso
Percentual do rateio da comisso
Cdigo do Convnio
Retorno:
"OK"
Observao:
Esta ao aceita campos de usurio.
Parmetros opcionais:
NsuTef
Nmero da Transao TEF
TipRet
Tipo de retorno da ao, quando bem sucedida (ver Retorno para mais detalhes)
DatLib
Data de liberao
DiaAtr
Dia de atrasos
DiaJrs
Dia de juros
VlrDsc
VlrJrs
VlrMul
VlrCom
VlrBco
VlrEnc
VlrCor
VlrOac
VlrOde
CotMcr
FilRlc
NumRlc
TptRlc
SeqRlc
CodFpg
NumDoc
TnsBxa
SemJrs
CtaFinCap(n)*
CtaRedCap(n)*
PerCtaCap(n)*
CodCcuCap(n)*
PerRatCap(n)*
Valor de descontos
Valor de juros
Valor de multa
Valor da comisso
Valor base da comisso
Valor de encargos
Valor das correes
Valor de outros acrscimos
Valor de outros descontos
Cotao da movimentao do contas a receber
Cdigo da filial do ttulo relacionado gerado ou aproveitado
Nmero do ttulo relacionado gerado ou aproveitado
Tipo do ttulo relacionado gerado ou aproveitado
Sequncia do movimento relacionado gerado ou aproveitado
Cdigo da forma de pagamento
Nmero do documento para movimento da tesouraria
Transao de movimentao na tesouraria
Ignora clculo de juros, multa e desconto (0=no*, 1=sim)
Conta financeira do rateio da comisso
Conta contbil reduzida do rateio da comisso
Percentual do rateio da conta da comisso
Cdigo do centro de custo do rateio da comisso
Percentual do rateio da comisso
*Valor padro
* (n) = Sequncia incremental da linha do rateio, iniciando sem 1 (um) No utilizar os parnteses.
Retorno:
Se o parmetro TipRet (tipo de retorno da ao) for:
- 0 (padro): "OK"
- 1: <SeqMov> (Sequncia do movimento gerado)
Retorno:
"OK"
Retorno:
<NomeColuna1>;<NomeColuna2>;<NomeColuna3>;... + LF
<ValorColuna1>;<ValorColuna2>;<ValorColuna3>;... + LF
Campos de retorno:
CodEmp
CodFil
NumTit
CodTpt
CodCli
NomCli
TitBan
CodTns
DatEmi
NumCco
VlrOri
VlrAbe
VlrDsc
VlrJrs
VlrMul
VlrEnc
VlrCor
VlrOac
Cdigo da empresa
Cdigo da filial
Nmero do ttulo
Cdigo do tipo do ttulo
Cdigo do cliente
Nome do cliente
Nmero do ttulo no banco
Cdigo da transao
Data da emisso do ttulo
Nmero da conta interna
Valor original do ttulo
Valor em aberto do ttulo
Valor do desconto
Valor dos juros
Valor da multa
Valor dos encargos
Valor da correo monetria do ttulo
Valor de outros acrscimos do ttulo
VlrOde
VlrMov
CodFpg
DiaAtr
DiaJrs
VctOri
Parmetros opcionais:
NroDoc
Nmero do documento
TipVct
Tipo de vencimento (1=provvel pagamento*, 2=vencimento normal) *Padro
CodFpg
Cdigo da forma de pagamento
VlrPgt(n)*
Valor da baixa (informar somente quando for parcial) o valor de
Opcao
Proceder baixa portador diferente de portador empresa(N=Bloqueia, S=Procede)
* (n) = Sequncia incremental do ttulo, deve coincidir com a Sequncia do respectivo ttulo
Retorno:
"OK"
Observao:
Todos os rateios deste processo devem ser pr-definidos sem confirmao (ou sem rateio). Os lanamentos na tesouraria
sero processados sempre com o valor da baixa (no h possibilidades de dividir os movimentos).
TolMul
DatNeg
JrsNeg
MulNeg
OutNeg
TitBan
CodFpg
CodUsu
DatApr
VlrApr
PgtApr
CotApr
DscApr
OdeApr
JrsApr
MulApr
EncApr
CorApr
OacApr
EmpApr
CtaApr
SeqApr
LibApr
CodBan
CodAge
CcbFor
PorAnt
CtaFin
CtaRed
CodCcu
FpgApr
CodBar
UsuSit
NumArb
NumPrj
CodFpj
DatPpt
CodFav
Retorno:
"OK"
Observao:
Esta ao aceita campos de usurio
Parmetros opcionais:
TipRet
Tipo de retorno da ao, quando bem sucedida (ver Retorno para mais detalhes)
DatMov
Data do movimento do ttulo a pagar (Se estiver zerada recebe data atual)
DatPgt
Data do pagamento do ttulo a pagar (Se estiver zerada recebe data atual)
NumDoc
Nmero do documento do movimento do ttulo a pagar
ObsMcp
Observao do movimento do contas a pagar
CodFpg
Cdigo da forma de pagamento
CotMcp
Valor da cotao da moeda na data base do movimento
DatLib
Data de liberao do cheque (Se estiver zerada recebe data atual)
VlrDsc
Valor do desconto concedido ao pagamento do ttulo
VlrOde
Valor de outros descontos do ttulo
VlrJrs
Valor dos juros de mora pago
VlrMul
Valor da multa pago
VlrEnc
Valor dos encargos do ttulo
VlrCor
Valor da correo monetria do ttulo
VlrOac
Valor de outros acrscimos do ttulo
NumPrj
CodFpj
CtaFin
CtaRed
CodCcu
TipPgt
CodBan
CodAge
CcbFor
AgrPre
* Valor padro
Nmero do projeto
Cdigo da fase do projeto
Conta financeira reduzida
Conta contbil reduzida
Cdigo do centro de custo
Tipo de pagamento do ttulo
Cdigo do banco da conta corrente do fornecedor
Cdigo da agncia do banco da conta corrente do fornecedor
Nmero da conta corrente do fornecedor no banco
Indicativo para agrupar sequncia preparao de cheque (0=no*, 1=sim)
Retorno:
Se o parmetro TipRet (tipo de retorno da ao) for:
- 0 (padro): "OK"
- 1: <SeqMov> (Sequncia do movimento gerado)
Sequncia do movimento
Observaes:
Parmetros opcionais:
ObsRat
Observao do rateio
Retorno:
"OK"
OriChe
Parmetros opcionais:
PrxNro
Prximo nmero
TipSel
Tipo de sida (0=Cheque, 1=Aviso dbito, 3=Outros)
Retorno:
OK
Observao:
Esta ao baseada na tela F600ECH (Tesouraria Gerao de movimentos e emisso de cheques e avisos)
Retorno:
<SeqGer>
DatGer
SeqGer
Retorno:
"OK"
PerPit
VlrBpt
AliPif
QtdBpf
VlrPit
PerCrt
VlrBct
AliCff
QtdBcf
VlrCrt
Retorno:
<SeqRez>
Sequncia do Rateio
AliPif
QtdBpf
VlrPit
PerCrt
VlrBct
AliCff
QtdBcf
VlrCrt
CstPis
NatPis
CstCof
NatCof
CodCli
ChvDoe
Retorno:
<SeqIte>
PerCsl
VlrBcl
VlrCsl
PerOur
VlrBor
VlrOur
PerIss
VlrBis
VlrIss
PerIns
VlrBin
VlrIns
VlrBpf
VlrPif
VlrBcf
VlrCff
VlrBsd
VlrIsd
VlrBsp
VlrStp
VlrBsc
VlrStc
VlrBfu
PerFun
VlrFun
CodTri
VlrFre
CifFob
VlrSeg
VlrDac
CodCcu
CodTra
CodVia
PlaVei
PreImp
CodTic
CodTrd
VlrBii
VlrIim
VlrBie
VlrIem
NumDoi
VlrRis
DatDoi
CodSel
CodSsl
SeqOrm
PesBru
PesLiq
PerIcf
IcmFre
SomFre
CodMs1
CodMs2
CodMs3
CodMs4
ChvNel
UfsCic
EquRez
DatRez
CfiRez
VlrFei
VlrSei
VlrOui
QtdBip
QtdBpi
QtdBco
QtdBpf
QtdBcf
VlrSub
VlrDzp
VlrDzc
DatExf
DatExc
Retorno:
"OK"
Percentual da CSLL
Valor Base da CSLL
Valor da CSLL
Percentual das Outras Retenes
Valor Base das Outras Retenes
Valor das Outras Retenes
Percentual do ISS
Valor Base do ISS
Valor do Iss
Percentual do INSS
Valor Base do INSS
Valor do INSS
Valor Base do PIS Faturamento
Valor do PIS Faturamento
Valor Base do COFINS Faturamento
Valor do COFINS Faturamento
Valor base do ICMS substitudo destacado
Valor do ICMS substitudo destacado
Valor base da substituio do PIS
Valor da substituio do PIS
Valor base da substituio do COFINS
Valor da substituio do COFINS
Valor base do Funrural
Percentual do Funrural
Valor do Funrural
Cdigo de tributao para emisso da DARF
Valor do frete da nota fiscal de entrada
Indicativo se o valor do frete CIF ou FOB
Valor do seguro da nota fiscal de entrada
Valor das despesas acessrias
Cdigo do centro de custo
Cdigo da transportadora da nota fiscal de entrada
Via de transporte da nota fiscal de entrada
Placa do veculo de transporte das mercadorias da nota fiscal de entrada
Nmero pr-impresso no formulrio da nota fiscal
Cdigo do ICMS especial
Cdigo de reduo de impostos
Valor base do imposto de importao
Valor do imposto de importao
Valor base do INSS parte empresa
Valor do INSS parte empresa
Nmero do documento de importao
Valor de reteno de ICMS substituto
Data do registro do documento de importao
Cdigo da srie legal da nota fiscal de entrada
Cdigo da sub-srie legal da nota fiscal de entrada
Sequncia do endereo de origem da mercadoria
Peso bruto da nota fiscal de entrada
Peso liquido da nota fiscal de entrada
Percentual de ICMS sobre o frete
Valor de ICMS sobre o frete
Somar o valor do frete no valor da nota fiscal
Cdigo da mensagem 1
Cdigo da mensagem 2
Cdigo da mensagem 3
Cdigo da mensagem 4
Chave de acesso da nota fiscal eletrnica
Sigla do estado base para o clculo do ICMS
Cdigo do equipamento fiscal da reduo Z devolvida
Data de referncia da reduo Z devolvida
Nmero do cupom fiscal de referncia da reduo Z devolvida
Valor de frete de importao
Valor do seguro de importao
Valor de outras despesas de importao
Quantidade da Base do IPI
Quantidade da Base do PIS a recuperar
Quantidade da Base do COFINS a recuperar
Quantidade da Base do PIS por faturamento (Estorno devoluo)
Quantidade da Base do COFINS por faturamento (Estorno devoluo)
Valor Subsdio
Valor Desconto PIS Zona Franca
Valor Desconto Cofins Zona Franca
Data da escriturao do documento extemporneo SPED Fiscal
Data da escriturao do documento extemporneo SPED Contribuies
Sequncia do Rateio
Parmetros opcionais:
CodPro
Cdigo do produto
CodDer
Cdigo da derivao do produto
CplPro
Descrio complementar do produto ou servio
CodClf
Cdigo interno da classificao fiscal
ClaFis
Cdigo da classificao fiscal - NCM
QtdEnt
Quantidade de entrada do produto
UniMed
Unidade de medida da quantidade do produto
PreUni
Preo unitrio do item da nota fiscal de entrada
VlrBic
Valor base do ICMS
PerIcm
Percentual do ICMS
VlrIcm
Valor do ICMS
VlrIic
Valor isentas ICMS
VlrOic
Valor outras ICMS
VlrBip
Valor base do IPI
PerIpi
Percentual de IPI
VlrIpi
Valor do IPI
VlrIip
Valor isentas IPI
VlrOip
Valor outras IPI
VlrBid
Valor base do IPI presumido
VlrIpd
Valor do IPI presumido
VlrBsi
Valor base do ICMS substitudo
VlrBri
Base de Clculo do ICMS ST Resp. Solidrio
VlrCip
Valor do ICMS no creditado no CIAP
SitCip
Situao do CIAP
DatIna
Data da inativao do item para o clculo do CIAP
ObsIna
Observao ou motivo da inativao do item para o clculo do CIAP
SeqIpc
Sequncia do item na nota fiscal de entrada
VlrDsc
Valor do desconto do item
CodStr
Situao tributria do item da nota fiscal de entrada
CodTrd
Cdigo de reduo do ICMS
CodSer
Cdigo do item de servio da nota fiscal de entrada
VlrCtb
Valor contbil do item da nota fiscal
CtaRed
FilNfv
NumNfv
SnfNfv
SeqIpv
VlrDac
CodTst
PerIim
VlrBii
VlrIim
VlrRis
CodBem
PesEnt
DifPes
BasDif
NfiPro
VlrBsi
VlrSic
PerIrf
VlrBir
VlrIrf
PerCrt
VlrBct
VlrCrt
PerPit
VlrBpt
VlrPit
PerCsl
VlrBcl
VlrCsl
PerOur
VlrBor
VlrOur
PerIss
VlrBis
VlrIss
PerIns
VlrBin
VlrIns
PerPir
VlrBpr
VlrPir
PerCor
VlrBcr
VlrCor
CstIpi
CstPis
CstCof
CodCcu
CodCli
TnsNfv
BasCre
NffNfv
VlrDai
VlrBsd
VlrIsd
VlrBsp
VlrStp
VlrBsc
VlrStc
VlrBfu
PerFun
VlrFun
VlrSeg
VlrFre
VlrBie
VlrIem
PerPif
VlrBpf
VlrPif
PerCff
VlrBcf
VlrCff
CodDfs
VlrAjs
VlrFei
VlrSei
VlrOui
QtdBip
AliIpi
QtdBpi
AliPis
QtdBco
AliCof
alipif
AliPif
QtdBcf
AliCff
VlrSub
OriMer
VlrDzp
VlrDzc
VlrMrc
PerStp
PerStc
NumDrb
Retorno:
<SeqInc>
Retorno:
OK
VlrCff
CodRai
VlrDai
VlrBid
VlrIpd
VlrBsp
VlrStp
VlrBsc
VlrStc
VlrBfu
PerFun
VlrFun
CodTri
PerIcf
IcmFre
VlrFre
CifFob
VlrSeg
VlrDac
CodCcu
RemDes
TipRde
CgcRde
InsRde
EstRde
MunRde
CodTra
CodVia
PlaVei
UfsVei
kmtDis
ForCal
PreImp
SelFis
CodCl1
CodCl2
CodTic
CodTrd
VlrBii
VlrIim
VlrRis
NumRde
PesBru
PesLiq
DatCex
NumNsu
DatNsu
HorNsu
SisMex
SomFre
CodMs1
CodMs2
CodMs3
CodMs4
SeqEnt
CodFpg
SeqPco
SeqPen
EquRez
DatRez
CfiRez
TotCid
QtdBip
QtdBpf
QtdBcf
QtdBpi
QtdBco
HorSai
VlrSub
DatZfm
DatExf
DatExc
Retorno:
"OK"
Ao:
SID.Niv.GravarRateio (CIEC)
Parmetros obrigatrios:
CodCli
Cdigo do Cliente
NumNfi
Nmero inicial da nota fiscal de entrada
NumNff
Seqencial de lanamento da nota fiscal
CodSnf
Cdigo da srie da nota fiscal sada
CodTns
Transao
CriRat
Critrio utilizado para rateio
Parmetros opcionais:
SeqRat
Sequncia do rateio
DatBas
Data base contbil e financeira
CtaRed
Conta contbil reduzida
PerCta
Percentual rateado para a conta
VlrCta
Valor rateado para a conta
CodCcu
Cdigo do centro de custos
PerRat
Percentual rateado para o centro de custos
VlrRat
Valor rateado para o centro de custos
ObsRat
Observao do rateio
Retorno:
<SeqRat>
Sequncia do Rateio
Parmetros opcionais:
CodPro
Cdigo do produto
CodDer
Cdigo da derivao do produto
CplPro
Descrio complementar do produto ou servio
CodClf
Cdigo interno da classificao fiscal
ClaFis
Cdigo da classificao fiscal - NCM
QtdEnt
Quantidade de sada do produto
UniMed
Unidade de medida da quantidade do produto
PreUni
Preo unitrio do item da nota fiscal de sada
VlrBic
Valor base do ICMS
PerIcm
Percentual do ICMS
VlrIcm
Valor do ICMS
VlrIic
Valor isentas ICMS
VlrOic
Valor outras ICMS
VlrBip
Valor base do IPI
PerIpi
Percentual de IPI
VlrIpi
Valor do IPI
VlrIip
Valor isentas IPI
VlrOip
Valor outras IPI
VlrBid
Valor base IPI destacado/presumido (50% compra no comrcio)
VlrIpd
Valor do IPI destacado/presumido (50% compra no comrcio)
VlrBsi
Valor base do ICMS substitudo
SeqIpv
Sequncia do item na nota fiscal de sada
VlrDsc
Valor do desconto do item
CodStr
Situao tributria do item da nota fiscal de sada
CodTrd
Cdigo de reduo do ICMS
CodSer
Cdigo do item de servio da nota fiscal de sada
VlrCtb
Valor contbil do item da nota fiscal
CtaRed
Conta contbil reduzida
FilNfc
Cdigo da filial da nota fiscal de entrada
CodFor
Fornecedor da nota fiscal de entrada
NumNfc
Nmero da nota fiscal de entrada
SnfNfc
Cdigo da srie da nota fiscal de entrada
SeqIpc
Sequncia do item da nota fiscal de entrada
VlrDac
Valor das despesas acessrias (embalagem, encargos, outras despesas)
CodTst
Cdigo do ICMS substitudo
PerIim
Percentual do imposto de importao do item da nota fiscal de sada
VlrBii
Valor base imposto de importao
VlrIim
VlrRis
CodBem
SeqNfi
PerIrf
VlrBir
VlrIrf
PerCrt
VlrBct
VlrCrt
PerPit
VlrBpt
VlrPit
PerCsl
VlrBcl
VlrCsl
PerOur
VlrBor
VlrOur
PerIss
VlrBis
VlrIss
PerIns
VlrBin
VlrIns
PerPir
VlrBpr
VlrPir
PerCor
VlrBcr
VlrCor
Coefci
CstPis
CstCof
CodCcu
TnsNfc
NffNfc
DesImp
VlrDai
VlrSic
VlrBsd
VlrIsd
VlrBsp
VlrStp
VlrBsc
VlrStc
VlrBfu
PerFun
VlrFun
VlrFre
VlrSeg
PerPif
VlrBpf
VlrPif
PerCff
VlrBcf
VlrCff
NumRde
CodDfs
VlrAjs
VlrCid
TotCid
QtdBip
AliIpi
QtdBpf
AliPif
QtdBcf
AliCff
QtdBpi
AliPis
QtdBco
AliCof
VlrSub
NatPis
NatCof
OriMer
VlrMrc
PerPim
PerCim
PerStp
PerStc
Retorno:
<SeqInv>
SID.Niv.GravarParcelaVenda (CIEC)
Parmetros obrigatrios:
CodSnf
Cdigo da Srie da Nota Fiscal
NumNfi
Nmero inicial da nota fiscal de sada
VctPar
Data de Vencimento da parcela da Nota Fiscal de sada
VlrPar
Valor da Parcela da Nota Fiscal de sada
Parmetros Opcionais
CodPar
Sequncia de parcelas da Nota Fiscal
NumTit
Nmero do ttulo a ser gerado no Contas a Receber
CodTpt
Cdigo do Tipo de Ttulo a ser gerado no Contas a Receber
ObsPar
Texto da Observao
CodFpg
Cdigo da Forma de Pagamento
Retorno:
<CodPar>
Parmetros obrigatrios:
CodSnf
Cdigo da Srie da Nota Fiscal
NumNfi
Nmero inicial da nota fiscal de sada
SeqIpv
Sequncia do item na Nota Fiscal
EmpRlc
Empresa da Nota Fiscal de sada relacionada
FilRlc
Filial da Nota Fiscal de sada relacionada
SnfRlc
Srie da Nota Fiscal de sada relacionada
NfvRlc
Nmero da Nota Fiscal de sada relacionada
InvRlc
Sequncia do Item de produto relacionado
Parmetros Opcionais
SeqLni
Sequncia de ligao
Retorno:
<SeqLni>
OK
Parmetros obrigatrios:
NumLot
Nmero do lote contbil
Parmetros opcionais:
CodEmp
Cdigo da empresa
OriLct*
Origem do lote contbil
* Quando no informado utilizado origem "MAN"
Retorno:
"OK"
Parmetros opcionais:
DatLct
Data de lanamento
DatLot
Data do lote
DocLot
Documento de controle de lanamentos
CgcCpf
C.N.P.J./C.P.F.
CtaRed(n)*
Conta contbil reduzida
CodCcu(n)*
Cdigo do centro de custo
PerRat(n)*
Percentual do rateio
VlrRat(n)*
Valor do rateio
CtaRea(n)*
Conta contbil reduzida origem da composio auxiliar
CtaAux(n)*
Conta contbil auxiliar
VlrAux(n)*
Valor da composio auxiliar
* (n) = Sequncia incremental da linha do rateio, iniciando sempre em 1 (um) No utilizar os parnteses.
Retorno:
<NumLct>
IniVef
FinVef
IniEst
FinEst
IniCre
FinCre
IniNfe
FinNfe
IniCof
FinCof
IniCpa
FinCpa
IniCom
FinCom
IniTes
FinTes
IniPat
FinPat
IniIve
FinIve
IniIco
FinIco
IniIvz
FinIvz
IniPrj
FinPrj
Data
Data
Data
Data
Data
Data
Data
Data
Data
Data
Data
Data
Data
Data
Data
Data
Data
Data
Data
Data
Data
Data
Data
Data
Data
Data
Retorno:
<QtdLct>
* = Valor padro
Observao:
Os campos DatIni e DatFin so usados para sugerir um perodo para TODOS os mdulos de integrao, no havendo
necessidade de informar o perodo individualmente. Neste caso, necessrio informar tambm o indicativo de integrao de cada
mdulo desejado. Se o perodo de datas dos mdulos forem informados, no ser necessrio informar o indicativo de integrao do
mdulo. Neste caso, no deve-se usar os campos DatIni e DatFin.
CodBem (n)*
Parmetros opcionais:
MulQtd(n)*
DatCal(n)*
MesAnt(n)*
DprBem(n)*1
depreciao **
Cdigo do bem
Retorno vem multiplicado pela quantidade de itens (S=sim, N=no)
Data do clculo da depreciao
Indicativo se para buscar depreciao do perodo anterior ao informado (S=sim, N=no)
Indicativo se deve buscar a depreciao na tabela de bens caso no existam clculos de
Retorno:
XML contendo o cdigo do bem, depreciao mensal, depreciao acumulada e retorno. Quando no possuir clculo de
depreciao para a data informada retorna "1", conforme exemplo:
<?xml version="1.0"?>
<depreciacao>
<bem>
<codbem>VEICORSA0001-000</codbem>
<dprmes>374,17</dprmes>
<dpracu>2993,33</dpracu>
<retorno>0</retorno>
</bem>
<bem>
<codbem>TERFABRI0001-000</codbem>
<dprmes>0</dprmes>
<dpracu>0</dpracu>
<retorno>0</retorno>
</bem>
<bem>
<codbem>VEIPARAT0001-000</codbem>
<dprmes>0</dprmes>
<dpracu>0</dpracu>
<retorno>1</retorno>
</bem>
</depreciacao>
SeqRot
TipPos
DtrIni*
DtrFim*
HorIni**
HorFim***
DtpIni*
DtpFim*
HorIpv****
HorFpv*****
CodEqp******
Sequncia de roteiro
Tipo posicionamento (1 = Inicia aps fim da anterior; 2 = Inicia junto; 3 = Finaliza junto)
Data de incio real da operao na O.P.
Data de fim real da operao na O.P.
Hora de incio real da operao na O.P.
Hora de fim real da operao na O.P.
Data inicial prevista da operao na O.P.
Data final prevista da operao na O.P.
Hora de incio prevista da operao na O.P.
Hora de fim prevista da operao na O.P.
Cdigo do equipamento
* Se o movimento for automtico e valor for nulo ou 00/00/0000, retorna a data atual
** Se o movimento for automtico e DtrIni for nulo, retorna a hora atual. possvel informar no formato inteiro (minutos) ou HH:MM
*** Se o movimento for automtico e DtrFim for nulo, retorna a hora atual. possvel informar no formato inteiro (minutos) ou HH:MM
**** Se o movimento for automtico e DtpIni for nulo, retorna a hora atual. possvel informar no formato inteiro (minutos) ou HH:MM
***** Se o movimento for automtico e DtpFim for nulo, retorna a hora atual. possvel informar no formato inteiro (minutos) ou HH:MM
****** Este campo obrigatrio se a empresa estiver configurada para utilizar a parada por equipamento (E075EPR.IndPre = S), for
passado S no parmetro MovAut e o centro de recurso padro da operao for limitado por mquina (E725CRE.LimCap = M), caso contrrio ele no
deve ser informado.
Esta ao SID no suporta OS gerada a partir de uma ordem de manuteno.
Retorno:
"OK"
DatRes
Retorno:
"OK"
2.24
SIDXML
SIDXML o conceito atribudo forma de agrupar aes SID em texto pseudo XML e submet-las em uma nica requisio
HTTP. O benefcio a possibilidade de processamento agrupado dentro de uma transao de banco, assim ocorrendo alguma falha
todo o bloco de comandos SID desfeito, alm de reduzir o trfego via rede. Outra caracterstica a possibilidade de utilizar o
"retorno" de aes como parmetros em outras.
Observaes tcnicas:
Para submeter o texto XML, deve-se utilizar sempre o mtodo "POST";
No h limite de quantidade de aes ou parmetros, apenas o tamanho final do texto XML (1 Mb);
Para utilizar o contedo de uma varivel interna, deve-se preceder o nome da varivel um "@" no parmetro valor. Exemplo:
<param nome='NUMPED' valor='@RETORNO_PEDIDO'>;
Os valores dos parmetros devem sempre estar delimitados por apstrofos ('), independente do tipo de contedo;
O Sapiens Server considera falha ou erro, todo retorno de ao iniciando com "ERRO:";
Parmetros do SIDXML:
A passagem de parmetros para o SIDXML pode ser feita definindo o primeiro sub-elemento do SIDXML com o rtulo
"param", sendo os atributos deste elemento considerados como parmetros.
Os parmetros existentes, e seus possveis valores, so:
a) retorno indica o formato de resultado da execuo da ao SIDXML. Possveis valores:
<padro> todo contedo do SIDXML processado dentro de uma transao nica, assim ocorrendo erro em
alguma ao, tudo desfeito;
INDIVIDUAL cada ao dentro do SIDXML processado em sua prpria transao, assim ocorrendo erro em
alguma ao, somente o resultado desta ao desfeito, sendo as aes posteriores tambm processadas;
Exemplo:
<sidxml>
<param retorno='XML' transacao='INDIVIDUAL' />
... aes...
</sidxml>
Observaes:
A utilizao de parmetro transacao como INDIVIDUAL torna obrigatrio a utilizao do parmetro retorno como XML.
Limitaes:
Por questes tcnicas internas, o XML no dever conter quebras de linha, ou seja, todo o contedo dever ser submetido numa
nica linha, exemplo: <sidxml><sid acao=...><...><...></sidxml>
No utilizar o cabealho padro do XML (<?xml version="1.0"?>);
No utilizar caracteres como "?" e "&" no XML;
No utilizar o caractere apstrofo (') no valor de um parmetro;
A ao SID.SRV.EXEREL no pode ser utilizada no SIDXML;
3.2 EXEMPLO