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, Corpo, 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

Totvs custom tabs box items
defaultno
referenciacorpoE

Corpo da requisição 

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



Totvs custom tabs box items
defaultno
referenciacampE

 IMAGEM 1                                                                                           IMAGEM 2                                                                                        IMAGEM 3

Image Modified Image Modified Image Modified


NomeTipoDescriçãoExemploReferencia com a tela do VA VA
cdEmpresaInt
Código da empresa ou CNPJ *
"cdEmpresa":001

Imagem 1 - 5

nrCNPJEmpresaString
CNPJ ou código da empresa *
"nrCNPJEmpresa": "Informar aqui o CNPJ da empresa"--
cdPessoaIntCódigo da pessoapessoa *"cdPessoa": 217Imagem 1 - 1
nrCPFCNPJPessoaStringCPF ou CNPJ do cliente *"nrCPFCNPJPessoa": "Informar aqui o CPF ou CNPJ da pessoa"--
dtMovimentoString (Date)Data do movimento"dtMovimento": "25/11/2019"Imagem 1 - 4
cdTransacaoStringCódigo da transação"cdTransacao": "63"Imagem 1 - 3
cdOperacaoIntCódigo da operação"cdOperacao": 999999Imagem 3 - 12 
cdVendedorIntCódigo do vendedorvendedor *"cdVendedor": 5Imagem 1 - 5
nrCPFVendedorStringCPF 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 ou CPFCPF *"cdVendedor": 5Imagem 1 - 5 **
nrCPFVendedorStringCPF ou código do vendedor *"nrCPFVendedor": "Informe aqui o CPF do vendedor"--



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!

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

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


...