TOTVS Moda

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

  1. Consultar fiscal

    • Requisição que retorna as Notas Fiscais filtrando por dia e ou situação.

  2. Consultar dados de fiscal

    • Requisição que retorna os dados da Nota Fiscal.

  3. Consultar dados dos itens de fiscal

    • Requisição que retorna os dados dos itens da Nota Fiscal.


URL
https://www30.bhan.com.br:9443/api/v1/fiscal/lista
MÉTODO
POST
CABEÇALHO
Token: "XXXXXXXXXXXXXX"
EXEMPLO REQUISIÇÃO 
{
	"cdEmpresa": 1,
	"dtMovimentoInicial": "02/10/2019",
	"dtMovimentoFinal": "02/10/2019"
}
EXEMPLO RESPOSTA 
[
    {
		"cdOperacao": 9999,           // código da operação
        "cdEmpresa": 9999,            // código da empresa 
        "nrFatura": 999999,           // número da fatura
        "dtFatura": "DD/MM/YYYY",     // data da fatura
        "nrNota": 999999,             // número da nota fiscal
        "cdSerie": "999",             // código da série fiscal (0 ~ 999)
        "tpSituacao": "X",            // situação da nota (N - Normal / E - Emitida / C - Cancelada)
        "dtEmissao": "DD/MM/YYYY",    // data de emissão
        "qtProduto": 999.999,         // qtde de produto fatura na nota
        "vlTotal": 999999999.99,      // valor total da nota
        "tpModeloNf": 99,             // tipo modelo documento fiscal (55 - NFE / 65 - NFCE / 59 - SAT)
        "tpOperacao": "X",            // tipo operação fiscal (E - Entrada / S - Saida)
        "tpModalidade": "X",          // tipo modalidade (3 - Devolução / 4 - Venda)
    }
]
URL
https://www30.bhan.com.br:9443/api/v1/fiscal/dados
MÉTODO
POST
CABEÇALHO
Token: "XXXXXXXXXXXXXX"
EXEMPLO REQUISIÇÃO 
{
	"cdEmpresa": 1,
    "nrFatura": 839059,
    "dtFatura": "02/10/2019"
}
EXEMPLO RESPOSTA 
{
    "cdEmpresa": 9999,            // código da empresa
    "nrFatura": 999999,           // número da fatura
    "dtFatura": "DD/MM/YYYY",     // data da fatura
    "cdPessoa": 999999999,        // código da pessoa
    "cdFiscal": "XXXXXXXXXX",     // código do fiscal para integração
    "cdOperacao": 9999,           // código da operação
    "cdVendedor": 9999,           // código do vendedor
    "tpSituacao": "X",            // situação da nota (N - Normal / E - Emitida / C - Cancelada)
    "nrNota": 999999,             // número da nota fiscal
    "cdSerie": "999",             // código da série fiscal (0 ~ 999)
    "dtEmissao": "DD/MM/YYYY",    // data de emissão
    "qtProduto": 999.999,         // qtde de produto fatura na nota
    "vlTotal": 999999999.99,      // valor total da nota
    "tpModeloNf": 99,             // tipo modelo documento fiscal (55 - NFE / 65 - NFCE / 59 - SAT)
    "tpOperacao": "X",            // tipo operação fiscal (E - Entrada / S - Saida)
    "tpModalidade": "X",          // tipo modalidade (3 - Devolução / 4 - Venda)
    "itens": [
        {
            "nrItem": 9999,                                                               // número do item
            "cdProduto": "XXXXXXXXXXXXXXXXXXXX",                                          // código do produto
            "dsProduto": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",  // descrição do produto
            "cdEspecie": "XX",                                                            // unidade de medida (PC, KG, MT)
            "qtItem": 999.999,                                                            // qtde do item
            "vlBruto": 999999999.99,                                                      // valor bruto
            "vlUnitarioBruto": 999999999.99,                                              // valor unitário bruto
            "vlDescontoItem": 999999999.99,                                               // valor desconto do item
            "vlLiquido": 999999999.99,                                                    // valor líquido
            "vlUnitarioLiquido": 999999999.99,                                            // valor unitário líquido
            "cdVendedor": 9999,                                                           // código do vendedor
            "impostos": [
                {
                    "cdImposto": 99,               // código do imposto (1 - ICMS, 2 - ICMS ST, 3 - IPI, 5 - COFINS, 6 - PIS)
                    "vlBaseCalculo": 999999999.99, // valor base de cálculo
                    "prBaseCalculo": 999.99,       // percentual base de cálculo
                    "prReducaoBase": 999.99,       // percentual redução da base de cálculo
                    "prAliquota": 999.99,          // percentual alíquota do imposto
                    "vlImposto": 999999999.99,     // valor do imposto
                    "vlIsento": 999999999.99,      // valor de isenção
                    "vlOutro": 999999999.99,       // valor de outro
                    "cdCst": "999"                 // código da situação tributária
                }
            ]
        }
    ]
}
URL
https://www30.bhan.com.br:9443/api/v1/fiscal/dadositens
MÉTODO
POST
CABEÇALHO
Token: "XXXXXXXXXXXXXX"
EXEMPLO REQUISIÇÃO 
{
	    "cdEmpresa": 999999999,
        "nrFatura": 99999999,
        "dtFatura": "XX/XX/XXXX",
        "cdProduto": 9999999
}
EXEMPLO RESPOSTA 
[
    {
        "cdEmpresa": 999999,                            //Código da empresa
        "nrFatura": 99999,                              //Número da fatura
        "dtFatura": "DD/MM/YYYY",                       //Data da fatura
        "nrNF": 99999,                                  //Número da Nota Fiscal
        "cdSerie": "XXX",                               //Código da Série da NF
        "dtEmissao": "DD/MM/YYYY",                      //Data de Emissão
        "cdRFID": "XXXXXXXXXXXXXXXXXXXX",               //Código RFID do produto
        "inGTIN": "X",                                  //Produto GTIN (F - False / T - True)
        "cdEAN": "XXXXXXXXXX",                          //Código EAN do produto
        "cdProduto": "XXXXXXXXXXXX",                    //Código do produto
        "dsProduto": "XXXXXXXXXXXXXXXXXXXXXXX",         //Descrição do produto 
        "cdReferencia": "XXXXXXXX",                     //Código da referência do produto
        "vlUnitLiquido": 999999.99                      //valor unitário líquido do produto (vlBruto - vlDesconto)
    }
]