01. INTRODUÇÃO

Requisição que realiza a inclusão de uma transação por empresa.

Link para documentação técnica: Inclusão de transação

02. UTILIZAÇÃO

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

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

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



 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 - 2
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 - 2 ****
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. 



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!

{
  "cdEmpresa": 9999,
  "nrTransacao": 999999999
}

EXEMPLO DE UMA REQUISIÇÃO Q DEU PAU


*COLOCAR OS TIPOS DE ERROS QUE PODE DAR

Implementação da API em C#

01. INTRODUÇÃO

Requisição que retorna as transações filtrando por dia e ou situação.

Link para documentação técnica: Consulta de transação

02. UTILIZAÇÃO

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

{
        "cdEmpresa": 9999,									
        "nrCNPJEmpresa": "XXXXXXXXXXXX",					
        "cdPessoa": 9999,										
        "nrCPFCNPJPessoa": "XXXXXXXXXXXX",					
        "dtMovimento": "99/99/9999",						
        "situacoes": [9],										
        "cdOperacao": 9999,									
        "cdVendedor": 9999,									
        "nrCPFVendedor": "XXXXXXXXXXXX"
}

URL

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


BODY



 IMAGEM 1                                                                                           IMAGEM 2                                                                                
  

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
situacoesArraySituação da transação"situações": [1,2,3,4]
cdOperacao  IntCódigo da operação ***"cdOperacao": 501Imagem 2 - 12 
cdVendedor IntCódigo do vendedor **"cdVendedor": 5Imagem 1 - 2
nrCPFVendedor StringCPF do vendedor **"nrCPFVendedor": "informar aqui o CPF do vendedor",--

* Obrigatório
** 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.
{
        "cdEmpresa": 9999,									
        "nrTransacao": 9999,						
        "dtTransacao": "99/99/9999",
}
EXEMPLO DE UMA REQUISIÇÃO Q DEU PAU

*COLOCAR OS TIPOS DE ERROS QUE PODE DAR
Implementação da API em C#
01. INTRODUÇÃO
Requisição que retorna os dados da transação.
Link para documentação técnica: Consulta dados de transação
02. UTILIZAÇÃO
    https://www30.bhan.com.br:9443/api/v1/transacao/dados
{
        "cdEmpresa": 9999,									
        "nrTransacao": 9999,						
        "dtTransacao": "99/99/9999",
}
URL
    https://www30.bhan.com.br:9443/api/v1/transacao/lista

BODY


 IMAGEM 1                                                                                                                                                                         
  

NomeTipoDescriçãoExemplo VA
cdEmpresa Int
Código da empresa     
"cdEmpresa":001
Imagem 1 - 1
nrTransacaoIntNumero da transação"nrTransacao": 63Imagem 1 - 2
dtTransacaoString (date)Data da transação"dtTransacao": "25/11/2019"Imagem 1 - 3
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!
{
    "cdEmpresa": 4,											"Código da Empresa"
    "nrTransacao": 578920,									"Número da Transação"
    "dtTransacao": "11/09/2019",							"Data da Transação"
    "cdPessoa": 14098,										"Código do Cliente"
    "cdTransacao": "000000022",								"Código de Transação"
    "cdOperacao": 7,										"Código de Operação"
    "cdVendedor": 50,										"Código do Vendedor"
    "tpSituacao": 4,										"Situação da Transação (Ex.: 1 - Em andamento, 2 - Liberada p/ faturamento; Ex. preenchimento: [1,2,3,4])"
    "itens": [
        {
            "nrItem": 1,									"Número do Item"
            "cdProduto": "82227",							"Código do Produto"
            "dsProduto": "PRODUTO CAMISA 001 AZUL P",		"Descrição do Produto"
            "cdEspecie": "PC",								"Espécie do Produto"
            "qtItem": 1,									"Quantidade Solicitada"
            "vlBruto": 10.54,								"Valor Bruto Total"
            "vlUnitarioBruto": 10.54,						"Valor Unitário Bruto"
            "vlDescontoItem": 10.54,						"Valor de Desconto do Item"
            "vlDescontoCapa": 0,							"Valor de Desconto da Capa"
            "vlLiquido": 0,									"Valor líquido total"
            "vlUnitarioLiquido": 0,							"Valor Unitário Líquido"
            "cdVendedor": 50								"Código do Vendedor para o Item"
        }
    ]
}
EXEMPLO DE UMA REQUISIÇÃO Q DEU PAU

*COLOCAR OS TIPOS DE ERROS QUE PODE DAR
Implementação da API em C#





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