Páginas filhas
  • DR VA Integração API Transação - Requisições de Transação

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Totvs custom tabs box
tabsIncluir transação por Empresa, B, C
idsempre,transa,dados
Totvs custom tabs box items
defaultyes
referenciaempre
Totvs custom tabs box
tabsEnvio, Retorno, Exemplo de implementação
idsenvio,retorno,cod
Totvs custom tabs box items
defaultyes
referenciaenvio
Totvs custom tabs box
tabsURL, CorpoBody, Exemplo de Requisição, Detalhamento dos Campos
idsurlE,corpoE,exE,campE
Totvs custom tabs box items
defaultyes
referenciaurlE

Button
Cor#61affe
TextoGET
Link.
    https://www30.bhan.com.br:9443/api/v1/transacao/inclusao

Corpo da requisição 
Totvs custom tabs box items
defaultno
referenciacorpoE
Bloco de código
languagexml
themeRDark
{  
   "cdEmpresa":9999,										
   "nrCNPJEmpresa": "XXXXXXXXXXXXXX",					
   "cdPessoa": 999999999,								
   "nrCPFCNPJPessoa": "XXXXXXXXXXXXXX",					
   "dtMovimento": "99/99/9999",							
   "cdTransacao": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",	
   "cdOperacao": 999999,								
   "cdVendedor": 999999,								
   "nrCPFVendedor": "XXXXXXXXXXX",						
   "itens": [
        {
            "cdProduto": "XXXXXXXXXXXXXXXXXXXX",		
            "cdEspecie": "XXX",							
            "qtItem": 9999999.999,						
            "vlBruto": 9999999.99,						
            "vlDescontoItem": 9999999.99,				
            "vlDescontoCapa": 9999999.99,				
            "vlLiquido": 9999999.99,					
            "cdVendedor": 999999,						
            "nrCPFVendedor": "XXXXXXXXXXX"				
        },
       {
            "cdProduto": "XXXXXXXXXXXXXXXXXXXX",
            "cdEspecie": "XXX",
            "qtItem": 9999999.999,
            "vlBruto": 9999999.99,
            "vlDescontoItem": 9999999.99,
            "vlDescontoCapa": 9999999.99,
            "vlLiquido": 9999999.99,
            "cdVendedor": 999999,
            "nrCPFVendedor": "XXXXXXXXXXX"
        }
    ] 
}
Totvs custom tabs box items
defaultno
referenciaexE

URL


BODY

Bloco de código
languagexml
themeRDark
{  
   "cdEmpresa":001,										
   "cdPessoa": 217,										
   "dtMovimento": "25/11/2019",							
   "cdTransacao": "63",	
   "cdOperacao":  501,								
   "cdVendedor": 5,										
   "itens": [
        {
            "cdProduto": "50",		
            "cdEspecie": "XXX",							
            "qtItem": 1,						
            "vlBruto": 259.000,						
            "vlDescontoItem":0.0000 ,				
            "vlDescontoCapa": 0.0000,				
            "vlLiquido": 259.00,					
            "cdVendedor": 5,							
        },
       {
            "cdProduto": "208",
            "cdEspecie": "XXX",
            "qtItem": 1,
            "vlBruto": 89.0000,
            "vlDescontoItem": 17.8000,
            "vlDescontoCapa": 0.0000,
            "vlLiquido": 71.200,
            "cdVendedor": 5,
        }
    ] 
}



Totvs custom tabs box items
defaultno
referenciacampE

 IMAGEM 1                                                                                           IMAGEM 2                                                                                        IMAGEM 3 

  


NomeTipoDescriçãoExemplo VA
cdEmpresa Int
Código da empresa **     
"cdEmpresa":001

Imagem 1 - 5

nrCNPJEmpresa  String
CNPJ da empresa **
"nrCNPJEmpresa": "Informar aqui o CNPJ da empresa"--
cdPessoa IntCódigo do cliente **"cdPessoa": 217Imagem 1 - 1
nrCPFCNPJPessoa StringCPF ou CNPJ do cliente **"nrCPFCNPJPessoa": "Informar aqui o CPF ou CNPJ da pessoa"--
dtMovimento String (Date)Data do movimento"dtMovimento": "25/11/2019"Imagem 1 - 4
cdTransacao *StringCódigo da transação"cdTransacao": "63"Imagem 1 - 3
cdOperacao  IntCódigo da operação ***"cdOperacao": 501Imagem 3 - 12 
cdVendedor IntCódigo do vendedor **"cdVendedor": 5Imagem 1 - 5
nrCPFVendedor StringCPF do vendedor **"nrCPFVendedor": "informar aqui o CPF do vendedor",--
itensArrayArray com os itens da transação----
cdProdutoStringCódigo de barras ou reduzido do produto"cdProduto": "208",

Imagem 2 - 6

cdEspecieStringEspécie do produto"cdEspecie": "XXX"
qtItemDoubleQuantidade de itens"qtItem": 1Imagem 2  - 10
vlBrutoDoubleValor bruto da transação"vlBruto": 89.0000 Imagem 2 - 7
vlDescontoItemDoubleValor desconto do item"vlDescontoItem": 17.8000Imagem 2 - 8
vlDescontoCapaDoubleValor desconto de capa "vlDescontoCapa": 0.0000Imagem 2 - 9
vlLiquidoDoubleValor líquido da transação"vlLiquido": 71.200Imagem 2 - 11
cdVendedorIntCódigo do vendedor **"cdVendedor": 5Imagem 1 - 5 ****
nrCPFVendedorStringCPF do vendedor **"nrCPFVendedor": "Informe aqui o CPF do vendedor"--


* GUID

** Caso o campo Código for informado, não existe a necessidade de informar o documento. Porém, caso o Código não for informado, o documento se torna obrigatório!

*** O código da operação pode ser encontrado no componente GERFM065.

****  No exemplo, foi utilizado o mesmo vendedor da venda para o item. 



Informações

Todos os campos são obrigatórios. Caso possua a opção de informar  código e/ou documento, pelo menos um dos campos deve ser informado!

Totvs custom tabs box items
defaultno
referenciaretorno
Totvs custom tabs box
tabsSucesso, Erro
idssucesso,erro
Totvs custom tabs box items
defaultyes
referenciasucesso
Bloco de código
languagexml
themeRDark
{
  "cdEmpresa": 9999,
  "nrTransacao": 999999999
}
Totvs custom tabs box items
defaultno
referenciaerro

EXEMPLO DE UMA REQUISIÇÃO Q DEU PAU


*COLOCAR OS TIPOS DE ERROS QUE PODE DAR

Totvs custom tabs box items
defaultno
referenciacod

Totvs custom tabs box items
defaultno
referenciatransa


Totvs custom tabs box items
defaultno
referenciadados


...