API WMS BC5
  1. Processos
API WMS BC5
  • Cadastros
    • Motorista
      POST
    • Veículos
      POST
    • Família de Produtos
      POST
    • Grupos de Estoque
      POST
    • Fornecedores
      POST
    • Clientes
      POST
    • Produtos
      POST
    • Cidades
      POST
    • Item Custo
      POST
  • Processos
    • Pedidos de Venda
      POST
    • Peso
      POST
    • Ondas de Separação
      POST
    • Itens Alocados
      POST
    • Controle de Veículos
      POST
    • Apontamento de Ordens de Produção
      POST
    • Baixa de estoque
      POST
    • Cancelamento de Ordem de Montagem (Carga)
      POST
    • Cancelamento de Ordem de Montagem (OM)
      POST
    • Finalização de Controle de Veículo
      POST
    • Inspeção
      POST
    • Cancelamento de Itens da Nota Fiscal de Entrada
      POST
    • Carga Separação
      POST
    • Notas Fiscais de Saída
      POST
    • Ordens de Produção
      POST
    • Notas Fiscais de Entrada
      POST
    • Código de Barras
      POST
  • Outros
    • Consultas Genéricas
      POST
    • Manutenções Genéricas
      POST
  1. Processos

Notas Fiscais de Entrada

POST
/busapi/nf_sup
Endpoint para criar notas fiscais de entrada (aviso de recebimento) no WMS

Requisição

Authorization
Envie suas requisições HTTP com um cabeçalho
Authorization
que contenha a palavra Basic seguida por um espaço e uma string codificada em base64 username:password
Exemplo:
Authorization: Basic *****************
Parâmetros Header

Parâmetros Bodyapplication/json

