WebgexERP API
  1. Despesas
WebgexERP API
  • Introdução
  • Padrão de Response
  • Endpoints
    • Cadastros
      • Organização
        • Unidades
          • Unidades
        • Centros de Resultado
          • Centros de Resultado
        • Armazens
          • Armazéns
        • Plano de Contas
          • Plano de Contas
        • Naturezas Financeiras
          • Naturezas Financeiras
        • Itens Contábeis
          • Itens Contábeis
        • Classificações Contábeis
          • Classificações Contábeis
        • Códigos de Remuneração
          • Códigos de Remuneração
      • Pessoas Físicas/Jurídicas
        • Clientes
          • Clientes
        • Fornecedores
          • Fornecedores
          • Detalhes do Fornecedor
        • Parceiros
          • Parceiros
          • Detalhes do Parceiro
        • Empregados
          • Empregados
          • Detalhes do Empregado
        • Grupos Empresariais
          • Grupos Empresariais
      • Produtos e Serviços
        • Categorias
          • Categorias
        • Produtos
          • Produtos
        • Serviços
          • Serviços
          • Detalhes do Serviço
        • Materiais
          • Materiais
          • Detalhes do Material
        • Produtos Base
          • Produtos Base
          • Detalhes do Produto Base
        • Produtos Variantes
          • Produtos Variantes
        • Kits e Composições
          • Kits e Composições
        • Preços
          • Preços
    • Lançamentos
      • Despesas
        • Despesas
          GET
        • Detalhes da Despesa
          GET
        • Criar Despesa
          POST
        • Folha de Pagamento
          GET
      • Documentos Fiscais
        • Notas Fiscais Emitidas
          • Notas Fiscais Emitidas
          • Detalhes da Nota Fiscal Emitida
        • Notas Fiscais ao Consumidor Emitidas
          • Notas Fiscais ao Consumidor Emitidas
          • Detalhes da nota fiscal ao consumidor emitida
        • Cupons Fiscais Emitidos
          • Cupons Fiscais Emitidos
          • Detalhes do Cupom Fiscal Emitido
        • Notas Fiscais de Serviço Emitidas
          • Notas Fiscais de Serviço Emitidas
          • Detalhes da Nota Fiscal de Serviço Emitidas
        • Notas Fiscais de Entrada
          • Notas Fiscais Recebidas
          • Detalhes da Nota fiscal de Entrada
    • Controladoria
      • Contabilidade
        • Lançamentos Contábeis
          • Lançamentos Contábeis
        • Saldos Contábeis
          • Saldos Contábeis
      • Orçamento
        • Orçamento
          • Orçamento
      • Imobilizado
        • Itens de Imobilizado
          • Itens de Imobilizado
    • Financeiro
      • Tesouraria
        • Contas, Caixas e Cartões
          • Contas, Caixas e Cartões
        • Saldos das Contas
          • Saldos das Contas
      • Contas a Pagar
        • Contas a Pagar
          • Contas a Pagar*
      • Contas a Receber
        • Contas a Receber
          • Contas a Receber*
    • Operacional
      • Controle de Estoque
        • Posição de Estoque
          • Posição de Estoque
      • Compras
        • Carteira Pedidos de Compra
          • Carteira Pedidos de Compra
        • Histórico de Compras
          • Histórico de Compras
      • Projetos e Contratos
        • Projetos
          • Projetos
        • Gestão de Projetos
          • Gestão de Projetos
      • Serviços
        • Veículos
          • Veículos
        • Ordens de Serviço Automotivo
          • Ordens de Serviço Automotivo
        • Histórico de Serviços
          • Histórico de Veículos
    • Relatórios
      • Relatórios de Vendas
        • Vendas Detalhadas
    • Configuração
      • Acessos e Auditoria
        • Utilizadores
          • Utilizadores
      • Parametrização
        • Transações
          • Transações*
  1. Despesas

Criar Despesa

POST
/erp/despesas
Insere uma despesa no WebgexERP.

Requisição

Authorization
Adicionar parâmetro em header
WGX-API-KEY
Exemplo:
WGX-API-KEY: ********************
Parâmetros Bodyapplication/json

Examples

Respostas

