01. INTRODUÇÃO

Deverá conter uma breve explicação do que é a API e o que ela faz



02. INCLUIR TRANSAÇÃO POR EMPRESA


    https://www30.bhan.com.br:9443/api/v1/transacao/inclusao

Corpo da requisição 

{  
   "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"
        }
    ] 
}

URL

    https://www30.bhan.com.br:9443/api/v1/transacao/inclusao


BODY



 IMAGEM 1                                                                                           IMAGEM 2                                                                                        IMAGEM 3
  

NomeTipoDescriçãoExemplo 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 pessoa *"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 vendedor *"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 CPF *"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.  
{
  "cdEmpresa": 9999,
  "nrTransacao": 999999999
}
EXEMPLO DE UMA REQUISIÇÃO Q DEU PAU

*COLOCAR OS TIPOS DE ERROS QUE PODE DAR








  1. Incluir transação por empresa
  2. Consultar transação
  3. Consultar dados de transação