Exemplo
{
"cod_empresa": "01",
"cod_empresa_estab": null,
"num_nf": 123456,
"ser_nf": "99",
"ssr_nf": 0,
"ies_especie_nf": "NFF",
"cod_fornecedor": "000000000000000",
"num_conhec": 0,
"ser_conhec": "0",
"ssr_conhec": 0,
"cod_transpor":  "000000000000000",
"num_aviso_rec": 0,
"dat_emis_nf": "2025-12-31",
"dat_entrada_nf": "2025-12-31",
"cod_regist_entrada": 1,
"val_tot_nf_c": 12.99,
"val_tot_nf_d": 12.99,
"val_tot_icms_nf_d": 2.99,
"val_tot_icms_nf_c": 2.99,
"val_tot_desc": 12.99,
"val_tot_acresc": 12.99,
"val_ipi_nf": 1.99,
"val_ipi_calc": 1.99,
"val_despesa_aces": 0.99,
"val_adiant": 0.00,
"ies_tip_frete": "0",
"cnd_pgto_nf": "1",
"cod_mod_embar": "3",
"ies_nf_com_erro": "N",
"nom_resp_aceite_er": null,
"ies_incl_cap": "N",
"ies_incl_contab": "N",
"cod_operacao": "5.101",
"ies_calc_subst": "0",
"val_bc_subst_d": 0.00,
"val_icms_subst_d": 0.00,
"val_bc_subst_c": 0.00,
"val_icms_subst_c": 0.00,
"cod_imp_renda": null,
"val_imp_renda": 0.00,
"ies_situa_import": "0",
"val_bc_imp_renda": 0.00,
"ies_nf_aguard_nfe":  "1",
"aviso_rec": [
  {
    "num_seq": 1,
    "dat_inclusao_seq": "2025-12-31",
    "ies_situa_ar": "C",
    "ies_incl_almox": "N",
    "ies_receb_fiscal": "S",
    "ies_liberacao_ar": "1",
    "ies_liberacao_cont": "S",
    "ies_liberacao_insp": "S",
    "ies_diverg_listada": "N",
    "ies_item_estoq": "S",
    "ies_controle_lote": "N",
    "cod_comprador": "34",
    "num_pedido": "0",
    "num_oc": "0",
    "cod_item": "DD0714",
    "den_item": "DESPESAS COM MATERIAIS TRABALHO ESCRITORIO",
    "cod_cla_fisc": "0000.00.00",
    "cod_unid_med_nf": "UN",
    "pre_unit_nf": 1.99,
    "val_despesa_aces_i": 0.00,
    "ies_da_bc_ipi": "S",
    "cod_incid_ipi": 3,
    "ies_tip_incid_ipi": "O",
    "pct_direito_cred": 100.00,
    "pct_ipi_declarad": 0.00,
    "pct_ipi_tabela": 0.00,
    "ies_bitributacao": "N",
    "val_base_c_ipi_it": 0.00 ,
    "val_base_c_ipi_da": 0.00,
    "val_ipi_decl_item": 0.00,
    "val_ipi_calc_item": 0.00,
    "val_ipi_desp_aces": 0.00,
    "val_desc_item": 0.00,
    "val_liquido_item": 1.99,
    "val_contabil_item": 1.99,
    "qtd_declarad_nf": 99.00,
    "qtd_recebida": 0.00,
    "qtd_devolvid": 0.00,
    "dat_devoluc": null,
    "val_devoluc": 0.00,
    "num_nf_dev": 0,
    "qtd_rejeit": 0.00,
    "qtd_liber": 1.99,
    "qtd_liber_excep": 0.00,
    "cus_tot_item": 0.00,
    "cod_fiscal_item": "1.101",
    "gru_ctr_desp_item": 900,
    "cod_local_estoq": "MP",
    "num_lote": null,
    "cod_operac_estoq": " ",
    "val_base_c_item_d": 0.00,
    "val_base_c_item_c": 0.00,
    "pct_icms_item_d": 0.00,
    "pct_icms_item_c": 0.00,
    "pct_red_bc_item_d": 0.00,
    "pct_red_bc_item_c": 0.00,
    "pct_diferen_item_d": 0.00,
   "pct_diferen_item_c": 0.00,
    "val_icms_item_d": 0.00,
    "val_icms_item_c": 0.00,
    "val_base_c_icms_da": 0.00,
    "val_icms_diferen_i": 0.00,
    "val_icms_desp_aces": 0.00,
    "ies_incid_icms_ite": "O",
    "val_frete": 0.00,
    "val_icms_frete_d": 0.00,
    "val_icms_frete_c": 0.00,
    "val_base_c_frete_d": 0.00,
    "val_base_c_frete_c": 0.00,
    "val_icms_diferen_f": 0.00,
    "pct_icms_frete_d": 0.00,
    "pct_icms_frete_c": 0.00,
    "pct_red_bc_frete_d": 0.00,
    "pct_red_bc_frete_c": 0.00,
    "pct_diferen_fret_d": 0.00,
    "pct_diferen_fret_c": 0.00,
    "val_acrescimos": 0.00,
    "val_enc_financ": 0.00,
    "ies_contabil": "S",
    "ies_total_nf": "S",
    "val_compl_estoque": 0.00,
    "dat_ref_val_compl": null,
    "pct_enc_financ": 0.00,
    "cod_cla_fisc_nf": " ",
    "cod_tip_despesa": 714,
    "observacao": null
  }
 ]
}