🟢200OK
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/erp/despesas' \
--header 'WGX-API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id_unidade": 7,
    "id_fornecedor": 5,
    "tipo_documento": "NFSE",
    "numero_documento": 1236,
    "serie_documento": 1,
    "data_documento": "2025-08-28",
    "data_emissao": "2025-08-28",
    "historico": "Office supplies",
    "valor": 1500.00,
    "rateio": {
        "id_natureza_financeira": 70,
        "id_centro_resultado": 58
    },
    "forma_pagamento": {
        "forma_pagamento": "BOL",
        "data_vencimento": "2025-08-28",
        "quantidade_parcelas": 1,
        "intervalo_parcelas": 1,
        "periodo": "MES"
    }
}'
Response Response Example
{
    "status": "OK",
    "date": "2025-08-26T15:15:56.184113",
    "contentType": "application/json",
    "content": {
        "valor_retencoes": 1205.0,
        "descricao_centro_de_resultado": "CONSELHO",
        "data": "2020-06-10",
        "numero": 1234,
        "nome_fornecedor": "UNIGEX SOLUÇÕES INTEGRADAS DE GESTÃO",
        "imposto": false,
        "historico": "ERP",
        "valor": 10000.0,
        "id_natureza_financeira": 87,
        "descricao_projeto": null,
        "forma_pagamento": [
            {
                "forma_pagamento": "BOLETO",
                "codigo_prazo": "1X",
                "valor": 8795.0,
                "descricao_prazo": "BOLETO 1X",
                "id": 18461,
                "vencimento": "2020-06-30",
                "seq": "01"
            }
        ],
        "rateio": [
            {
                "codigo_projeto": null,
                "codigo_item_projeto": null,
                "descricao_centro_de_resultado": "CONSELHO",
                "codigo_contrato": null,
                "codigo_item_contrato": null,
                "valor": 10000.0,
                "id": 28385,
                "codigo_unidade": "20001",
                "descricao_natureza_financeira": "SERVIÇOS DE SOFTWARES"
            }
        ],
        "tipo_documento": "NFSE",
        "id_fornecedor": 5,
        "valor_liquido": 8795.0,
        "retencao": [
            {
                "tipo": "RTINS",
                "base_de_calculo": 10000.0,
                "retencao": 3.0,
                "valor_retencao": 300.0,
                "id": 75,
                "descricao": "RETENÇÃO INSS"
            },
            {
                "tipo": "RT465",
                "base_de_calculo": 10000.0,
                "retencao": 4.65,
                "valor_retencao": 465.0,
                "id": 73,
                "descricao": "RETENÇÃO 4,65%"
            },
            {
                "tipo": "RTIRF",
                "base_de_calculo": 10000.0,
                "retencao": 1.5,
                "valor_retencao": 150.0,
                "id": 74,
                "descricao": "RETENÇÃO IRRF"
            },
            {
                "tipo": "RTISS",
                "base_de_calculo": 10000.0,
                "retencao": 2.9,
                "valor_retencao": 290.0,
                "id": 76,
                "descricao": "RETENÇÃO ISS"
            }
        ],
        "serie": 0,
        "id": 10506,
        "codigo_unidade": "20001",
        "descricao_natureza_financeira": "SERVIÇOS DE SOFTWARES",
        "id_centro_de_resultado": 31,
        "contabilidade": [
            {
                "codigo_cr": "0101",
                "debito": 0.0,
                "data": "2024-08-14",
                "descricao_conta": "BNB Ag. 317-0 Conta 3602-5 On line Produção",
                "codigo_conta": "111207",
                "historico": "PAGAMENTO - BOLETO -",
                "credito": 795.0,
                "id": 24054,
                "numero_contabil": "000000001997",
                "codigo_item": null
            },
            {
                "codigo_cr": "0101",
                "debito": 0.0,
                "data": "2020-06-10",
                "descricao_conta": "ISS retido na fonte",
                "codigo_conta": "213202",
                "historico": "ERP",
                "credito": 290.0,
                "id": 22308,
                "numero_contabil": "000000001671",
                "codigo_item": null
            },
            {
                "codigo_cr": "0101",
                "debito": 795.0,
                "data": "2024-08-14",
                "descricao_conta": "Fornecedores Nacionais ",
                "codigo_conta": "212101",
                "historico": "PAGAMENTO - BOLETO -",
                "credito": 0.0,
                "id": 24055,
                "numero_contabil": "000000001997",
                "codigo_item": null
            },
            {
                "codigo_cr": "0101",
                "debito": 0.0,
                "data": "2020-06-10",
                "descricao_conta": "Fornecedores Nacionais ",
                "codigo_conta": "212101",
                "historico": "ERP",
                "credito": 8795.0,
                "id": 22304,
                "numero_contabil": "000000001671",
                "codigo_item": null
            },
            {
                "codigo_cr": "0101",
                "debito": 0.0,
                "data": "2020-06-10",
                "descricao_conta": "IRRF a Recolher",
                "codigo_conta": "213304",
                "historico": "ERP",
                "credito": 150.0,
                "id": 22305,
                "numero_contabil": "000000001671",
                "codigo_item": null
            },
            {
                "codigo_cr": "0101",
                "debito": 0.0,
                "data": "2020-06-10",
                "descricao_conta": "CSRF a Recolher",
                "codigo_conta": "213305",
                "historico": "ERP",
                "credito": 465.0,
                "id": 22307,
                "numero_contabil": "000000001671",
                "codigo_item": null
            },
            {
                "codigo_cr": "0101",
                "debito": 0.0,
                "data": "2020-06-10",
                "descricao_conta": "INSS a Recolher",
                "codigo_conta": "213310",
                "historico": "ERP",
                "credito": 300.0,
                "id": 22306,
                "numero_contabil": "000000001671",
                "codigo_item": null
            },
            {
                "codigo_cr": "0101",
                "debito": 10000.0,
                "data": "2020-06-10",
                "descricao_conta": "Serviços de Software",
                "codigo_conta": "333304",
                "historico": "ERP",
                "credito": 0.0,
                "id": 22303,
                "numero_contabil": "000000001671",
                "codigo_item": null
            }
        ],
        "status": "CONFIRMADO"
    },
    "success": true
}
Modificado em 2025-09-19 18:34:15
Página anterior
Detalhes da Despesa
Próxima página
Folha de Pagamento
Built with