Códigos de solicitação

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/busapi/nf_sup' \
--header 'charset: iso8859-1' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data-raw '{
"cod_empresa": "01",
"cod_empresa_estab": null,
"num_nf": 123456,
"ser_nf": "99",
"ssr_nf": 0,
"ies_especie_nf": "NFF",
"cod_fornecedor": "000000000000000",
"num_conhec": 0,
"ser_conhec": "0",
"ssr_conhec": 0,
"cod_transpor":  "000000000000000",
"num_aviso_rec": 0,
"dat_emis_nf": "2025-12-31",
"dat_entrada_nf": "2025-12-31",
"cod_regist_entrada": 1,
"val_tot_nf_c": 12.99,
"val_tot_nf_d": 12.99,
"val_tot_icms_nf_d": 2.99,
"val_tot_icms_nf_c": 2.99,
"val_tot_desc": 12.99,
"val_tot_acresc": 12.99,
"val_ipi_nf": 1.99,
"val_ipi_calc": 1.99,
"val_despesa_aces": 0.99,
"val_adiant": 0.00,
"ies_tip_frete": "0",
"cnd_pgto_nf": "1",
"cod_mod_embar": "3",
"ies_nf_com_erro": "N",
"nom_resp_aceite_er": null,
"ies_incl_cap": "N",
"ies_incl_contab": "N",
"cod_operacao": "5.101",
"ies_calc_subst": "0",
"val_bc_subst_d": 0.00,
"val_icms_subst_d": 0.00,
"val_bc_subst_c": 0.00,
"val_icms_subst_c": 0.00,
"cod_imp_renda": null,
"val_imp_renda": 0.00,
"ies_situa_import": "0",
"val_bc_imp_renda": 0.00,
"ies_nf_aguard_nfe":  "1",
"aviso_rec": [
  {
    "num_seq": 1,
    "dat_inclusao_seq": "2025-12-31",
    "ies_situa_ar": "C",
    "ies_incl_almox": "N",
    "ies_receb_fiscal": "S",
    "ies_liberacao_ar": "1",
    "ies_liberacao_cont": "S",
    "ies_liberacao_insp": "S",
    "ies_diverg_listada": "N",
    "ies_item_estoq": "S",
    "ies_controle_lote": "N",
    "cod_comprador": "34",
    "num_pedido": "0",
    "num_oc": "0",
    "cod_item": "DD0714",
    "den_item": "DESPESAS COM MATERIAIS TRABALHO ESCRITORIO",
    "cod_cla_fisc": "0000.00.00",
    "cod_unid_med_nf": "UN",
    "pre_unit_nf": 1.99,
    "val_despesa_aces_i": 0.00,
    "ies_da_bc_ipi": "S",
    "cod_incid_ipi": 3,
    "ies_tip_incid_ipi": "O",
    "pct_direito_cred": 100.00,
    "pct_ipi_declarad": 0.00,
    "pct_ipi_tabela": 0.00,
    "ies_bitributacao": "N",
    "val_base_c_ipi_it": 0.00 ,
    "val_base_c_ipi_da": 0.00,
    "val_ipi_decl_item": 0.00,
    "val_ipi_calc_item": 0.00,
    "val_ipi_desp_aces": 0.00,
    "val_desc_item": 0.00,
    "val_liquido_item": 1.99,
    "val_contabil_item": 1.99,
    "qtd_declarad_nf": 99.00,
    "qtd_recebida": 0.00,
    "qtd_devolvid": 0.00,
    "dat_devoluc": null,
    "val_devoluc": 0.00,
    "num_nf_dev": 0,
    "qtd_rejeit": 0.00,
    "qtd_liber": 1.99,
    "qtd_liber_excep": 0.00,
    "cus_tot_item": 0.00,
    "cod_fiscal_item": "1.101",
    "gru_ctr_desp_item": 900,
    "cod_local_estoq": "MP",
    "num_lote": null,
    "cod_operac_estoq": " ",
    "val_base_c_item_d": 0.00,
    "val_base_c_item_c": 0.00,
    "pct_icms_item_d": 0.00,
    "pct_icms_item_c": 0.00,
    "pct_red_bc_item_d": 0.00,
    "pct_red_bc_item_c": 0.00,
    "pct_diferen_item_d": 0.00,
   "pct_diferen_item_c": 0.00,
    "val_icms_item_d": 0.00,
    "val_icms_item_c": 0.00,
    "val_base_c_icms_da": 0.00,
    "val_icms_diferen_i": 0.00,
    "val_icms_desp_aces": 0.00,
    "ies_incid_icms_ite": "O",
    "val_frete": 0.00,
    "val_icms_frete_d": 0.00,
    "val_icms_frete_c": 0.00,
    "val_base_c_frete_d": 0.00,
    "val_base_c_frete_c": 0.00,
    "val_icms_diferen_f": 0.00,
    "pct_icms_frete_d": 0.00,
    "pct_icms_frete_c": 0.00,
    "pct_red_bc_frete_d": 0.00,
    "pct_red_bc_frete_c": 0.00,
    "pct_diferen_fret_d": 0.00,
    "pct_diferen_fret_c": 0.00,
    "val_acrescimos": 0.00,
    "val_enc_financ": 0.00,
    "ies_contabil": "S",
    "ies_total_nf": "S",
    "val_compl_estoque": 0.00,
    "dat_ref_val_compl": null,
    "pct_enc_financ": 0.00,
    "cod_cla_fisc_nf": " ",
    "cod_tip_despesa": 714,
    "observacao": null
  }
 ]
}'

Respostas

🟢200Success
application/json
Body

Exemplo
{
    "data": "2023-05-04",
    "hora": "09:54:58",
    "message": "PROCESSAMENTO EFETUADO COM SUCESSO",
    "status": "SUCESSO",
    "num_aviso_rec": 32755
}
Modificado em 2025-08-15 18:09:09
Página anterior
Ordens de Produção
Próxima página
Código de Barras
Built with