OpenAPITodas as operações em OpenAPI (Postman, Insomnia).
Serviços · Contrato

Contrato de Serviço

POSThttps://app.omie.com.br/api/v1/servicos/contrato/WSDL
2consultas
4alterações
Claude 6 de 6 · ChatGPT 1 de 6 · MCP 6 de 6pelos assistentes de IA
JSON · XMLformato

AlterarContrato

altera dadosClaudeMCP

Alterar um Contrato

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 10Campos e estruturas que você pode enviar
CampoTipoDescrição
cabecalhoobjeto
cabecalho.cCodIntCtrtexto · até 20Código de integração do contrato de serviços. (Utilizado em contratos criados via API, não é visualizado na tela)
cabecalho.cCodSittexto · até 2Código da situação do contrato de serviços. Pode ser: 00 - Em Elaboração 10 - Ativo 90 - Suspenso 99 - Cancelado
cabecalho.cNumCtrtexto · até 60Número do contrato de serviços. (Informado pelo usuário / visualizado na tela)
cabecalho.cTipoFattexto · até 2Tipo de Faturamento do Contrato. Pode ser: 01 - Todo Mês (mensal) 02 - A cada 2 meses (bimestral) 03 - A cada 3 meses (trimestral) 06 - A cada 6 meses (semestral) 12 - A cada 12 meses (anual)
cabecalho.dVigFinaltexto · até 10Data de vigência final do contrato de serviços.
cabecalho.dVigInicialtexto · até 10Data da vigência inicial do contrato de serviços.
cabecalho.nCodClinúmero inteiroCódigo do cliente a que se refere o contrato de serviços. (Gerado internamente, não é visualizado na tela)
cabecalho.nCodCtrnúmero inteiroCódigo do contrato de serviços. (Gerado internamente, não é visualizado na tela)
cabecalho.nDiaFatnúmero inteiroDia de faturamento.
cabecalho.nValTotMesnúmeroValor total mensal do contrato de serviços. (Calculado automaticamente)
departamentoslista de objetosDistribuição por departamento
departamentos[].cCodDeptexto · até 40Código do Departamento
departamentos[].cDesDeptexto · até 50Descrição do Departamento
departamentos[].nPerDepnúmeroPercentual do rateio
departamentos[].nValDepnúmeroValor do rateio
despesasReembolsaveisobjetoDespesas reembolsáveis
despesasReembolsaveis.cCodCategReembtexto · até 20Código da categoria para reembolso
despesasReembolsaveis.despesaReembolsavellista de objetosDespesa reembolsável
despesasReembolsaveis.despesaReembolsavel[].cAcaoReembtexto · até 1Ação para o reembolso, pode ser: I - Inclusão A - Alteração E - Exclusão
despesasReembolsaveis.despesaReembolsavel[].cDescReembtexto · até 200Descrição do reembolso
despesasReembolsaveis.despesaReembolsavel[].cRecorrenteReembtexto · até 1Indica se o reembolso é recorrente. [S/N]
despesasReembolsaveis.despesaReembolsavel[].dDataReembtexto · até 10Data do reembolso
despesasReembolsaveis.despesaReembolsavel[].nCodReembnúmero inteiroID do Reembolso
despesasReembolsaveis.despesaReembolsavel[].nValorReembnúmeroValor do Reembolso
emailClienteobjetoDados do envio de e-mail do cliente
emailCliente.cEnvViaUnicatexto · até 1Enviar ao cliente Via Única (Nota Fiscais Modelos 21 e 22). Pode ser: S - Sim N - Não
emailCliente.cEnviarBoletotexto · até 1Enviar também o(s) boleto(s) de cobrança
emailCliente.cEnviarLinkNfsetexto · até 1Enviar o link da NFS-e gerada na Prefeitura
emailCliente.cEnviarPixtexto · até 1Enviar também o(s) PIX(s) de cobrança
emailCliente.cEnviarRecibotexto · até 1Enviar um recibo de prestação de serviço (ao invés de NFS-e)
emailCliente.cUtilizarEmailstextoUtilizar os seguintes endereços de e-mail
infAdicobjeto
infAdic.cCidPrestServtexto · até 40Cidade da Prestação do Serviço e Estado
infAdic.cCodARTtexto · até 20Código ART
infAdic.cCodCategtexto · até 20Código da Categoria
infAdic.cCodObratexto · até 15Código da Obra
infAdic.cContatotexto · até 100Nome do Contato
infAdic.cDadosAdicNFtextoDados Adicionais para a Nota Fiscal
infAdic.cNumEncaptexto · até 15Código de Encapsulamento de notas dedutoras
infAdic.cUsoConsumotexto · até 1Uso e consumo pessoal. (0=Não, 1=Sim).
infAdic.nCodCCnúmero inteiroCódigo da Conta Corrente
infAdic.nCodProjnúmero inteiroCódigo do Projeto
infAdic.nCodVendnúmero inteiroCódigo do Vendedor
infAdic.nIdDestinatarionúmero inteiroID Cliente para o Destinatário.
infoCadastroobjetoInformações complementares do contrato.
infoCadastro.cImpAPItexto · até 1Importado pela API (S/N). Não deve ser informado na Inclusão/Alteração.
infoCadastro.cOrigemtexto · até 3Origem do Contrato de Serviço. Informado na Inclusão.
infoCadastro.dAlttexto · até 10Data da Alteração. No formato dd/mm/aaaa. Não deve ser informado na Inclusão/Alteração.
infoCadastro.dInctexto · até 10Data da Inclusão. No formato dd/mm/aaaa. Não deve ser informado na Inclusão/Alteração.
infoCadastro.hAlttexto · até 8Hora da Alteração. No formato hh:mm:ss. Não deve ser informado na Inclusão/Alteração.
infoCadastro.hInctexto · até 8Hora da Inclusão. No formato hh:mm:ss. Não deve ser informado na Inclusão/Alteração.
infoCadastro.uAlttexto · até 10Usuário da Alteração. Não deve ser informado na Inclusão/Alteração.
infoCadastro.uInctexto · até 10Usuário da Inclusão. Não deve ser informado na Inclusão/Alteração.
itensContratolista de objetos
itensContrato[].itemCabecalhoobjeto
itensContrato[].itemCabecalho.aliqDescontonúmeroAliquota do Desconto.
itensContrato[].itemCabecalho.cCodCategItemtexto · até 20Código da Categoria.
itensContrato[].itemCabecalho.cNaoGerarFinanceirotexto · até 1Não gerar conta a receber para este item. Informar "S" para não gerar movimento financeiro. Informar "N" para gerar movimento financeiro.
itensContrato[].itemCabecalho.cTpDescontotexto · até 1Tipo de Desconto. Pode ser: P - Percentual V - Valor
itensContrato[].itemCabecalho.codIntItemtexto · até 30Código de integração do item do contrato.
itensContrato[].itemCabecalho.codItemnúmero inteiroIdentificação do Item do Contrato. (Gerado automaticamente na Inclusão do item do contrato)
itensContrato[].itemCabecalho.codLC116texto · até 10Código do Serviço conforme Lei Complementar (LC 116). Caso tenha informado a tag "codServico" o preenchimento passa a ser opcional e irá assumir o valor informado no cadastro do respectivo serviço. Tabela única para todos os municípios.
itensContrato[].itemCabecalho.codNBStexto · até 9Código da Nomenclatura Brasileira de Serviços (NBS). Caso tenha informado a tag "codServico" irá assumir o valor informado no cadastro do respectivo serviço.
itensContrato[].itemCabecalho.codServMunictexto · até 20Código do Serviço Municipal ou CNAE. Caso tenha informado a tag "codServico" o preenchimento passa a ser opcional e irá assumir o valor informado no cadastro do respectivo serviço. Valores pode variar de acordo com o município. Verifique a legislação da sua cidade para obter os códigos de serviço disponíveis.
itensContrato[].itemCabecalho.codServiconúmero inteiroCódigo Interno do Serviço conforme cadastrado na tabela de serviços. Caso preenchido, irá assumir as informações do cadastro de serviço. Se não for preenchido, assumirá os valores informados na API.
itensContrato[].itemCabecalho.natOperacaotexto · até 2Natureza da Operação ou Tipo de Tributação dos Serviços. Caso tenha informado a tag "codServico" o preenchimento passa a ser opcional e irá assumir o valor informado no cadastro do respectivo serviço. Valores pode variar de acordo com o município. Verifique a legislação da sua cidade para obter os tipos de tributação disponíveis.
itensContrato[].itemCabecalho.quantnúmeroQuantidade de serviços. Caso tenha informado a tag "codServico" o preenchimento passa a ser opcional e irá assumir o valor padrão 1.
itensContrato[].itemCabecalho.seqnúmero inteiroSequência do Item do Contrato.
itensContrato[].itemCabecalho.valorAcrescimonúmeroValor de Acréscimos e taxas. (Disponível apenas para cidades que oferecem esse recurso.)
itensContrato[].itemCabecalho.valorDednúmeroValor de Deduções. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração.
itensContrato[].itemCabecalho.valorDescontonúmeroValor do Desconto.
itensContrato[].itemCabecalho.valorOutrasRetencoesnúmeroValor de Outras Retenções. (Disponível apenas para cidades que oferecem esse recurso.)
itensContrato[].itemCabecalho.valorTotalnúmeroValor total do item. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração.
itensContrato[].itemCabecalho.valorUnitnúmeroValor Unitário do serviço. Caso tenha informado a tag "codServico" o preenchimento passa a ser opcional e irá assumir o valor informado no cadastro do respectivo serviço.
itensContrato[].itemDescrServobjeto
itensContrato[].itemDescrServ.descrCompletatextoInforme a descrição completa do serviço prestado
itensContrato[].itemImpostosobjeto
itensContrato[].itemImpostos.aliqCOFINSnúmeroIndica se o imposto foi alterado pelo usuário ou informado via importação de planilha ou API. Esse campo é preenchido automaticamente pelo Omie e não deve ser informado na inclusão/alteração.
itensContrato[].itemImpostos.aliqCSLLobrigatórionúmeroAlíquota de CSLL. Para o cálculo do imposto o preenchimento é obrigatório caso a tag [cUtilizaValorImposto] seja diferente de "S". Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
itensContrato[].itemImpostos.aliqCbsnúmeroAlíquota da CBS Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.aliqINSSobrigatórionúmeroAlíquota de INSS. Para o cálculo do imposto o preenchimento é obrigatório caso a tag [cUtilizaValorImposto] seja diferente de "S". Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
itensContrato[].itemImpostos.aliqIRobrigatórionúmeroAlíquota de IR. Para o cálculo do imposto o preenchimento é obrigatório caso a tag [cUtilizaValorImposto] seja diferente de "S". Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
itensContrato[].itemImpostos.aliqISSnúmeroAlíquota de ISS.
itensContrato[].itemImpostos.aliqIbsMunnúmeroAlíquota do Alíquota do IBS Municipal. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.aliqIbsUfnúmeroAlíquota do IBS Estadual. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.aliqPISobrigatórionúmeroAlíquota de PIS. Para o cálculo do imposto o preenchimento é obrigatório caso a tag [cUtilizaValorImposto] seja diferente de "S". Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
itensContrato[].itemImpostos.cUtilizaValorImpostotexto · até 1Indica se o valor informado para os Impostos Federais deverá ser mantido ao invés de ser recalculado a partir da alíquota. Assim: Caso seja informado "N", indica que valor do imposto deve ser calculado a partir da alíquota e base de cálculo. Caso seja informado "S", indica que o valor do imposto será mantido e a alíquota será recalculada a partir do valor do imposto e base de cálculo.
itensContrato[].itemImpostos.classTribtexto · até 6Código de Classificação Tributária. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.cstIbsCbstexto · até 3Código da Situação Tributária IBS/CBS. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.indOpertexto · até 6Código Indicador de Operação. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.lDeduzISSsim/nãoDeduz o ISS da Base de Cálculo de PIS e COFINS
itensContrato[].itemImpostos.manCbstexto · até 1Indica que houve alteração manual da alíquota de CBS. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
itensContrato[].itemImpostos.manIbsMuntexto · até 1Indica que houve alteração manual da alíquota de IBS Municipal. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
itensContrato[].itemImpostos.manIbsUftexto · até 1Indica que houve alteração manual da alíquota de IBS Estadual. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
itensContrato[].itemImpostos.percReducaoCbsnúmeroPercentual redução CBS. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.percReducaoIbsMunnúmeroPercentual redução IBS estadual. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.percReducaoIbsUfnúmeroPercentual redução IBS municipal. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.redBaseCOFINSnúmeroPercentual de Redução da Base de Cálculo do COFINS.
itensContrato[].itemImpostos.redBaseINSSnúmeroPercentual de Redução da Base de Cálculo do INSS.
itensContrato[].itemImpostos.redBasePISnúmeroPercentual de Redução da Base de Cálculo do PIS.
itensContrato[].itemImpostos.retCOFINStexto · até 1Retém COFINS (S/N). Indica se o imposto deve ser retido ou não.
itensContrato[].itemImpostos.retCSLLtexto · até 1Retém CSLL (S/N). Indica se o imposto deve ser retido ou não.
itensContrato[].itemImpostos.retINSStexto · até 1Retém INSS (S/N). Indica se o imposto deve ser retido ou não.
itensContrato[].itemImpostos.retIRtexto · até 1Retém IR (S/N). Indica se o imposto deve ser retido ou não.
itensContrato[].itemImpostos.retISStexto · até 1Retém ISS (S/N). Indica se o imposto deve ser retido ou não.
itensContrato[].itemImpostos.retPIStexto · até 1Retém PIS (S/N). Indica se o imposto deve ser retido ou não.
itensContrato[].itemImpostos.valorCOFINSobrigatórionúmeroAlíquota de COFINS. Para o cálculo do imposto o preenchimento é obrigatório caso a tag [cUtilizaValorImposto] seja diferente de "S". Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
itensContrato[].itemImpostos.valorCSLLnúmeroValor de CSLL. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração caso a tag [cUtilizarValorImposto] seja diferente de "S". Caso a tag [cUtilizarValorImposto] seja preenchida com "S", indicará que o valor informado deve ser preservado e que a respectiva alíquota deve ser calculada ao invés do valor do imposto. Nesse caso, o alíquota informada na tag correspondente será desprezada.
itensContrato[].itemImpostos.valorCbsnúmeroValor da CBS. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
itensContrato[].itemImpostos.valorINSSnúmeroValor de INSS. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração caso a tag [cUtilizarValorImposto] seja diferente de "S". Caso a tag [cUtilizarValorImposto] seja preenchida com "S", indicará que o valor informado deve ser preservado e que a respectiva alíquota deve ser calculada ao invés do valor do imposto. Nesse caso, o alíquota informada na tag correspondente será desprezada.
itensContrato[].itemImpostos.valorIRnúmeroValor do IR. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração caso a tag [cUtilizarValorImposto] seja diferente de "S". Caso a tag [cUtilizarValorImposto] seja preenchida com "S", indicará que o valor informado deve ser preservado e que a respectiva alíquota deve ser calculada ao invés do valor do imposto. Nesse caso, o alíquota informada na tag correspondente será desprezada.
itensContrato[].itemImpostos.valorISSnúmeroValor do ISS. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração.
itensContrato[].itemImpostos.valorIbsMunnúmeroValor do IBS Municipal. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
itensContrato[].itemImpostos.valorIbsUfnúmeroValor do IBS Estadual. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
itensContrato[].itemImpostos.valorPISnúmeroValor do PIS. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração caso a tag [cUtilizarValorImposto] seja diferente de "S". Caso a tag [cUtilizarValorImposto] seja preenchida com "S", indicará que o valor informado deve ser preservado e que a respectiva alíquota deve ser calculada ao invés do valor do imposto. Nesse caso, o alíquota informada na tag correspondente será desprezada.
itensContrato[].itemLeiTranspImpobjeto
itensContrato[].itemLeiTranspImp.aliMunicipalnúmeroAlíquota Carga Trib. Aprox. Municipal
itensContrato[].itemLeiTranspImp.aliqEstadualnúmeroAlíquota Carga Trib. Aprox. Estadual
itensContrato[].itemLeiTranspImp.aliqFederalnúmeroAlíquota da Carga Tributária Aprox. Federal
itensContrato[].itemLeiTranspImp.chavetexto · até 6Chave do IBPT
itensContrato[].itemLeiTranspImp.fontetexto · até 34Fonte do IBPT
itensContrato[].itemOutrasInfobjetoOutras informações do item do contrato de serviços
itensContrato[].itemOutrasInf.dItVigFinaltexto · até 10Data da vigência final do item do contrato de serviços
itensContrato[].itemOutrasInf.dItVigInicialtexto · até 10Data da vigência inicial do item do contrato de serviços
itensContrato[].itemOutrasInf.nTipoItVigFinalnúmero inteiroTipo da vigência final do item do contrato de serviços. Valores possiveis: 1 - Data especifica 2 - Segue a vigência final do contrato 3 - Apenas para o proximo faturamento
itensContrato[].itemViaUnicaobjetoInformações referente ao serviço da NF modelo 21 ou 22.
itensContrato[].itemViaUnica.cCFOPtexto · até 10Código CFOP para NF Via Única (Modelos 21 e 22). Obrigatório quando a tag cEnvViaUnica for igual a "S". Utilize a tag "nCodigo" do método "ListarCFOP" da API /api/v1/produtos/cfop/ para obter essa informação.
itensContrato[].itemViaUnica.cClassifServicotexto · até 4Código da Classificação para NF Via Única (Modelos 21 e 22). Obrigatório quando a tag cEnvViaUnica for igual a "S". Utilize a tag "cCodigo" do método "ListarClassificacaoServico" da API /api/v1/servicos/classificacaoservico/ para obter essa informação.
itensContrato[].itemViaUnica.cModeloNFtexto · até 2Indica qual modelo de NF será emitida para o serviço. Obrigatório quando a tag cEnvViaUnica for igual a "S". Pode ser: 21 - Nota Fiscal de Serviço de Comunicação 22 - Nota Fiscal de Serviço de Telecomunicação
itensContrato[].itemViaUnica.cTipoReceitatexto · até 1Indicador do Tipo de Receita para NF Via Única (Modelos 21 e 22). Obrigatório quando a tag cEnvViaUnica for igual a "S". Pode ser: 0 - Receita própria - serviços prestados 1 - Receita própria - cobrança de débitos 2 - Receita própria - venda de mercadorias 3 - Receita própria - venda de serviço pré-pago 4 - Outras receitas próprias 5 - Receitas de terceiros (co-faturamento) 9 - Outras receitas de terceiros
itensContrato[].itemViaUnica.cTipoUtilizacaotexto · até 1Código do tipo de utilização para NF Via Única (Modelos 21 e 22). Obrigatório quando a tag cEnvViaUnica for igual a "S". Utilize a tag "cCodigo" do método "ListarTipoUtilizacao" da API /api/v1/servicos/tipoutilizacao/ para obter essa informação.
observacoesobjetoObservações do contrato
observacoes.cObsContratotextoObservações do Contrato. Essas informação não serão exibidas na Nota Fiscal).
produtosUtilizadosobjetoProdutos Utilizados no contrato.
produtosUtilizados.cAcaoProdUtilizadostexto · até 3Pode ser: REM - Será gerado uma remessa dos produtos para o cliente. EST - Será gerado uma saída de estoque. PED - Será gerado um pedido de venda. Obrigatório na inclusão.
produtosUtilizados.cCodCategRemtexto · até 20Código da Categoria da Remessa ou Pedido de Venda. Obrigatório quando usar [cAcaoFaturamento] como 'REM' ou 'PED'.
produtosUtilizados.produtoUtilizadolista de objetosProdutos utilizados no serviço.
produtosUtilizados.produtoUtilizado[].cAcaoItemPUtexto · até 1Pode ser: "A" - Alterar o item. "E" - Excluir o item. "I" - Incluir o item na alteração.
produtosUtilizados.produtoUtilizado[].codigo_local_estoquenúmero inteiroCódigo do Local do Estoque.
produtosUtilizados.produtoUtilizado[].lote_validadelista de objetosInformações referentes ao lote e validade do produto. A tag só deve ser informada se o produto possuir controle de lote e se a intenção é informar os lotes "manualmente" por API.
produtosUtilizados.produtoUtilizado[].lote_validade[].nIdLotenúmero inteiroId do lote do produto. Obrigatório quando o produto possui controle de lote e o método do consumo do lote está definido como 'Manual' nas configurações..
produtosUtilizados.produtoUtilizado[].lote_validade[].nQtdLoteobrigatórionúmeroInforme aqui a quantidade do lote para o produto. É obrigatório quando o produto possui controle de lote e o método do consumo do lote está definido como 'Manual' nas configurações.
produtosUtilizados.produtoUtilizado[].nCodProdutoPUnúmero inteiroCódigo interno do produto. (utilizado apenas na API). Esse código não aparece na tela do Omie.
produtosUtilizados.produtoUtilizado[].nIdItemPUnúmero inteiro(Código interno utilizado apenas na API). Não informar na inclusão. Esse código não aparece na tela do Omie.
produtosUtilizados.produtoUtilizado[].nQtdePUnúmeroQuantidade.
vencTextosobjeto
vencTextos.cAdContratotexto · até 1Adicionar o "Nº do Contrato" à descrição dos serviços na NFS-e
vencTextos.cAdPeriodotexto · até 1Adicionar o período de referência associado ao faturamento
vencTextos.cAdVenctexto · até 1Adicionar o vencimento da parcela à descrição dos serviços na NFS-e
vencTextos.cAntecipartexto · até 1Define se deve antecipar o vencimento ao considerar apenas dias úteis
vencTextos.cCodPerReftexto · até 3Período de Referência - Código do período de referência para o faturamento. Pode ser: 001 Mês do faturamento 002 Mês Anterior ao faturamento 003 Mês Posterior ao faturamento 004 Período Anterior ao faturamento 005 Período Posterior ao faturamento 006 Período Anterior específico 007 Número da Parcela 008 Período Posterior específico 009 Período Atual específico
vencTextos.cDiaFimtexto · até 2Dia Final - Dia para a data final do período de referência associado ao faturamento
vencTextos.cDiaInitexto · até 2Dia Inicial - Dia para a data inicial do período de referência associado ao faturamentDia Inicial
vencTextos.cPostergartexto · até 1Postergar Sábados, Domingos e Feriados Nacionais
vencTextos.cProxMestexto · até 1Define se o vencimento ocorrerá somente no mês seguinte.
vencTextos.cTpVenctexto · até 3Tipo de Vencimento. Pode ser: 001-Número de dias após faturar. 002-Fixar dia do mês (1 a 31).
vencTextos.nDiaFixonúmero inteiroDia de vencimento fixo para a gerar o contas a receber
vencTextos.nDiasnúmero inteiroNúmero de Dias para a gerar o contas a receber
Retorno 4O que volta numa chamada bem-sucedida
CampoTipoDescrição
cCodIntCtrtextoCódigo de Integração do Contrato de Serviço
cCodStatustextoCódigo do Status
cDescStatustextoDescrição do Status
nCodCtrnúmero inteiroCódigo da Contrato de Serviço
POST /api/v1/servicos/contrato/
curl -s https://app.omie.com.br/api/v1/servicos/contrato/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "AlterarContrato", "param": [{"cabecalho": {"cCodIntCtr": "019289Tb2", "cCodSit": "10", "cNumCtr": "2020/01001", "cTipoFat": "01", "dVigFinal": "30/03/2022", "dVigInicial": "29/03/2020", "nCodCli": 2370765, "nDiaFat": 30, "nValTotMes": 3302}, "departamentos": [], "emailCliente": {"cEnviarBoleto": "", "cEnviarLinkNfse": "", "cEnviarRecibo": "", "cUtilizarEmails": ""}, "infAdic": {"cCidPrestServ": "PETROPOLIS (RJ)", "cCodART": "", "cCodCateg": "1.01.02", "cCodObra": "", "cContato": "", "cDadosAdicNF": "", "nCodCC": 1208238, "nCodProj": 0, "nCodVend": 0}, "itensContrato": [{"itemCabecalho": {"codIntItem": "1", "cCodCategItem": "", "cNaoGerarFinanceiro": "N", "codLC116": "3.05", "codNBS": "", "codServMunic": "01292", "codServico": 0, "natOperacao": "01", "quant": 1, "seq": 1, "valorDed": 0, "valorTotal": 3002, "valorUnit": 3002}, "itemDescrServ": {"descrCompleta": "Serviços prestados"}, "itemImpostos": {"aliqCOFINS": 0, "aliqCSLL": 0, "aliqINSS": 0, "aliqIR": 0, "aliqISS": 5, "aliqPIS": 0, "redBaseINSS": 0, "retCOFINS": "", "retCSLL": "", "retINSS": "", "retIR": "", "retISS": "N", "retPIS": "", "valorCOFINS": 0, "valorCSLL": 0, "valorINSS": 0, "valorIR": 0, "valorISS": 150.1, "valorPIS": 0}, "itemLeiTranspImp": {"aliMunicipal": 0, "aliqEstadual": 0, "aliqFederal": 0, "chave": "", "fonte": ""}}, {"itemCabecalho": {"codIntItem": "2", "cCodCategItem": "", "cNaoGerarFinanceiro": "N", "codLC116": "17.01", "codNBS": "", "codServMunic": "0162-8/99", "codServico": 3412648, "natOperacao": "01", "quant": 1, "seq": 2, "valorDed": 0, "valorTotal": 300, "valorUnit": 300}, "itemDescrServ": {"descrCompleta": "Homologação de processo contábil"}, "itemImpostos": {"aliqCOFINS": 0, "aliqCSLL": 0, "aliqINSS": 0, "aliqIR": 0, "aliqISS": 3, "aliqPIS": 0, "redBaseINSS": 0, "retCOFINS": "", "retCSLL": "", "retINSS": "", "retIR": "", "retISS": "N", "retPIS": "", "valorCOFINS": 0, "valorCSLL": 0, "valorINSS": 0, "valorIR": 0, "valorISS": 9, "valorPIS": 0}, "itemLeiTranspImp": {"aliMunicipal": 0, "aliqEstadual": 0, "aliqFederal": 0, "chave": "", "fonte": ""}}], "observacoes": {"cObsContrato": ""}, "vencTextos": {"cAdContrato": "N", "cAdPeriodo": "N", "cAdVenc": " ", "cAntecipar": "", "cCodPerRef": "001", "cDiaFim": 0, "cDiaIni": 0, "cPostergar": "", "cProxMes": "", "cTpVenc": "001", "nDiaFixo": 0, "nDias": 5}}]}'

ConsultarContrato

consultaClaudeMCP

Consulta o Contrato de Serviço

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 1Campos e estruturas que você pode enviar
CampoTipoDescrição
contratoChaveobjetoChave de Pesquisa do Contrato de Serviço.
contratoChave.cCodIntCtrtexto · até 20Código de Integração do contrato de serviços. (Utilizado em contratos de serviços criados a partir de API, não é visualizado na tela)
contratoChave.nCodCtrnúmero inteiroCódigo do contrato de serviços. (Gerado internamente, não é visualizado na tela)
Retorno 1O que volta numa chamada bem-sucedida
CampoTipoDescrição
contratoCadastroobjetoCadastro de Contrato de Serviço
contratoCadastro.cabecalhoobjeto
contratoCadastro.cabecalho.cCodIntCtrtextoCódigo de integração do contrato de serviços. (Utilizado em contratos criados via API, não é visualizado na tela)
contratoCadastro.cabecalho.cCodSittextoCódigo da situação do contrato de serviços. Pode ser: 00 - Em Elaboração 10 - Ativo 90 - Suspenso 99 - Cancelado
contratoCadastro.cabecalho.cNumCtrtextoNúmero do contrato de serviços. (Informado pelo usuário / visualizado na tela)
contratoCadastro.cabecalho.cTipoFattextoTipo de Faturamento do Contrato. Pode ser: 01 - Todo Mês (mensal) 02 - A cada 2 meses (bimestral) 03 - A cada 3 meses (trimestral) 06 - A cada 6 meses (semestral) 12 - A cada 12 meses (anual)
contratoCadastro.cabecalho.dVigFinaltextoData de vigência final do contrato de serviços.
contratoCadastro.cabecalho.dVigInicialtextoData da vigência inicial do contrato de serviços.
contratoCadastro.cabecalho.nCodClinúmero inteiroCódigo do cliente a que se refere o contrato de serviços. (Gerado internamente, não é visualizado na tela)
contratoCadastro.cabecalho.nCodCtrnúmero inteiroCódigo do contrato de serviços. (Gerado internamente, não é visualizado na tela)
contratoCadastro.cabecalho.nDiaFatnúmero inteiroDia de faturamento.
contratoCadastro.cabecalho.nValTotMesdecimalValor total mensal do contrato de serviços. (Calculado automaticamente)
contratoCadastro.departamentoslista de objetosDistribuição por departamento
contratoCadastro.departamentos[].cCodDeptextoCódigo do Departamento
contratoCadastro.departamentos[].cDesDeptextoDescrição do Departamento
contratoCadastro.departamentos[].nPerDepdecimalPercentual do rateio
contratoCadastro.departamentos[].nValDepdecimalValor do rateio
contratoCadastro.despesasReembolsaveisobjetoDespesas reembolsáveis
contratoCadastro.despesasReembolsaveis.cCodCategReembtextoCódigo da categoria para reembolso
contratoCadastro.despesasReembolsaveis.despesaReembolsavellista de objetosDespesa reembolsável
contratoCadastro.despesasReembolsaveis.despesaReembolsavel[].cAcaoReembtextoAção para o reembolso, pode ser: I - Inclusão A - Alteração E - Exclusão
contratoCadastro.despesasReembolsaveis.despesaReembolsavel[].cDescReembtextoDescrição do reembolso
contratoCadastro.despesasReembolsaveis.despesaReembolsavel[].cRecorrenteReembtextoIndica se o reembolso é recorrente. [S/N]
contratoCadastro.despesasReembolsaveis.despesaReembolsavel[].dDataReembtextoData do reembolso
contratoCadastro.despesasReembolsaveis.despesaReembolsavel[].nCodReembnúmero inteiroID do Reembolso
contratoCadastro.despesasReembolsaveis.despesaReembolsavel[].nValorReembdecimalValor do Reembolso
contratoCadastro.emailClienteobjetoDados do envio de e-mail do cliente
contratoCadastro.emailCliente.cEnvViaUnicatextoEnviar ao cliente Via Única (Nota Fiscais Modelos 21 e 22). Pode ser: S - Sim N - Não
contratoCadastro.emailCliente.cEnviarBoletotextoEnviar também o(s) boleto(s) de cobrança
contratoCadastro.emailCliente.cEnviarLinkNfsetextoEnviar o link da NFS-e gerada na Prefeitura
contratoCadastro.emailCliente.cEnviarPixtextoEnviar também o(s) PIX(s) de cobrança
contratoCadastro.emailCliente.cEnviarRecibotextoEnviar um recibo de prestação de serviço (ao invés de NFS-e)
contratoCadastro.emailCliente.cUtilizarEmailstextoUtilizar os seguintes endereços de e-mail
contratoCadastro.infAdicobjeto
contratoCadastro.infAdic.cCidPrestServtextoCidade da Prestação do Serviço e Estado
contratoCadastro.infAdic.cCodARTtextoCódigo ART
contratoCadastro.infAdic.cCodCategtextoCódigo da Categoria
contratoCadastro.infAdic.cCodObratextoCódigo da Obra
contratoCadastro.infAdic.cContatotextoNome do Contato
contratoCadastro.infAdic.cDadosAdicNFtextoDados Adicionais para a Nota Fiscal
contratoCadastro.infAdic.cNumEncaptextoCódigo de Encapsulamento de notas dedutoras
contratoCadastro.infAdic.cUsoConsumotextoUso e consumo pessoal. (0=Não, 1=Sim).
contratoCadastro.infAdic.nCodCCnúmero inteiroCódigo da Conta Corrente
contratoCadastro.infAdic.nCodProjnúmero inteiroCódigo do Projeto
contratoCadastro.infAdic.nCodVendnúmero inteiroCódigo do Vendedor
contratoCadastro.infAdic.nIdDestinatarionúmero inteiroID Cliente para o Destinatário.
contratoCadastro.infoCadastroobjetoInformações complementares do contrato.
contratoCadastro.infoCadastro.cImpAPItextoImportado pela API (S/N). Não deve ser informado na Inclusão/Alteração.
contratoCadastro.infoCadastro.cOrigemtextoOrigem do Contrato de Serviço. Informado na Inclusão.
contratoCadastro.infoCadastro.dAlttextoData da Alteração. No formato dd/mm/aaaa. Não deve ser informado na Inclusão/Alteração.
contratoCadastro.infoCadastro.dInctextoData da Inclusão. No formato dd/mm/aaaa. Não deve ser informado na Inclusão/Alteração.
contratoCadastro.infoCadastro.hAlttextoHora da Alteração. No formato hh:mm:ss. Não deve ser informado na Inclusão/Alteração.
contratoCadastro.infoCadastro.hInctextoHora da Inclusão. No formato hh:mm:ss. Não deve ser informado na Inclusão/Alteração.
contratoCadastro.infoCadastro.uAlttextoUsuário da Alteração. Não deve ser informado na Inclusão/Alteração.
contratoCadastro.infoCadastro.uInctextoUsuário da Inclusão. Não deve ser informado na Inclusão/Alteração.
contratoCadastro.itensContratolista de objetos
contratoCadastro.itensContrato[].itemCabecalhoobjeto
contratoCadastro.itensContrato[].itemCabecalho.aliqDescontodecimalAliquota do Desconto.
contratoCadastro.itensContrato[].itemCabecalho.cCodCategItemtextoCódigo da Categoria.
contratoCadastro.itensContrato[].itemCabecalho.cNaoGerarFinanceirotextoNão gerar conta a receber para este item. Informar "S" para não gerar movimento financeiro. Informar "N" para gerar movimento financeiro.
contratoCadastro.itensContrato[].itemCabecalho.cTpDescontotextoTipo de Desconto. Pode ser: P - Percentual V - Valor
contratoCadastro.itensContrato[].itemCabecalho.codIntItemtextoCódigo de integração do item do contrato.
contratoCadastro.itensContrato[].itemCabecalho.codItemnúmero inteiroIdentificação do Item do Contrato. (Gerado automaticamente na Inclusão do item do contrato)
contratoCadastro.itensContrato[].itemCabecalho.codLC116textoCódigo do Serviço conforme Lei Complementar (LC 116). Caso tenha informado a tag "codServico" o preenchimento passa a ser opcional e irá assumir o valor informado no cadastro do respectivo serviço. Tabela única para todos os municípios.
contratoCadastro.itensContrato[].itemCabecalho.codNBStextoCódigo da Nomenclatura Brasileira de Serviços (NBS). Caso tenha informado a tag "codServico" irá assumir o valor informado no cadastro do respectivo serviço.
contratoCadastro.itensContrato[].itemCabecalho.codServMunictextoCódigo do Serviço Municipal ou CNAE. Caso tenha informado a tag "codServico" o preenchimento passa a ser opcional e irá assumir o valor informado no cadastro do respectivo serviço. Valores pode variar de acordo com o município. Verifique a legislação da sua cidade para obter os códigos de serviço disponíveis.
contratoCadastro.itensContrato[].itemCabecalho.codServiconúmero inteiroCódigo Interno do Serviço conforme cadastrado na tabela de serviços. Caso preenchido, irá assumir as informações do cadastro de serviço. Se não for preenchido, assumirá os valores informados na API.
contratoCadastro.itensContrato[].itemCabecalho.natOperacaotextoNatureza da Operação ou Tipo de Tributação dos Serviços. Caso tenha informado a tag "codServico" o preenchimento passa a ser opcional e irá assumir o valor informado no cadastro do respectivo serviço. Valores pode variar de acordo com o município. Verifique a legislação da sua cidade para obter os tipos de tributação disponíveis.
contratoCadastro.itensContrato[].itemCabecalho.quantdecimalQuantidade de serviços. Caso tenha informado a tag "codServico" o preenchimento passa a ser opcional e irá assumir o valor padrão 1.
contratoCadastro.itensContrato[].itemCabecalho.seqnúmero inteiroSequência do Item do Contrato.
contratoCadastro.itensContrato[].itemCabecalho.valorAcrescimodecimalValor de Acréscimos e taxas. (Disponível apenas para cidades que oferecem esse recurso.)
contratoCadastro.itensContrato[].itemCabecalho.valorDeddecimalValor de Deduções. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração.
contratoCadastro.itensContrato[].itemCabecalho.valorDescontodecimalValor do Desconto.
contratoCadastro.itensContrato[].itemCabecalho.valorOutrasRetencoesdecimalValor de Outras Retenções. (Disponível apenas para cidades que oferecem esse recurso.)
contratoCadastro.itensContrato[].itemCabecalho.valorTotaldecimalValor total do item. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração.
contratoCadastro.itensContrato[].itemCabecalho.valorUnitdecimalValor Unitário do serviço. Caso tenha informado a tag "codServico" o preenchimento passa a ser opcional e irá assumir o valor informado no cadastro do respectivo serviço.
contratoCadastro.itensContrato[].itemDescrServobjeto
contratoCadastro.itensContrato[].itemDescrServ.descrCompletatextoInforme a descrição completa do serviço prestado
contratoCadastro.itensContrato[].itemImpostosobjeto
contratoCadastro.itensContrato[].itemImpostos.aliqCOFINSdecimalIndica se o imposto foi alterado pelo usuário ou informado via importação de planilha ou API. Esse campo é preenchido automaticamente pelo Omie e não deve ser informado na inclusão/alteração.
contratoCadastro.itensContrato[].itemImpostos.aliqCSLLdecimalAlíquota de CSLL. Para o cálculo do imposto o preenchimento é obrigatório caso a tag [cUtilizaValorImposto] seja diferente de "S". Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
contratoCadastro.itensContrato[].itemImpostos.aliqCbsdecimalAlíquota da CBS Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
contratoCadastro.itensContrato[].itemImpostos.aliqINSSdecimalAlíquota de INSS. Para o cálculo do imposto o preenchimento é obrigatório caso a tag [cUtilizaValorImposto] seja diferente de "S". Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
contratoCadastro.itensContrato[].itemImpostos.aliqIRdecimalAlíquota de IR. Para o cálculo do imposto o preenchimento é obrigatório caso a tag [cUtilizaValorImposto] seja diferente de "S". Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
contratoCadastro.itensContrato[].itemImpostos.aliqISSdecimalAlíquota de ISS.
contratoCadastro.itensContrato[].itemImpostos.aliqIbsMundecimalAlíquota do Alíquota do IBS Municipal. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
contratoCadastro.itensContrato[].itemImpostos.aliqIbsUfdecimalAlíquota do IBS Estadual. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
contratoCadastro.itensContrato[].itemImpostos.aliqPISdecimalAlíquota de PIS. Para o cálculo do imposto o preenchimento é obrigatório caso a tag [cUtilizaValorImposto] seja diferente de "S". Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
contratoCadastro.itensContrato[].itemImpostos.cUtilizaValorImpostotextoIndica se o valor informado para os Impostos Federais deverá ser mantido ao invés de ser recalculado a partir da alíquota. Assim: Caso seja informado "N", indica que valor do imposto deve ser calculado a partir da alíquota e base de cálculo. Caso seja informado "S", indica que o valor do imposto será mantido e a alíquota será recalculada a partir do valor do imposto e base de cálculo.
contratoCadastro.itensContrato[].itemImpostos.classTribtextoCódigo de Classificação Tributária. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
contratoCadastro.itensContrato[].itemImpostos.cstIbsCbstextoCódigo da Situação Tributária IBS/CBS. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
contratoCadastro.itensContrato[].itemImpostos.indOpertextoCódigo Indicador de Operação. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
contratoCadastro.itensContrato[].itemImpostos.lDeduzISSsim/nãoDeduz o ISS da Base de Cálculo de PIS e COFINS
contratoCadastro.itensContrato[].itemImpostos.manCbstextoIndica que houve alteração manual da alíquota de CBS. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
contratoCadastro.itensContrato[].itemImpostos.manIbsMuntextoIndica que houve alteração manual da alíquota de IBS Municipal. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
contratoCadastro.itensContrato[].itemImpostos.manIbsUftextoIndica que houve alteração manual da alíquota de IBS Estadual. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
contratoCadastro.itensContrato[].itemImpostos.percReducaoCbsdecimalPercentual redução CBS. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
contratoCadastro.itensContrato[].itemImpostos.percReducaoIbsMundecimalPercentual redução IBS estadual. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
contratoCadastro.itensContrato[].itemImpostos.percReducaoIbsUfdecimalPercentual redução IBS municipal. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
contratoCadastro.itensContrato[].itemImpostos.redBaseCOFINSdecimalPercentual de Redução da Base de Cálculo do COFINS.
contratoCadastro.itensContrato[].itemImpostos.redBaseINSSdecimalPercentual de Redução da Base de Cálculo do INSS.
contratoCadastro.itensContrato[].itemImpostos.redBasePISdecimalPercentual de Redução da Base de Cálculo do PIS.
contratoCadastro.itensContrato[].itemImpostos.retCOFINStextoRetém COFINS (S/N). Indica se o imposto deve ser retido ou não.
contratoCadastro.itensContrato[].itemImpostos.retCSLLtextoRetém CSLL (S/N). Indica se o imposto deve ser retido ou não.
contratoCadastro.itensContrato[].itemImpostos.retINSStextoRetém INSS (S/N). Indica se o imposto deve ser retido ou não.
contratoCadastro.itensContrato[].itemImpostos.retIRtextoRetém IR (S/N). Indica se o imposto deve ser retido ou não.
contratoCadastro.itensContrato[].itemImpostos.retISStextoRetém ISS (S/N). Indica se o imposto deve ser retido ou não.
contratoCadastro.itensContrato[].itemImpostos.retPIStextoRetém PIS (S/N). Indica se o imposto deve ser retido ou não.
contratoCadastro.itensContrato[].itemImpostos.valorCOFINSdecimalAlíquota de COFINS. Para o cálculo do imposto o preenchimento é obrigatório caso a tag [cUtilizaValorImposto] seja diferente de "S". Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
contratoCadastro.itensContrato[].itemImpostos.valorCSLLdecimalValor de CSLL. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração caso a tag [cUtilizarValorImposto] seja diferente de "S". Caso a tag [cUtilizarValorImposto] seja preenchida com "S", indicará que o valor informado deve ser preservado e que a respectiva alíquota deve ser calculada ao invés do valor do imposto. Nesse caso, o alíquota informada na tag correspondente será desprezada.
contratoCadastro.itensContrato[].itemImpostos.valorCbsdecimalValor da CBS. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
contratoCadastro.itensContrato[].itemImpostos.valorINSSdecimalValor de INSS. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração caso a tag [cUtilizarValorImposto] seja diferente de "S". Caso a tag [cUtilizarValorImposto] seja preenchida com "S", indicará que o valor informado deve ser preservado e que a respectiva alíquota deve ser calculada ao invés do valor do imposto. Nesse caso, o alíquota informada na tag correspondente será desprezada.
contratoCadastro.itensContrato[].itemImpostos.valorIRdecimalValor do IR. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração caso a tag [cUtilizarValorImposto] seja diferente de "S". Caso a tag [cUtilizarValorImposto] seja preenchida com "S", indicará que o valor informado deve ser preservado e que a respectiva alíquota deve ser calculada ao invés do valor do imposto. Nesse caso, o alíquota informada na tag correspondente será desprezada.
contratoCadastro.itensContrato[].itemImpostos.valorISSdecimalValor do ISS. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração.
contratoCadastro.itensContrato[].itemImpostos.valorIbsMundecimalValor do IBS Municipal. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
contratoCadastro.itensContrato[].itemImpostos.valorIbsUfdecimalValor do IBS Estadual. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
contratoCadastro.itensContrato[].itemImpostos.valorPISdecimalValor do PIS. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração caso a tag [cUtilizarValorImposto] seja diferente de "S". Caso a tag [cUtilizarValorImposto] seja preenchida com "S", indicará que o valor informado deve ser preservado e que a respectiva alíquota deve ser calculada ao invés do valor do imposto. Nesse caso, o alíquota informada na tag correspondente será desprezada.
contratoCadastro.itensContrato[].itemLeiTranspImpobjeto
contratoCadastro.itensContrato[].itemLeiTranspImp.aliMunicipaldecimalAlíquota Carga Trib. Aprox. Municipal
contratoCadastro.itensContrato[].itemLeiTranspImp.aliqEstadualdecimalAlíquota Carga Trib. Aprox. Estadual
contratoCadastro.itensContrato[].itemLeiTranspImp.aliqFederaldecimalAlíquota da Carga Tributária Aprox. Federal
contratoCadastro.itensContrato[].itemLeiTranspImp.chavetextoChave do IBPT
contratoCadastro.itensContrato[].itemLeiTranspImp.fontetextoFonte do IBPT
contratoCadastro.itensContrato[].itemOutrasInfobjetoOutras informações do item do contrato de serviços
contratoCadastro.itensContrato[].itemOutrasInf.dItVigFinaltextoData da vigência final do item do contrato de serviços
contratoCadastro.itensContrato[].itemOutrasInf.dItVigInicialtextoData da vigência inicial do item do contrato de serviços
contratoCadastro.itensContrato[].itemOutrasInf.nTipoItVigFinalnúmero inteiroTipo da vigência final do item do contrato de serviços. Valores possiveis: 1 - Data especifica 2 - Segue a vigência final do contrato 3 - Apenas para o proximo faturamento
contratoCadastro.itensContrato[].itemViaUnicaobjetoInformações referente ao serviço da NF modelo 21 ou 22.
contratoCadastro.itensContrato[].itemViaUnica.cCFOPtextoCódigo CFOP para NF Via Única (Modelos 21 e 22). Obrigatório quando a tag cEnvViaUnica for igual a "S". Utilize a tag "nCodigo" do método "ListarCFOP" da API /api/v1/produtos/cfop/ para obter essa informação.
contratoCadastro.itensContrato[].itemViaUnica.cClassifServicotextoCódigo da Classificação para NF Via Única (Modelos 21 e 22). Obrigatório quando a tag cEnvViaUnica for igual a "S". Utilize a tag "cCodigo" do método "ListarClassificacaoServico" da API /api/v1/servicos/classificacaoservico/ para obter essa informação.
contratoCadastro.itensContrato[].itemViaUnica.cModeloNFtextoIndica qual modelo de NF será emitida para o serviço. Obrigatório quando a tag cEnvViaUnica for igual a "S". Pode ser: 21 - Nota Fiscal de Serviço de Comunicação 22 - Nota Fiscal de Serviço de Telecomunicação
contratoCadastro.itensContrato[].itemViaUnica.cTipoReceitatextoIndicador do Tipo de Receita para NF Via Única (Modelos 21 e 22). Obrigatório quando a tag cEnvViaUnica for igual a "S". Pode ser: 0 - Receita própria - serviços prestados 1 - Receita própria - cobrança de débitos 2 - Receita própria - venda de mercadorias 3 - Receita própria - venda de serviço pré-pago 4 - Outras receitas próprias 5 - Receitas de terceiros (co-faturamento) 9 - Outras receitas de terceiros
contratoCadastro.itensContrato[].itemViaUnica.cTipoUtilizacaotextoCódigo do tipo de utilização para NF Via Única (Modelos 21 e 22). Obrigatório quando a tag cEnvViaUnica for igual a "S". Utilize a tag "cCodigo" do método "ListarTipoUtilizacao" da API /api/v1/servicos/tipoutilizacao/ para obter essa informação.
contratoCadastro.observacoesobjetoObservações do contrato
contratoCadastro.observacoes.cObsContratotextoObservações do Contrato. Essas informação não serão exibidas na Nota Fiscal).
contratoCadastro.produtosUtilizadosobjetoProdutos Utilizados no contrato.
contratoCadastro.produtosUtilizados.cAcaoProdUtilizadostextoPode ser: REM - Será gerado uma remessa dos produtos para o cliente. EST - Será gerado uma saída de estoque. PED - Será gerado um pedido de venda. Obrigatório na inclusão.
contratoCadastro.produtosUtilizados.cCodCategRemtextoCódigo da Categoria da Remessa ou Pedido de Venda. Obrigatório quando usar [cAcaoFaturamento] como 'REM' ou 'PED'.
contratoCadastro.produtosUtilizados.produtoUtilizadolista de objetosProdutos utilizados no serviço.
contratoCadastro.produtosUtilizados.produtoUtilizado[].cAcaoItemPUtextoPode ser: "A" - Alterar o item. "E" - Excluir o item. "I" - Incluir o item na alteração.
contratoCadastro.produtosUtilizados.produtoUtilizado[].codigo_local_estoquenúmero inteiroCódigo do Local do Estoque.
contratoCadastro.produtosUtilizados.produtoUtilizado[].lote_validadelista de objetosInformações referentes ao lote e validade do produto. A tag só deve ser informada se o produto possuir controle de lote e se a intenção é informar os lotes "manualmente" por API.
contratoCadastro.produtosUtilizados.produtoUtilizado[].lote_validade[].nIdLotenúmero inteiroId do lote do produto. Obrigatório quando o produto possui controle de lote e o método do consumo do lote está definido como 'Manual' nas configurações..
contratoCadastro.produtosUtilizados.produtoUtilizado[].lote_validade[].nQtdLotedecimalInforme aqui a quantidade do lote para o produto. É obrigatório quando o produto possui controle de lote e o método do consumo do lote está definido como 'Manual' nas configurações.
contratoCadastro.produtosUtilizados.produtoUtilizado[].nCodProdutoPUnúmero inteiroCódigo interno do produto. (utilizado apenas na API). Esse código não aparece na tela do Omie.
contratoCadastro.produtosUtilizados.produtoUtilizado[].nIdItemPUnúmero inteiro(Código interno utilizado apenas na API). Não informar na inclusão. Esse código não aparece na tela do Omie.
contratoCadastro.produtosUtilizados.produtoUtilizado[].nQtdePUdecimalQuantidade.
contratoCadastro.vencTextosobjeto
contratoCadastro.vencTextos.cAdContratotextoAdicionar o "Nº do Contrato" à descrição dos serviços na NFS-e
contratoCadastro.vencTextos.cAdPeriodotextoAdicionar o período de referência associado ao faturamento
contratoCadastro.vencTextos.cAdVenctextoAdicionar o vencimento da parcela à descrição dos serviços na NFS-e
contratoCadastro.vencTextos.cAntecipartextoDefine se deve antecipar o vencimento ao considerar apenas dias úteis
contratoCadastro.vencTextos.cCodPerReftextoPeríodo de Referência - Código do período de referência para o faturamento. Pode ser: 001 Mês do faturamento 002 Mês Anterior ao faturamento 003 Mês Posterior ao faturamento 004 Período Anterior ao faturamento 005 Período Posterior ao faturamento 006 Período Anterior específico 007 Número da Parcela 008 Período Posterior específico 009 Período Atual específico
contratoCadastro.vencTextos.cDiaFimnúmero inteiroDia Final - Dia para a data final do período de referência associado ao faturamento
contratoCadastro.vencTextos.cDiaIninúmero inteiroDia Inicial - Dia para a data inicial do período de referência associado ao faturamentDia Inicial
contratoCadastro.vencTextos.cPostergartextoPostergar Sábados, Domingos e Feriados Nacionais
contratoCadastro.vencTextos.cProxMestextoDefine se o vencimento ocorrerá somente no mês seguinte.
contratoCadastro.vencTextos.cTpVenctextoTipo de Vencimento. Pode ser: 001-Número de dias após faturar. 002-Fixar dia do mês (1 a 31).
contratoCadastro.vencTextos.nDiaFixonúmero inteiroDia de vencimento fixo para a gerar o contas a receber
contratoCadastro.vencTextos.nDiasnúmero inteiroNúmero de Dias para a gerar o contas a receber
POST /api/v1/servicos/contrato/
curl -s https://app.omie.com.br/api/v1/servicos/contrato/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "ConsultarContrato", "param": [{"contratoChave": {"nCodCtr": 2203958}}]}'

ExcluirItem

altera dadosClaudeMCP

Exclui itens do contrato de serviços.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 2Campos e estruturas que você pode enviar
CampoTipoDescrição
ItensExclusaolista de objetosItens a serem excluídos do contrato.
ItensExclusao[].codIntItemtexto · até 30Código de integração do item do contrato (Utilizado em contratos de serviços criados a partir de API, não é visualizado na tela)
ItensExclusao[].codItemnúmero inteiroCódigo do Item.
contratoChaveobjetoChave de Pesquisa do Contrato de Serviço.
contratoChave.cCodIntCtrtexto · até 20Código de Integração do contrato de serviços. (Utilizado em contratos de serviços criados a partir de API, não é visualizado na tela)
contratoChave.nCodCtrnúmero inteiroCódigo do contrato de serviços. (Gerado internamente, não é visualizado na tela)
Retorno 4O que volta numa chamada bem-sucedida
CampoTipoDescrição
cCodIntCtrtextoCódigo de Integração do Contrato de Serviço
cCodStatustextoCódigo do Status
cDescStatustextoDescrição do Status
nCodCtrnúmero inteiroCódigo da Contrato de Serviço
POST /api/v1/servicos/contrato/
curl -s https://app.omie.com.br/api/v1/servicos/contrato/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "ExcluirItem", "param": [{"contratoChave": {"nCodCtr": 0, "cCodIntCtr": ""}, "ItensExclusao": [{"codItem": 0, "codIntItem": ""}]}]}'

IncluirContrato

altera dadosClaudeMCP

Inclusão de Contrato

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 10Campos e estruturas que você pode enviar
CampoTipoDescrição
cabecalhoobjeto
cabecalho.cCodIntCtrtexto · até 20Código de integração do contrato de serviços. (Utilizado em contratos criados via API, não é visualizado na tela)
cabecalho.cCodSittexto · até 2Código da situação do contrato de serviços. Pode ser: 00 - Em Elaboração 10 - Ativo 90 - Suspenso 99 - Cancelado
cabecalho.cNumCtrtexto · até 60Número do contrato de serviços. (Informado pelo usuário / visualizado na tela)
cabecalho.cTipoFattexto · até 2Tipo de Faturamento do Contrato. Pode ser: 01 - Todo Mês (mensal) 02 - A cada 2 meses (bimestral) 03 - A cada 3 meses (trimestral) 06 - A cada 6 meses (semestral) 12 - A cada 12 meses (anual)
cabecalho.dVigFinaltexto · até 10Data de vigência final do contrato de serviços.
cabecalho.dVigInicialtexto · até 10Data da vigência inicial do contrato de serviços.
cabecalho.nCodClinúmero inteiroCódigo do cliente a que se refere o contrato de serviços. (Gerado internamente, não é visualizado na tela)
cabecalho.nCodCtrnúmero inteiroCódigo do contrato de serviços. (Gerado internamente, não é visualizado na tela)
cabecalho.nDiaFatnúmero inteiroDia de faturamento.
cabecalho.nValTotMesnúmeroValor total mensal do contrato de serviços. (Calculado automaticamente)
departamentoslista de objetosDistribuição por departamento
departamentos[].cCodDeptexto · até 40Código do Departamento
departamentos[].cDesDeptexto · até 50Descrição do Departamento
departamentos[].nPerDepnúmeroPercentual do rateio
departamentos[].nValDepnúmeroValor do rateio
despesasReembolsaveisobjetoDespesas reembolsáveis
despesasReembolsaveis.cCodCategReembtexto · até 20Código da categoria para reembolso
despesasReembolsaveis.despesaReembolsavellista de objetosDespesa reembolsável
despesasReembolsaveis.despesaReembolsavel[].cAcaoReembtexto · até 1Ação para o reembolso, pode ser: I - Inclusão A - Alteração E - Exclusão
despesasReembolsaveis.despesaReembolsavel[].cDescReembtexto · até 200Descrição do reembolso
despesasReembolsaveis.despesaReembolsavel[].cRecorrenteReembtexto · até 1Indica se o reembolso é recorrente. [S/N]
despesasReembolsaveis.despesaReembolsavel[].dDataReembtexto · até 10Data do reembolso
despesasReembolsaveis.despesaReembolsavel[].nCodReembnúmero inteiroID do Reembolso
despesasReembolsaveis.despesaReembolsavel[].nValorReembnúmeroValor do Reembolso
emailClienteobjetoDados do envio de e-mail do cliente
emailCliente.cEnvViaUnicatexto · até 1Enviar ao cliente Via Única (Nota Fiscais Modelos 21 e 22). Pode ser: S - Sim N - Não
emailCliente.cEnviarBoletotexto · até 1Enviar também o(s) boleto(s) de cobrança
emailCliente.cEnviarLinkNfsetexto · até 1Enviar o link da NFS-e gerada na Prefeitura
emailCliente.cEnviarPixtexto · até 1Enviar também o(s) PIX(s) de cobrança
emailCliente.cEnviarRecibotexto · até 1Enviar um recibo de prestação de serviço (ao invés de NFS-e)
emailCliente.cUtilizarEmailstextoUtilizar os seguintes endereços de e-mail
infAdicobjeto
infAdic.cCidPrestServtexto · até 40Cidade da Prestação do Serviço e Estado
infAdic.cCodARTtexto · até 20Código ART
infAdic.cCodCategtexto · até 20Código da Categoria
infAdic.cCodObratexto · até 15Código da Obra
infAdic.cContatotexto · até 100Nome do Contato
infAdic.cDadosAdicNFtextoDados Adicionais para a Nota Fiscal
infAdic.cNumEncaptexto · até 15Código de Encapsulamento de notas dedutoras
infAdic.cUsoConsumotexto · até 1Uso e consumo pessoal. (0=Não, 1=Sim).
infAdic.nCodCCnúmero inteiroCódigo da Conta Corrente
infAdic.nCodProjnúmero inteiroCódigo do Projeto
infAdic.nCodVendnúmero inteiroCódigo do Vendedor
infAdic.nIdDestinatarionúmero inteiroID Cliente para o Destinatário.
infoCadastroobjetoInformações complementares do contrato.
infoCadastro.cImpAPItexto · até 1Importado pela API (S/N). Não deve ser informado na Inclusão/Alteração.
infoCadastro.cOrigemtexto · até 3Origem do Contrato de Serviço. Informado na Inclusão.
infoCadastro.dAlttexto · até 10Data da Alteração. No formato dd/mm/aaaa. Não deve ser informado na Inclusão/Alteração.
infoCadastro.dInctexto · até 10Data da Inclusão. No formato dd/mm/aaaa. Não deve ser informado na Inclusão/Alteração.
infoCadastro.hAlttexto · até 8Hora da Alteração. No formato hh:mm:ss. Não deve ser informado na Inclusão/Alteração.
infoCadastro.hInctexto · até 8Hora da Inclusão. No formato hh:mm:ss. Não deve ser informado na Inclusão/Alteração.
infoCadastro.uAlttexto · até 10Usuário da Alteração. Não deve ser informado na Inclusão/Alteração.
infoCadastro.uInctexto · até 10Usuário da Inclusão. Não deve ser informado na Inclusão/Alteração.
itensContratolista de objetos
itensContrato[].itemCabecalhoobjeto
itensContrato[].itemCabecalho.aliqDescontonúmeroAliquota do Desconto.
itensContrato[].itemCabecalho.cCodCategItemtexto · até 20Código da Categoria.
itensContrato[].itemCabecalho.cNaoGerarFinanceirotexto · até 1Não gerar conta a receber para este item. Informar "S" para não gerar movimento financeiro. Informar "N" para gerar movimento financeiro.
itensContrato[].itemCabecalho.cTpDescontotexto · até 1Tipo de Desconto. Pode ser: P - Percentual V - Valor
itensContrato[].itemCabecalho.codIntItemtexto · até 30Código de integração do item do contrato.
itensContrato[].itemCabecalho.codItemnúmero inteiroIdentificação do Item do Contrato. (Gerado automaticamente na Inclusão do item do contrato)
itensContrato[].itemCabecalho.codLC116texto · até 10Código do Serviço conforme Lei Complementar (LC 116). Caso tenha informado a tag "codServico" o preenchimento passa a ser opcional e irá assumir o valor informado no cadastro do respectivo serviço. Tabela única para todos os municípios.
itensContrato[].itemCabecalho.codNBStexto · até 9Código da Nomenclatura Brasileira de Serviços (NBS). Caso tenha informado a tag "codServico" irá assumir o valor informado no cadastro do respectivo serviço.
itensContrato[].itemCabecalho.codServMunictexto · até 20Código do Serviço Municipal ou CNAE. Caso tenha informado a tag "codServico" o preenchimento passa a ser opcional e irá assumir o valor informado no cadastro do respectivo serviço. Valores pode variar de acordo com o município. Verifique a legislação da sua cidade para obter os códigos de serviço disponíveis.
itensContrato[].itemCabecalho.codServiconúmero inteiroCódigo Interno do Serviço conforme cadastrado na tabela de serviços. Caso preenchido, irá assumir as informações do cadastro de serviço. Se não for preenchido, assumirá os valores informados na API.
itensContrato[].itemCabecalho.natOperacaotexto · até 2Natureza da Operação ou Tipo de Tributação dos Serviços. Caso tenha informado a tag "codServico" o preenchimento passa a ser opcional e irá assumir o valor informado no cadastro do respectivo serviço. Valores pode variar de acordo com o município. Verifique a legislação da sua cidade para obter os tipos de tributação disponíveis.
itensContrato[].itemCabecalho.quantnúmeroQuantidade de serviços. Caso tenha informado a tag "codServico" o preenchimento passa a ser opcional e irá assumir o valor padrão 1.
itensContrato[].itemCabecalho.seqnúmero inteiroSequência do Item do Contrato.
itensContrato[].itemCabecalho.valorAcrescimonúmeroValor de Acréscimos e taxas. (Disponível apenas para cidades que oferecem esse recurso.)
itensContrato[].itemCabecalho.valorDednúmeroValor de Deduções. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração.
itensContrato[].itemCabecalho.valorDescontonúmeroValor do Desconto.
itensContrato[].itemCabecalho.valorOutrasRetencoesnúmeroValor de Outras Retenções. (Disponível apenas para cidades que oferecem esse recurso.)
itensContrato[].itemCabecalho.valorTotalnúmeroValor total do item. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração.
itensContrato[].itemCabecalho.valorUnitnúmeroValor Unitário do serviço. Caso tenha informado a tag "codServico" o preenchimento passa a ser opcional e irá assumir o valor informado no cadastro do respectivo serviço.
itensContrato[].itemDescrServobjeto
itensContrato[].itemDescrServ.descrCompletatextoInforme a descrição completa do serviço prestado
itensContrato[].itemImpostosobjeto
itensContrato[].itemImpostos.aliqCOFINSnúmeroIndica se o imposto foi alterado pelo usuário ou informado via importação de planilha ou API. Esse campo é preenchido automaticamente pelo Omie e não deve ser informado na inclusão/alteração.
itensContrato[].itemImpostos.aliqCSLLobrigatórionúmeroAlíquota de CSLL. Para o cálculo do imposto o preenchimento é obrigatório caso a tag [cUtilizaValorImposto] seja diferente de "S". Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
itensContrato[].itemImpostos.aliqCbsnúmeroAlíquota da CBS Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.aliqINSSobrigatórionúmeroAlíquota de INSS. Para o cálculo do imposto o preenchimento é obrigatório caso a tag [cUtilizaValorImposto] seja diferente de "S". Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
itensContrato[].itemImpostos.aliqIRobrigatórionúmeroAlíquota de IR. Para o cálculo do imposto o preenchimento é obrigatório caso a tag [cUtilizaValorImposto] seja diferente de "S". Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
itensContrato[].itemImpostos.aliqISSnúmeroAlíquota de ISS.
itensContrato[].itemImpostos.aliqIbsMunnúmeroAlíquota do Alíquota do IBS Municipal. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.aliqIbsUfnúmeroAlíquota do IBS Estadual. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.aliqPISobrigatórionúmeroAlíquota de PIS. Para o cálculo do imposto o preenchimento é obrigatório caso a tag [cUtilizaValorImposto] seja diferente de "S". Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
itensContrato[].itemImpostos.cUtilizaValorImpostotexto · até 1Indica se o valor informado para os Impostos Federais deverá ser mantido ao invés de ser recalculado a partir da alíquota. Assim: Caso seja informado "N", indica que valor do imposto deve ser calculado a partir da alíquota e base de cálculo. Caso seja informado "S", indica que o valor do imposto será mantido e a alíquota será recalculada a partir do valor do imposto e base de cálculo.
itensContrato[].itemImpostos.classTribtexto · até 6Código de Classificação Tributária. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.cstIbsCbstexto · até 3Código da Situação Tributária IBS/CBS. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.indOpertexto · até 6Código Indicador de Operação. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.lDeduzISSsim/nãoDeduz o ISS da Base de Cálculo de PIS e COFINS
itensContrato[].itemImpostos.manCbstexto · até 1Indica que houve alteração manual da alíquota de CBS. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
itensContrato[].itemImpostos.manIbsMuntexto · até 1Indica que houve alteração manual da alíquota de IBS Municipal. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
itensContrato[].itemImpostos.manIbsUftexto · até 1Indica que houve alteração manual da alíquota de IBS Estadual. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
itensContrato[].itemImpostos.percReducaoCbsnúmeroPercentual redução CBS. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.percReducaoIbsMunnúmeroPercentual redução IBS estadual. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.percReducaoIbsUfnúmeroPercentual redução IBS municipal. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.redBaseCOFINSnúmeroPercentual de Redução da Base de Cálculo do COFINS.
itensContrato[].itemImpostos.redBaseINSSnúmeroPercentual de Redução da Base de Cálculo do INSS.
itensContrato[].itemImpostos.redBasePISnúmeroPercentual de Redução da Base de Cálculo do PIS.
itensContrato[].itemImpostos.retCOFINStexto · até 1Retém COFINS (S/N). Indica se o imposto deve ser retido ou não.
itensContrato[].itemImpostos.retCSLLtexto · até 1Retém CSLL (S/N). Indica se o imposto deve ser retido ou não.
itensContrato[].itemImpostos.retINSStexto · até 1Retém INSS (S/N). Indica se o imposto deve ser retido ou não.
itensContrato[].itemImpostos.retIRtexto · até 1Retém IR (S/N). Indica se o imposto deve ser retido ou não.
itensContrato[].itemImpostos.retISStexto · até 1Retém ISS (S/N). Indica se o imposto deve ser retido ou não.
itensContrato[].itemImpostos.retPIStexto · até 1Retém PIS (S/N). Indica se o imposto deve ser retido ou não.
itensContrato[].itemImpostos.valorCOFINSobrigatórionúmeroAlíquota de COFINS. Para o cálculo do imposto o preenchimento é obrigatório caso a tag [cUtilizaValorImposto] seja diferente de "S". Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
itensContrato[].itemImpostos.valorCSLLnúmeroValor de CSLL. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração caso a tag [cUtilizarValorImposto] seja diferente de "S". Caso a tag [cUtilizarValorImposto] seja preenchida com "S", indicará que o valor informado deve ser preservado e que a respectiva alíquota deve ser calculada ao invés do valor do imposto. Nesse caso, o alíquota informada na tag correspondente será desprezada.
itensContrato[].itemImpostos.valorCbsnúmeroValor da CBS. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
itensContrato[].itemImpostos.valorINSSnúmeroValor de INSS. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração caso a tag [cUtilizarValorImposto] seja diferente de "S". Caso a tag [cUtilizarValorImposto] seja preenchida com "S", indicará que o valor informado deve ser preservado e que a respectiva alíquota deve ser calculada ao invés do valor do imposto. Nesse caso, o alíquota informada na tag correspondente será desprezada.
itensContrato[].itemImpostos.valorIRnúmeroValor do IR. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração caso a tag [cUtilizarValorImposto] seja diferente de "S". Caso a tag [cUtilizarValorImposto] seja preenchida com "S", indicará que o valor informado deve ser preservado e que a respectiva alíquota deve ser calculada ao invés do valor do imposto. Nesse caso, o alíquota informada na tag correspondente será desprezada.
itensContrato[].itemImpostos.valorISSnúmeroValor do ISS. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração.
itensContrato[].itemImpostos.valorIbsMunnúmeroValor do IBS Municipal. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
itensContrato[].itemImpostos.valorIbsUfnúmeroValor do IBS Estadual. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
itensContrato[].itemImpostos.valorPISnúmeroValor do PIS. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração caso a tag [cUtilizarValorImposto] seja diferente de "S". Caso a tag [cUtilizarValorImposto] seja preenchida com "S", indicará que o valor informado deve ser preservado e que a respectiva alíquota deve ser calculada ao invés do valor do imposto. Nesse caso, o alíquota informada na tag correspondente será desprezada.
itensContrato[].itemLeiTranspImpobjeto
itensContrato[].itemLeiTranspImp.aliMunicipalnúmeroAlíquota Carga Trib. Aprox. Municipal
itensContrato[].itemLeiTranspImp.aliqEstadualnúmeroAlíquota Carga Trib. Aprox. Estadual
itensContrato[].itemLeiTranspImp.aliqFederalnúmeroAlíquota da Carga Tributária Aprox. Federal
itensContrato[].itemLeiTranspImp.chavetexto · até 6Chave do IBPT
itensContrato[].itemLeiTranspImp.fontetexto · até 34Fonte do IBPT
itensContrato[].itemOutrasInfobjetoOutras informações do item do contrato de serviços
itensContrato[].itemOutrasInf.dItVigFinaltexto · até 10Data da vigência final do item do contrato de serviços
itensContrato[].itemOutrasInf.dItVigInicialtexto · até 10Data da vigência inicial do item do contrato de serviços
itensContrato[].itemOutrasInf.nTipoItVigFinalnúmero inteiroTipo da vigência final do item do contrato de serviços. Valores possiveis: 1 - Data especifica 2 - Segue a vigência final do contrato 3 - Apenas para o proximo faturamento
itensContrato[].itemViaUnicaobjetoInformações referente ao serviço da NF modelo 21 ou 22.
itensContrato[].itemViaUnica.cCFOPtexto · até 10Código CFOP para NF Via Única (Modelos 21 e 22). Obrigatório quando a tag cEnvViaUnica for igual a "S". Utilize a tag "nCodigo" do método "ListarCFOP" da API /api/v1/produtos/cfop/ para obter essa informação.
itensContrato[].itemViaUnica.cClassifServicotexto · até 4Código da Classificação para NF Via Única (Modelos 21 e 22). Obrigatório quando a tag cEnvViaUnica for igual a "S". Utilize a tag "cCodigo" do método "ListarClassificacaoServico" da API /api/v1/servicos/classificacaoservico/ para obter essa informação.
itensContrato[].itemViaUnica.cModeloNFtexto · até 2Indica qual modelo de NF será emitida para o serviço. Obrigatório quando a tag cEnvViaUnica for igual a "S". Pode ser: 21 - Nota Fiscal de Serviço de Comunicação 22 - Nota Fiscal de Serviço de Telecomunicação
itensContrato[].itemViaUnica.cTipoReceitatexto · até 1Indicador do Tipo de Receita para NF Via Única (Modelos 21 e 22). Obrigatório quando a tag cEnvViaUnica for igual a "S". Pode ser: 0 - Receita própria - serviços prestados 1 - Receita própria - cobrança de débitos 2 - Receita própria - venda de mercadorias 3 - Receita própria - venda de serviço pré-pago 4 - Outras receitas próprias 5 - Receitas de terceiros (co-faturamento) 9 - Outras receitas de terceiros
itensContrato[].itemViaUnica.cTipoUtilizacaotexto · até 1Código do tipo de utilização para NF Via Única (Modelos 21 e 22). Obrigatório quando a tag cEnvViaUnica for igual a "S". Utilize a tag "cCodigo" do método "ListarTipoUtilizacao" da API /api/v1/servicos/tipoutilizacao/ para obter essa informação.
observacoesobjetoObservações do contrato
observacoes.cObsContratotextoObservações do Contrato. Essas informação não serão exibidas na Nota Fiscal).
produtosUtilizadosobjetoProdutos Utilizados no contrato.
produtosUtilizados.cAcaoProdUtilizadostexto · até 3Pode ser: REM - Será gerado uma remessa dos produtos para o cliente. EST - Será gerado uma saída de estoque. PED - Será gerado um pedido de venda. Obrigatório na inclusão.
produtosUtilizados.cCodCategRemtexto · até 20Código da Categoria da Remessa ou Pedido de Venda. Obrigatório quando usar [cAcaoFaturamento] como 'REM' ou 'PED'.
produtosUtilizados.produtoUtilizadolista de objetosProdutos utilizados no serviço.
produtosUtilizados.produtoUtilizado[].cAcaoItemPUtexto · até 1Pode ser: "A" - Alterar o item. "E" - Excluir o item. "I" - Incluir o item na alteração.
produtosUtilizados.produtoUtilizado[].codigo_local_estoquenúmero inteiroCódigo do Local do Estoque.
produtosUtilizados.produtoUtilizado[].lote_validadelista de objetosInformações referentes ao lote e validade do produto. A tag só deve ser informada se o produto possuir controle de lote e se a intenção é informar os lotes "manualmente" por API.
produtosUtilizados.produtoUtilizado[].lote_validade[].nIdLotenúmero inteiroId do lote do produto. Obrigatório quando o produto possui controle de lote e o método do consumo do lote está definido como 'Manual' nas configurações..
produtosUtilizados.produtoUtilizado[].lote_validade[].nQtdLoteobrigatórionúmeroInforme aqui a quantidade do lote para o produto. É obrigatório quando o produto possui controle de lote e o método do consumo do lote está definido como 'Manual' nas configurações.
produtosUtilizados.produtoUtilizado[].nCodProdutoPUnúmero inteiroCódigo interno do produto. (utilizado apenas na API). Esse código não aparece na tela do Omie.
produtosUtilizados.produtoUtilizado[].nIdItemPUnúmero inteiro(Código interno utilizado apenas na API). Não informar na inclusão. Esse código não aparece na tela do Omie.
produtosUtilizados.produtoUtilizado[].nQtdePUnúmeroQuantidade.
vencTextosobjeto
vencTextos.cAdContratotexto · até 1Adicionar o "Nº do Contrato" à descrição dos serviços na NFS-e
vencTextos.cAdPeriodotexto · até 1Adicionar o período de referência associado ao faturamento
vencTextos.cAdVenctexto · até 1Adicionar o vencimento da parcela à descrição dos serviços na NFS-e
vencTextos.cAntecipartexto · até 1Define se deve antecipar o vencimento ao considerar apenas dias úteis
vencTextos.cCodPerReftexto · até 3Período de Referência - Código do período de referência para o faturamento. Pode ser: 001 Mês do faturamento 002 Mês Anterior ao faturamento 003 Mês Posterior ao faturamento 004 Período Anterior ao faturamento 005 Período Posterior ao faturamento 006 Período Anterior específico 007 Número da Parcela 008 Período Posterior específico 009 Período Atual específico
vencTextos.cDiaFimtexto · até 2Dia Final - Dia para a data final do período de referência associado ao faturamento
vencTextos.cDiaInitexto · até 2Dia Inicial - Dia para a data inicial do período de referência associado ao faturamentDia Inicial
vencTextos.cPostergartexto · até 1Postergar Sábados, Domingos e Feriados Nacionais
vencTextos.cProxMestexto · até 1Define se o vencimento ocorrerá somente no mês seguinte.
vencTextos.cTpVenctexto · até 3Tipo de Vencimento. Pode ser: 001-Número de dias após faturar. 002-Fixar dia do mês (1 a 31).
vencTextos.nDiaFixonúmero inteiroDia de vencimento fixo para a gerar o contas a receber
vencTextos.nDiasnúmero inteiroNúmero de Dias para a gerar o contas a receber
Retorno 4O que volta numa chamada bem-sucedida
CampoTipoDescrição
cCodIntCtrtextoCódigo de Integração do Contrato de Serviço
cCodStatustextoCódigo do Status
cDescStatustextoDescrição do Status
nCodCtrnúmero inteiroCódigo da Contrato de Serviço
POST /api/v1/servicos/contrato/
curl -s https://app.omie.com.br/api/v1/servicos/contrato/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "IncluirContrato", "param": [{"cabecalho": {"cCodIntCtr": "019289Tb2", "cCodSit": "10", "cNumCtr": "2020/01001", "cTipoFat": "01", "dVigFinal": "30/03/2022", "dVigInicial": "29/03/2020", "nCodCli": 2370765, "nDiaFat": 30, "nValTotMes": 3302}, "departamentos": [], "emailCliente": {"cEnviarBoleto": "", "cEnviarLinkNfse": "", "cEnviarRecibo": "", "cUtilizarEmails": ""}, "infAdic": {"cCidPrestServ": "PETROPOLIS (RJ)", "cCodART": "", "cCodCateg": "1.01.02", "cCodObra": "", "cContato": "", "cDadosAdicNF": "", "nCodCC": 1208238, "nCodProj": 0, "nCodVend": 0}, "itensContrato": [{"itemCabecalho": {"codIntItem": "1", "cCodCategItem": "", "cNaoGerarFinanceiro": "N", "codLC116": "3.05", "codNBS": "", "codServMunic": "01292", "codServico": 0, "natOperacao": "01", "quant": 1, "seq": 1, "valorDed": 0, "valorTotal": 3002, "valorUnit": 3002}, "itemDescrServ": {"descrCompleta": "Serviços prestados"}, "itemImpostos": {"aliqCOFINS": 0, "aliqCSLL": 0, "aliqINSS": 0, "aliqIR": 0, "aliqISS": 5, "aliqPIS": 0, "redBaseINSS": 0, "retCOFINS": "", "retCSLL": "", "retINSS": "", "retIR": "", "retISS": "N", "retPIS": "", "valorCOFINS": 0, "valorCSLL": 0, "valorINSS": 0, "valorIR": 0, "valorISS": 150.1, "valorPIS": 0}, "itemLeiTranspImp": {"aliMunicipal": 0, "aliqEstadual": 0, "aliqFederal": 0, "chave": "", "fonte": ""}}, {"itemCabecalho": {"codIntItem": "2", "cCodCategItem": "", "cNaoGerarFinanceiro": "N", "codLC116": "17.01", "codNBS": "", "codServMunic": "0162-8/99", "codServico": 3412648, "natOperacao": "01", "quant": 1, "seq": 2, "valorDed": 0, "valorTotal": 300, "valorUnit": 300}, "itemDescrServ": {"descrCompleta": "Homologação de processo contábil"}, "itemImpostos": {"aliqCOFINS": 0, "aliqCSLL": 0, "aliqINSS": 0, "aliqIR": 0, "aliqISS": 3, "aliqPIS": 0, "redBaseINSS": 0, "retCOFINS": "", "retCSLL": "", "retINSS": "", "retIR": "", "retISS": "N", "retPIS": "", "valorCOFINS": 0, "valorCSLL": 0, "valorINSS": 0, "valorIR": 0, "valorISS": 9, "valorPIS": 0}, "itemLeiTranspImp": {"aliMunicipal": 0, "aliqEstadual": 0, "aliqFederal": 0, "chave": "", "fonte": ""}}], "observacoes": {"cObsContrato": ""}, "vencTextos": {"cAdContrato": "N", "cAdPeriodo": "N", "cAdVenc": " ", "cAntecipar": "", "cCodPerRef": "001", "cDiaFim": 0, "cDiaIni": 0, "cPostergar": "", "cProxMes": "", "cTpVenc": "001", "nDiaFixo": 0, "nDias": 5}}]}'

ListarContratos

consultaClaudeChatGPTMCP

Lista os contratos cadastrados.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 14Campos e estruturas que você pode enviar
CampoTipoDescrição
apenas_importado_apitexto · até 1
cExibeObstexto · até 1(S/N) Indica se a "Observação / Dados Adicionais" serão retornados na listagem.
cExibirInfoCadastrotexto · até 1Exibir as informações complementares do contrato (S/N). Preencher com "S" ou "N".
cExibirProdutostexto · até 1Exibir os produtos utilizados (S/N). Preencher com "S" ou "N".
filtrar_apenas_alteracaotexto · até 1
filtrar_apenas_inclusaotexto · até 1
filtrar_clientenúmero inteiro
filtrar_cnpj_cpftexto · até 20Filtrar os contratos por CNPJ/CPF.
filtrar_por_data_atetexto · até 10
filtrar_por_data_detexto · até 10
ordem_descrescentetexto · até 1
ordenar_portexto · até 100Ordem de exibição dos dados. Padrão: Código.
paginanúmero inteiro
registros_por_paginanúmero inteiro
Retorno 5O que volta numa chamada bem-sucedida
CampoTipoDescrição
contratoCadastrolista de objetosCadastro de Contrato de Serviço
contratoCadastro[].cabecalhoobjeto
contratoCadastro[].cabecalho.cCodIntCtrtextoCódigo de integração do contrato de serviços. (Utilizado em contratos criados via API, não é visualizado na tela)
contratoCadastro[].cabecalho.cCodSittextoCódigo da situação do contrato de serviços. Pode ser: 00 - Em Elaboração 10 - Ativo 90 - Suspenso 99 - Cancelado
contratoCadastro[].cabecalho.cNumCtrtextoNúmero do contrato de serviços. (Informado pelo usuário / visualizado na tela)
contratoCadastro[].cabecalho.cTipoFattextoTipo de Faturamento do Contrato. Pode ser: 01 - Todo Mês (mensal) 02 - A cada 2 meses (bimestral) 03 - A cada 3 meses (trimestral) 06 - A cada 6 meses (semestral) 12 - A cada 12 meses (anual)
contratoCadastro[].cabecalho.dVigFinaltextoData de vigência final do contrato de serviços.
contratoCadastro[].cabecalho.dVigInicialtextoData da vigência inicial do contrato de serviços.
contratoCadastro[].cabecalho.nCodClinúmero inteiroCódigo do cliente a que se refere o contrato de serviços. (Gerado internamente, não é visualizado na tela)
contratoCadastro[].cabecalho.nCodCtrnúmero inteiroCódigo do contrato de serviços. (Gerado internamente, não é visualizado na tela)
contratoCadastro[].cabecalho.nDiaFatnúmero inteiroDia de faturamento.
contratoCadastro[].cabecalho.nValTotMesdecimalValor total mensal do contrato de serviços. (Calculado automaticamente)
contratoCadastro[].departamentoslista de objetosDistribuição por departamento
contratoCadastro[].departamentos[].cCodDeptextoCódigo do Departamento
contratoCadastro[].departamentos[].cDesDeptextoDescrição do Departamento
contratoCadastro[].departamentos[].nPerDepdecimalPercentual do rateio
contratoCadastro[].departamentos[].nValDepdecimalValor do rateio
contratoCadastro[].despesasReembolsaveisobjetoDespesas reembolsáveis
contratoCadastro[].despesasReembolsaveis.cCodCategReembtextoCódigo da categoria para reembolso
contratoCadastro[].despesasReembolsaveis.despesaReembolsavellista de objetosDespesa reembolsável
contratoCadastro[].despesasReembolsaveis.despesaReembolsavel[].cAcaoReembtextoAção para o reembolso, pode ser: I - Inclusão A - Alteração E - Exclusão
contratoCadastro[].despesasReembolsaveis.despesaReembolsavel[].cDescReembtextoDescrição do reembolso
contratoCadastro[].despesasReembolsaveis.despesaReembolsavel[].cRecorrenteReembtextoIndica se o reembolso é recorrente. [S/N]
contratoCadastro[].despesasReembolsaveis.despesaReembolsavel[].dDataReembtextoData do reembolso
contratoCadastro[].despesasReembolsaveis.despesaReembolsavel[].nCodReembnúmero inteiroID do Reembolso
contratoCadastro[].despesasReembolsaveis.despesaReembolsavel[].nValorReembdecimalValor do Reembolso
contratoCadastro[].emailClienteobjetoDados do envio de e-mail do cliente
contratoCadastro[].emailCliente.cEnvViaUnicatextoEnviar ao cliente Via Única (Nota Fiscais Modelos 21 e 22). Pode ser: S - Sim N - Não
contratoCadastro[].emailCliente.cEnviarBoletotextoEnviar também o(s) boleto(s) de cobrança
contratoCadastro[].emailCliente.cEnviarLinkNfsetextoEnviar o link da NFS-e gerada na Prefeitura
contratoCadastro[].emailCliente.cEnviarPixtextoEnviar também o(s) PIX(s) de cobrança
contratoCadastro[].emailCliente.cEnviarRecibotextoEnviar um recibo de prestação de serviço (ao invés de NFS-e)
contratoCadastro[].emailCliente.cUtilizarEmailstextoUtilizar os seguintes endereços de e-mail
contratoCadastro[].infAdicobjeto
contratoCadastro[].infAdic.cCidPrestServtextoCidade da Prestação do Serviço e Estado
contratoCadastro[].infAdic.cCodARTtextoCódigo ART
contratoCadastro[].infAdic.cCodCategtextoCódigo da Categoria
contratoCadastro[].infAdic.cCodObratextoCódigo da Obra
contratoCadastro[].infAdic.cContatotextoNome do Contato
contratoCadastro[].infAdic.cDadosAdicNFtextoDados Adicionais para a Nota Fiscal
contratoCadastro[].infAdic.cNumEncaptextoCódigo de Encapsulamento de notas dedutoras
contratoCadastro[].infAdic.cUsoConsumotextoUso e consumo pessoal. (0=Não, 1=Sim).
contratoCadastro[].infAdic.nCodCCnúmero inteiroCódigo da Conta Corrente
contratoCadastro[].infAdic.nCodProjnúmero inteiroCódigo do Projeto
contratoCadastro[].infAdic.nCodVendnúmero inteiroCódigo do Vendedor
contratoCadastro[].infAdic.nIdDestinatarionúmero inteiroID Cliente para o Destinatário.
contratoCadastro[].infoCadastroobjetoInformações complementares do contrato.
contratoCadastro[].infoCadastro.cImpAPItextoImportado pela API (S/N). Não deve ser informado na Inclusão/Alteração.
contratoCadastro[].infoCadastro.cOrigemtextoOrigem do Contrato de Serviço. Informado na Inclusão.
contratoCadastro[].infoCadastro.dAlttextoData da Alteração. No formato dd/mm/aaaa. Não deve ser informado na Inclusão/Alteração.
contratoCadastro[].infoCadastro.dInctextoData da Inclusão. No formato dd/mm/aaaa. Não deve ser informado na Inclusão/Alteração.
contratoCadastro[].infoCadastro.hAlttextoHora da Alteração. No formato hh:mm:ss. Não deve ser informado na Inclusão/Alteração.
contratoCadastro[].infoCadastro.hInctextoHora da Inclusão. No formato hh:mm:ss. Não deve ser informado na Inclusão/Alteração.
contratoCadastro[].infoCadastro.uAlttextoUsuário da Alteração. Não deve ser informado na Inclusão/Alteração.
contratoCadastro[].infoCadastro.uInctextoUsuário da Inclusão. Não deve ser informado na Inclusão/Alteração.
contratoCadastro[].itensContratolista de objetos
contratoCadastro[].itensContrato[].itemCabecalhoobjeto
contratoCadastro[].itensContrato[].itemCabecalho.aliqDescontodecimalAliquota do Desconto.
contratoCadastro[].itensContrato[].itemCabecalho.cCodCategItemtextoCódigo da Categoria.
contratoCadastro[].itensContrato[].itemCabecalho.cNaoGerarFinanceirotextoNão gerar conta a receber para este item. Informar "S" para não gerar movimento financeiro. Informar "N" para gerar movimento financeiro.
contratoCadastro[].itensContrato[].itemCabecalho.cTpDescontotextoTipo de Desconto. Pode ser: P - Percentual V - Valor
contratoCadastro[].itensContrato[].itemCabecalho.codIntItemtextoCódigo de integração do item do contrato.
contratoCadastro[].itensContrato[].itemCabecalho.codItemnúmero inteiroIdentificação do Item do Contrato. (Gerado automaticamente na Inclusão do item do contrato)
contratoCadastro[].itensContrato[].itemCabecalho.codLC116textoCódigo do Serviço conforme Lei Complementar (LC 116). Caso tenha informado a tag "codServico" o preenchimento passa a ser opcional e irá assumir o valor informado no cadastro do respectivo serviço. Tabela única para todos os municípios.
contratoCadastro[].itensContrato[].itemCabecalho.codNBStextoCódigo da Nomenclatura Brasileira de Serviços (NBS). Caso tenha informado a tag "codServico" irá assumir o valor informado no cadastro do respectivo serviço.
contratoCadastro[].itensContrato[].itemCabecalho.codServMunictextoCódigo do Serviço Municipal ou CNAE. Caso tenha informado a tag "codServico" o preenchimento passa a ser opcional e irá assumir o valor informado no cadastro do respectivo serviço. Valores pode variar de acordo com o município. Verifique a legislação da sua cidade para obter os códigos de serviço disponíveis.
contratoCadastro[].itensContrato[].itemCabecalho.codServiconúmero inteiroCódigo Interno do Serviço conforme cadastrado na tabela de serviços. Caso preenchido, irá assumir as informações do cadastro de serviço. Se não for preenchido, assumirá os valores informados na API.
contratoCadastro[].itensContrato[].itemCabecalho.natOperacaotextoNatureza da Operação ou Tipo de Tributação dos Serviços. Caso tenha informado a tag "codServico" o preenchimento passa a ser opcional e irá assumir o valor informado no cadastro do respectivo serviço. Valores pode variar de acordo com o município. Verifique a legislação da sua cidade para obter os tipos de tributação disponíveis.
contratoCadastro[].itensContrato[].itemCabecalho.quantdecimalQuantidade de serviços. Caso tenha informado a tag "codServico" o preenchimento passa a ser opcional e irá assumir o valor padrão 1.
contratoCadastro[].itensContrato[].itemCabecalho.seqnúmero inteiroSequência do Item do Contrato.
contratoCadastro[].itensContrato[].itemCabecalho.valorAcrescimodecimalValor de Acréscimos e taxas. (Disponível apenas para cidades que oferecem esse recurso.)
contratoCadastro[].itensContrato[].itemCabecalho.valorDeddecimalValor de Deduções. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração.
contratoCadastro[].itensContrato[].itemCabecalho.valorDescontodecimalValor do Desconto.
contratoCadastro[].itensContrato[].itemCabecalho.valorOutrasRetencoesdecimalValor de Outras Retenções. (Disponível apenas para cidades que oferecem esse recurso.)
contratoCadastro[].itensContrato[].itemCabecalho.valorTotaldecimalValor total do item. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração.
contratoCadastro[].itensContrato[].itemCabecalho.valorUnitdecimalValor Unitário do serviço. Caso tenha informado a tag "codServico" o preenchimento passa a ser opcional e irá assumir o valor informado no cadastro do respectivo serviço.
contratoCadastro[].itensContrato[].itemDescrServobjeto
contratoCadastro[].itensContrato[].itemDescrServ.descrCompletatextoInforme a descrição completa do serviço prestado
contratoCadastro[].itensContrato[].itemImpostosobjeto
contratoCadastro[].itensContrato[].itemImpostos.aliqCOFINSdecimalIndica se o imposto foi alterado pelo usuário ou informado via importação de planilha ou API. Esse campo é preenchido automaticamente pelo Omie e não deve ser informado na inclusão/alteração.
contratoCadastro[].itensContrato[].itemImpostos.aliqCSLLdecimalAlíquota de CSLL. Para o cálculo do imposto o preenchimento é obrigatório caso a tag [cUtilizaValorImposto] seja diferente de "S". Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
contratoCadastro[].itensContrato[].itemImpostos.aliqCbsdecimalAlíquota da CBS Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
contratoCadastro[].itensContrato[].itemImpostos.aliqINSSdecimalAlíquota de INSS. Para o cálculo do imposto o preenchimento é obrigatório caso a tag [cUtilizaValorImposto] seja diferente de "S". Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
contratoCadastro[].itensContrato[].itemImpostos.aliqIRdecimalAlíquota de IR. Para o cálculo do imposto o preenchimento é obrigatório caso a tag [cUtilizaValorImposto] seja diferente de "S". Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
contratoCadastro[].itensContrato[].itemImpostos.aliqISSdecimalAlíquota de ISS.
contratoCadastro[].itensContrato[].itemImpostos.aliqIbsMundecimalAlíquota do Alíquota do IBS Municipal. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
contratoCadastro[].itensContrato[].itemImpostos.aliqIbsUfdecimalAlíquota do IBS Estadual. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
contratoCadastro[].itensContrato[].itemImpostos.aliqPISdecimalAlíquota de PIS. Para o cálculo do imposto o preenchimento é obrigatório caso a tag [cUtilizaValorImposto] seja diferente de "S". Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
contratoCadastro[].itensContrato[].itemImpostos.cUtilizaValorImpostotextoIndica se o valor informado para os Impostos Federais deverá ser mantido ao invés de ser recalculado a partir da alíquota. Assim: Caso seja informado "N", indica que valor do imposto deve ser calculado a partir da alíquota e base de cálculo. Caso seja informado "S", indica que o valor do imposto será mantido e a alíquota será recalculada a partir do valor do imposto e base de cálculo.
contratoCadastro[].itensContrato[].itemImpostos.classTribtextoCódigo de Classificação Tributária. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
contratoCadastro[].itensContrato[].itemImpostos.cstIbsCbstextoCódigo da Situação Tributária IBS/CBS. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
contratoCadastro[].itensContrato[].itemImpostos.indOpertextoCódigo Indicador de Operação. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
contratoCadastro[].itensContrato[].itemImpostos.lDeduzISSsim/nãoDeduz o ISS da Base de Cálculo de PIS e COFINS
contratoCadastro[].itensContrato[].itemImpostos.manCbstextoIndica que houve alteração manual da alíquota de CBS. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
contratoCadastro[].itensContrato[].itemImpostos.manIbsMuntextoIndica que houve alteração manual da alíquota de IBS Municipal. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
contratoCadastro[].itensContrato[].itemImpostos.manIbsUftextoIndica que houve alteração manual da alíquota de IBS Estadual. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
contratoCadastro[].itensContrato[].itemImpostos.percReducaoCbsdecimalPercentual redução CBS. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
contratoCadastro[].itensContrato[].itemImpostos.percReducaoIbsMundecimalPercentual redução IBS estadual. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
contratoCadastro[].itensContrato[].itemImpostos.percReducaoIbsUfdecimalPercentual redução IBS municipal. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
contratoCadastro[].itensContrato[].itemImpostos.redBaseCOFINSdecimalPercentual de Redução da Base de Cálculo do COFINS.
contratoCadastro[].itensContrato[].itemImpostos.redBaseINSSdecimalPercentual de Redução da Base de Cálculo do INSS.
contratoCadastro[].itensContrato[].itemImpostos.redBasePISdecimalPercentual de Redução da Base de Cálculo do PIS.
contratoCadastro[].itensContrato[].itemImpostos.retCOFINStextoRetém COFINS (S/N). Indica se o imposto deve ser retido ou não.
contratoCadastro[].itensContrato[].itemImpostos.retCSLLtextoRetém CSLL (S/N). Indica se o imposto deve ser retido ou não.
contratoCadastro[].itensContrato[].itemImpostos.retINSStextoRetém INSS (S/N). Indica se o imposto deve ser retido ou não.
contratoCadastro[].itensContrato[].itemImpostos.retIRtextoRetém IR (S/N). Indica se o imposto deve ser retido ou não.
contratoCadastro[].itensContrato[].itemImpostos.retISStextoRetém ISS (S/N). Indica se o imposto deve ser retido ou não.
contratoCadastro[].itensContrato[].itemImpostos.retPIStextoRetém PIS (S/N). Indica se o imposto deve ser retido ou não.
contratoCadastro[].itensContrato[].itemImpostos.valorCOFINSdecimalAlíquota de COFINS. Para o cálculo do imposto o preenchimento é obrigatório caso a tag [cUtilizaValorImposto] seja diferente de "S". Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
contratoCadastro[].itensContrato[].itemImpostos.valorCSLLdecimalValor de CSLL. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração caso a tag [cUtilizarValorImposto] seja diferente de "S". Caso a tag [cUtilizarValorImposto] seja preenchida com "S", indicará que o valor informado deve ser preservado e que a respectiva alíquota deve ser calculada ao invés do valor do imposto. Nesse caso, o alíquota informada na tag correspondente será desprezada.
contratoCadastro[].itensContrato[].itemImpostos.valorCbsdecimalValor da CBS. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
contratoCadastro[].itensContrato[].itemImpostos.valorINSSdecimalValor de INSS. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração caso a tag [cUtilizarValorImposto] seja diferente de "S". Caso a tag [cUtilizarValorImposto] seja preenchida com "S", indicará que o valor informado deve ser preservado e que a respectiva alíquota deve ser calculada ao invés do valor do imposto. Nesse caso, o alíquota informada na tag correspondente será desprezada.
contratoCadastro[].itensContrato[].itemImpostos.valorIRdecimalValor do IR. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração caso a tag [cUtilizarValorImposto] seja diferente de "S". Caso a tag [cUtilizarValorImposto] seja preenchida com "S", indicará que o valor informado deve ser preservado e que a respectiva alíquota deve ser calculada ao invés do valor do imposto. Nesse caso, o alíquota informada na tag correspondente será desprezada.
contratoCadastro[].itensContrato[].itemImpostos.valorISSdecimalValor do ISS. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração.
contratoCadastro[].itensContrato[].itemImpostos.valorIbsMundecimalValor do IBS Municipal. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
contratoCadastro[].itensContrato[].itemImpostos.valorIbsUfdecimalValor do IBS Estadual. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
contratoCadastro[].itensContrato[].itemImpostos.valorPISdecimalValor do PIS. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração caso a tag [cUtilizarValorImposto] seja diferente de "S". Caso a tag [cUtilizarValorImposto] seja preenchida com "S", indicará que o valor informado deve ser preservado e que a respectiva alíquota deve ser calculada ao invés do valor do imposto. Nesse caso, o alíquota informada na tag correspondente será desprezada.
contratoCadastro[].itensContrato[].itemLeiTranspImpobjeto
contratoCadastro[].itensContrato[].itemLeiTranspImp.aliMunicipaldecimalAlíquota Carga Trib. Aprox. Municipal
contratoCadastro[].itensContrato[].itemLeiTranspImp.aliqEstadualdecimalAlíquota Carga Trib. Aprox. Estadual
contratoCadastro[].itensContrato[].itemLeiTranspImp.aliqFederaldecimalAlíquota da Carga Tributária Aprox. Federal
contratoCadastro[].itensContrato[].itemLeiTranspImp.chavetextoChave do IBPT
contratoCadastro[].itensContrato[].itemLeiTranspImp.fontetextoFonte do IBPT
contratoCadastro[].itensContrato[].itemOutrasInfobjetoOutras informações do item do contrato de serviços
contratoCadastro[].itensContrato[].itemOutrasInf.dItVigFinaltextoData da vigência final do item do contrato de serviços
contratoCadastro[].itensContrato[].itemOutrasInf.dItVigInicialtextoData da vigência inicial do item do contrato de serviços
contratoCadastro[].itensContrato[].itemOutrasInf.nTipoItVigFinalnúmero inteiroTipo da vigência final do item do contrato de serviços. Valores possiveis: 1 - Data especifica 2 - Segue a vigência final do contrato 3 - Apenas para o proximo faturamento
contratoCadastro[].itensContrato[].itemViaUnicaobjetoInformações referente ao serviço da NF modelo 21 ou 22.
contratoCadastro[].itensContrato[].itemViaUnica.cCFOPtextoCódigo CFOP para NF Via Única (Modelos 21 e 22). Obrigatório quando a tag cEnvViaUnica for igual a "S". Utilize a tag "nCodigo" do método "ListarCFOP" da API /api/v1/produtos/cfop/ para obter essa informação.
contratoCadastro[].itensContrato[].itemViaUnica.cClassifServicotextoCódigo da Classificação para NF Via Única (Modelos 21 e 22). Obrigatório quando a tag cEnvViaUnica for igual a "S". Utilize a tag "cCodigo" do método "ListarClassificacaoServico" da API /api/v1/servicos/classificacaoservico/ para obter essa informação.
contratoCadastro[].itensContrato[].itemViaUnica.cModeloNFtextoIndica qual modelo de NF será emitida para o serviço. Obrigatório quando a tag cEnvViaUnica for igual a "S". Pode ser: 21 - Nota Fiscal de Serviço de Comunicação 22 - Nota Fiscal de Serviço de Telecomunicação
contratoCadastro[].itensContrato[].itemViaUnica.cTipoReceitatextoIndicador do Tipo de Receita para NF Via Única (Modelos 21 e 22). Obrigatório quando a tag cEnvViaUnica for igual a "S". Pode ser: 0 - Receita própria - serviços prestados 1 - Receita própria - cobrança de débitos 2 - Receita própria - venda de mercadorias 3 - Receita própria - venda de serviço pré-pago 4 - Outras receitas próprias 5 - Receitas de terceiros (co-faturamento) 9 - Outras receitas de terceiros
contratoCadastro[].itensContrato[].itemViaUnica.cTipoUtilizacaotextoCódigo do tipo de utilização para NF Via Única (Modelos 21 e 22). Obrigatório quando a tag cEnvViaUnica for igual a "S". Utilize a tag "cCodigo" do método "ListarTipoUtilizacao" da API /api/v1/servicos/tipoutilizacao/ para obter essa informação.
contratoCadastro[].observacoesobjetoObservações do contrato
contratoCadastro[].observacoes.cObsContratotextoObservações do Contrato. Essas informação não serão exibidas na Nota Fiscal).
contratoCadastro[].produtosUtilizadosobjetoProdutos Utilizados no contrato.
contratoCadastro[].produtosUtilizados.cAcaoProdUtilizadostextoPode ser: REM - Será gerado uma remessa dos produtos para o cliente. EST - Será gerado uma saída de estoque. PED - Será gerado um pedido de venda. Obrigatório na inclusão.
contratoCadastro[].produtosUtilizados.cCodCategRemtextoCódigo da Categoria da Remessa ou Pedido de Venda. Obrigatório quando usar [cAcaoFaturamento] como 'REM' ou 'PED'.
contratoCadastro[].produtosUtilizados.produtoUtilizadolista de objetosProdutos utilizados no serviço.
contratoCadastro[].produtosUtilizados.produtoUtilizado[].cAcaoItemPUtextoPode ser: "A" - Alterar o item. "E" - Excluir o item. "I" - Incluir o item na alteração.
contratoCadastro[].produtosUtilizados.produtoUtilizado[].codigo_local_estoquenúmero inteiroCódigo do Local do Estoque.
contratoCadastro[].produtosUtilizados.produtoUtilizado[].lote_validadelista de objetosInformações referentes ao lote e validade do produto. A tag só deve ser informada se o produto possuir controle de lote e se a intenção é informar os lotes "manualmente" por API.
contratoCadastro[].produtosUtilizados.produtoUtilizado[].lote_validade[].nIdLotenúmero inteiroId do lote do produto. Obrigatório quando o produto possui controle de lote e o método do consumo do lote está definido como 'Manual' nas configurações..
contratoCadastro[].produtosUtilizados.produtoUtilizado[].lote_validade[].nQtdLotedecimalInforme aqui a quantidade do lote para o produto. É obrigatório quando o produto possui controle de lote e o método do consumo do lote está definido como 'Manual' nas configurações.
contratoCadastro[].produtosUtilizados.produtoUtilizado[].nCodProdutoPUnúmero inteiroCódigo interno do produto. (utilizado apenas na API). Esse código não aparece na tela do Omie.
contratoCadastro[].produtosUtilizados.produtoUtilizado[].nIdItemPUnúmero inteiro(Código interno utilizado apenas na API). Não informar na inclusão. Esse código não aparece na tela do Omie.
contratoCadastro[].produtosUtilizados.produtoUtilizado[].nQtdePUdecimalQuantidade.
contratoCadastro[].vencTextosobjeto
contratoCadastro[].vencTextos.cAdContratotextoAdicionar o "Nº do Contrato" à descrição dos serviços na NFS-e
contratoCadastro[].vencTextos.cAdPeriodotextoAdicionar o período de referência associado ao faturamento
contratoCadastro[].vencTextos.cAdVenctextoAdicionar o vencimento da parcela à descrição dos serviços na NFS-e
contratoCadastro[].vencTextos.cAntecipartextoDefine se deve antecipar o vencimento ao considerar apenas dias úteis
contratoCadastro[].vencTextos.cCodPerReftextoPeríodo de Referência - Código do período de referência para o faturamento. Pode ser: 001 Mês do faturamento 002 Mês Anterior ao faturamento 003 Mês Posterior ao faturamento 004 Período Anterior ao faturamento 005 Período Posterior ao faturamento 006 Período Anterior específico 007 Número da Parcela 008 Período Posterior específico 009 Período Atual específico
contratoCadastro[].vencTextos.cDiaFimnúmero inteiroDia Final - Dia para a data final do período de referência associado ao faturamento
contratoCadastro[].vencTextos.cDiaIninúmero inteiroDia Inicial - Dia para a data inicial do período de referência associado ao faturamentDia Inicial
contratoCadastro[].vencTextos.cPostergartextoPostergar Sábados, Domingos e Feriados Nacionais
contratoCadastro[].vencTextos.cProxMestextoDefine se o vencimento ocorrerá somente no mês seguinte.
contratoCadastro[].vencTextos.cTpVenctextoTipo de Vencimento. Pode ser: 001-Número de dias após faturar. 002-Fixar dia do mês (1 a 31).
contratoCadastro[].vencTextos.nDiaFixonúmero inteiroDia de vencimento fixo para a gerar o contas a receber
contratoCadastro[].vencTextos.nDiasnúmero inteiroNúmero de Dias para a gerar o contas a receber
paginanúmero inteiro
registrosnúmero inteiro
total_de_paginasnúmero inteiro
total_de_registrosnúmero inteiro
POST /api/v1/servicos/contrato/
curl -s https://app.omie.com.br/api/v1/servicos/contrato/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "ListarContratos", "param": [{"pagina": 1, "registros_por_pagina": 50, "apenas_importado_api": "N"}]}'

UpsertContrato

altera dadosClaudeMCP

Inclui / Altera um contrato

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 10Campos e estruturas que você pode enviar
CampoTipoDescrição
cabecalhoobjeto
cabecalho.cCodIntCtrtexto · até 20Código de integração do contrato de serviços. (Utilizado em contratos criados via API, não é visualizado na tela)
cabecalho.cCodSittexto · até 2Código da situação do contrato de serviços. Pode ser: 00 - Em Elaboração 10 - Ativo 90 - Suspenso 99 - Cancelado
cabecalho.cNumCtrtexto · até 60Número do contrato de serviços. (Informado pelo usuário / visualizado na tela)
cabecalho.cTipoFattexto · até 2Tipo de Faturamento do Contrato. Pode ser: 01 - Todo Mês (mensal) 02 - A cada 2 meses (bimestral) 03 - A cada 3 meses (trimestral) 06 - A cada 6 meses (semestral) 12 - A cada 12 meses (anual)
cabecalho.dVigFinaltexto · até 10Data de vigência final do contrato de serviços.
cabecalho.dVigInicialtexto · até 10Data da vigência inicial do contrato de serviços.
cabecalho.nCodClinúmero inteiroCódigo do cliente a que se refere o contrato de serviços. (Gerado internamente, não é visualizado na tela)
cabecalho.nCodCtrnúmero inteiroCódigo do contrato de serviços. (Gerado internamente, não é visualizado na tela)
cabecalho.nDiaFatnúmero inteiroDia de faturamento.
cabecalho.nValTotMesnúmeroValor total mensal do contrato de serviços. (Calculado automaticamente)
departamentoslista de objetosDistribuição por departamento
departamentos[].cCodDeptexto · até 40Código do Departamento
departamentos[].cDesDeptexto · até 50Descrição do Departamento
departamentos[].nPerDepnúmeroPercentual do rateio
departamentos[].nValDepnúmeroValor do rateio
despesasReembolsaveisobjetoDespesas reembolsáveis
despesasReembolsaveis.cCodCategReembtexto · até 20Código da categoria para reembolso
despesasReembolsaveis.despesaReembolsavellista de objetosDespesa reembolsável
despesasReembolsaveis.despesaReembolsavel[].cAcaoReembtexto · até 1Ação para o reembolso, pode ser: I - Inclusão A - Alteração E - Exclusão
despesasReembolsaveis.despesaReembolsavel[].cDescReembtexto · até 200Descrição do reembolso
despesasReembolsaveis.despesaReembolsavel[].cRecorrenteReembtexto · até 1Indica se o reembolso é recorrente. [S/N]
despesasReembolsaveis.despesaReembolsavel[].dDataReembtexto · até 10Data do reembolso
despesasReembolsaveis.despesaReembolsavel[].nCodReembnúmero inteiroID do Reembolso
despesasReembolsaveis.despesaReembolsavel[].nValorReembnúmeroValor do Reembolso
emailClienteobjetoDados do envio de e-mail do cliente
emailCliente.cEnvViaUnicatexto · até 1Enviar ao cliente Via Única (Nota Fiscais Modelos 21 e 22). Pode ser: S - Sim N - Não
emailCliente.cEnviarBoletotexto · até 1Enviar também o(s) boleto(s) de cobrança
emailCliente.cEnviarLinkNfsetexto · até 1Enviar o link da NFS-e gerada na Prefeitura
emailCliente.cEnviarPixtexto · até 1Enviar também o(s) PIX(s) de cobrança
emailCliente.cEnviarRecibotexto · até 1Enviar um recibo de prestação de serviço (ao invés de NFS-e)
emailCliente.cUtilizarEmailstextoUtilizar os seguintes endereços de e-mail
infAdicobjeto
infAdic.cCidPrestServtexto · até 40Cidade da Prestação do Serviço e Estado
infAdic.cCodARTtexto · até 20Código ART
infAdic.cCodCategtexto · até 20Código da Categoria
infAdic.cCodObratexto · até 15Código da Obra
infAdic.cContatotexto · até 100Nome do Contato
infAdic.cDadosAdicNFtextoDados Adicionais para a Nota Fiscal
infAdic.cNumEncaptexto · até 15Código de Encapsulamento de notas dedutoras
infAdic.cUsoConsumotexto · até 1Uso e consumo pessoal. (0=Não, 1=Sim).
infAdic.nCodCCnúmero inteiroCódigo da Conta Corrente
infAdic.nCodProjnúmero inteiroCódigo do Projeto
infAdic.nCodVendnúmero inteiroCódigo do Vendedor
infAdic.nIdDestinatarionúmero inteiroID Cliente para o Destinatário.
infoCadastroobjetoInformações complementares do contrato.
infoCadastro.cImpAPItexto · até 1Importado pela API (S/N). Não deve ser informado na Inclusão/Alteração.
infoCadastro.cOrigemtexto · até 3Origem do Contrato de Serviço. Informado na Inclusão.
infoCadastro.dAlttexto · até 10Data da Alteração. No formato dd/mm/aaaa. Não deve ser informado na Inclusão/Alteração.
infoCadastro.dInctexto · até 10Data da Inclusão. No formato dd/mm/aaaa. Não deve ser informado na Inclusão/Alteração.
infoCadastro.hAlttexto · até 8Hora da Alteração. No formato hh:mm:ss. Não deve ser informado na Inclusão/Alteração.
infoCadastro.hInctexto · até 8Hora da Inclusão. No formato hh:mm:ss. Não deve ser informado na Inclusão/Alteração.
infoCadastro.uAlttexto · até 10Usuário da Alteração. Não deve ser informado na Inclusão/Alteração.
infoCadastro.uInctexto · até 10Usuário da Inclusão. Não deve ser informado na Inclusão/Alteração.
itensContratolista de objetos
itensContrato[].itemCabecalhoobjeto
itensContrato[].itemCabecalho.aliqDescontonúmeroAliquota do Desconto.
itensContrato[].itemCabecalho.cCodCategItemtexto · até 20Código da Categoria.
itensContrato[].itemCabecalho.cNaoGerarFinanceirotexto · até 1Não gerar conta a receber para este item. Informar "S" para não gerar movimento financeiro. Informar "N" para gerar movimento financeiro.
itensContrato[].itemCabecalho.cTpDescontotexto · até 1Tipo de Desconto. Pode ser: P - Percentual V - Valor
itensContrato[].itemCabecalho.codIntItemtexto · até 30Código de integração do item do contrato.
itensContrato[].itemCabecalho.codItemnúmero inteiroIdentificação do Item do Contrato. (Gerado automaticamente na Inclusão do item do contrato)
itensContrato[].itemCabecalho.codLC116texto · até 10Código do Serviço conforme Lei Complementar (LC 116). Caso tenha informado a tag "codServico" o preenchimento passa a ser opcional e irá assumir o valor informado no cadastro do respectivo serviço. Tabela única para todos os municípios.
itensContrato[].itemCabecalho.codNBStexto · até 9Código da Nomenclatura Brasileira de Serviços (NBS). Caso tenha informado a tag "codServico" irá assumir o valor informado no cadastro do respectivo serviço.
itensContrato[].itemCabecalho.codServMunictexto · até 20Código do Serviço Municipal ou CNAE. Caso tenha informado a tag "codServico" o preenchimento passa a ser opcional e irá assumir o valor informado no cadastro do respectivo serviço. Valores pode variar de acordo com o município. Verifique a legislação da sua cidade para obter os códigos de serviço disponíveis.
itensContrato[].itemCabecalho.codServiconúmero inteiroCódigo Interno do Serviço conforme cadastrado na tabela de serviços. Caso preenchido, irá assumir as informações do cadastro de serviço. Se não for preenchido, assumirá os valores informados na API.
itensContrato[].itemCabecalho.natOperacaotexto · até 2Natureza da Operação ou Tipo de Tributação dos Serviços. Caso tenha informado a tag "codServico" o preenchimento passa a ser opcional e irá assumir o valor informado no cadastro do respectivo serviço. Valores pode variar de acordo com o município. Verifique a legislação da sua cidade para obter os tipos de tributação disponíveis.
itensContrato[].itemCabecalho.quantnúmeroQuantidade de serviços. Caso tenha informado a tag "codServico" o preenchimento passa a ser opcional e irá assumir o valor padrão 1.
itensContrato[].itemCabecalho.seqnúmero inteiroSequência do Item do Contrato.
itensContrato[].itemCabecalho.valorAcrescimonúmeroValor de Acréscimos e taxas. (Disponível apenas para cidades que oferecem esse recurso.)
itensContrato[].itemCabecalho.valorDednúmeroValor de Deduções. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração.
itensContrato[].itemCabecalho.valorDescontonúmeroValor do Desconto.
itensContrato[].itemCabecalho.valorOutrasRetencoesnúmeroValor de Outras Retenções. (Disponível apenas para cidades que oferecem esse recurso.)
itensContrato[].itemCabecalho.valorTotalnúmeroValor total do item. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração.
itensContrato[].itemCabecalho.valorUnitnúmeroValor Unitário do serviço. Caso tenha informado a tag "codServico" o preenchimento passa a ser opcional e irá assumir o valor informado no cadastro do respectivo serviço.
itensContrato[].itemDescrServobjeto
itensContrato[].itemDescrServ.descrCompletatextoInforme a descrição completa do serviço prestado
itensContrato[].itemImpostosobjeto
itensContrato[].itemImpostos.aliqCOFINSnúmeroIndica se o imposto foi alterado pelo usuário ou informado via importação de planilha ou API. Esse campo é preenchido automaticamente pelo Omie e não deve ser informado na inclusão/alteração.
itensContrato[].itemImpostos.aliqCSLLobrigatórionúmeroAlíquota de CSLL. Para o cálculo do imposto o preenchimento é obrigatório caso a tag [cUtilizaValorImposto] seja diferente de "S". Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
itensContrato[].itemImpostos.aliqCbsnúmeroAlíquota da CBS Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.aliqINSSobrigatórionúmeroAlíquota de INSS. Para o cálculo do imposto o preenchimento é obrigatório caso a tag [cUtilizaValorImposto] seja diferente de "S". Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
itensContrato[].itemImpostos.aliqIRobrigatórionúmeroAlíquota de IR. Para o cálculo do imposto o preenchimento é obrigatório caso a tag [cUtilizaValorImposto] seja diferente de "S". Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
itensContrato[].itemImpostos.aliqISSnúmeroAlíquota de ISS.
itensContrato[].itemImpostos.aliqIbsMunnúmeroAlíquota do Alíquota do IBS Municipal. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.aliqIbsUfnúmeroAlíquota do IBS Estadual. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.aliqPISobrigatórionúmeroAlíquota de PIS. Para o cálculo do imposto o preenchimento é obrigatório caso a tag [cUtilizaValorImposto] seja diferente de "S". Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
itensContrato[].itemImpostos.cUtilizaValorImpostotexto · até 1Indica se o valor informado para os Impostos Federais deverá ser mantido ao invés de ser recalculado a partir da alíquota. Assim: Caso seja informado "N", indica que valor do imposto deve ser calculado a partir da alíquota e base de cálculo. Caso seja informado "S", indica que o valor do imposto será mantido e a alíquota será recalculada a partir do valor do imposto e base de cálculo.
itensContrato[].itemImpostos.classTribtexto · até 6Código de Classificação Tributária. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.cstIbsCbstexto · até 3Código da Situação Tributária IBS/CBS. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.indOpertexto · até 6Código Indicador de Operação. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.lDeduzISSsim/nãoDeduz o ISS da Base de Cálculo de PIS e COFINS
itensContrato[].itemImpostos.manCbstexto · até 1Indica que houve alteração manual da alíquota de CBS. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
itensContrato[].itemImpostos.manIbsMuntexto · até 1Indica que houve alteração manual da alíquota de IBS Municipal. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
itensContrato[].itemImpostos.manIbsUftexto · até 1Indica que houve alteração manual da alíquota de IBS Estadual. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
itensContrato[].itemImpostos.percReducaoCbsnúmeroPercentual redução CBS. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.percReducaoIbsMunnúmeroPercentual redução IBS estadual. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.percReducaoIbsUfnúmeroPercentual redução IBS municipal. Caso não preenchido para um novo item nos métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço ou configuração padrão da reforma tributária no Omie.
itensContrato[].itemImpostos.redBaseCOFINSnúmeroPercentual de Redução da Base de Cálculo do COFINS.
itensContrato[].itemImpostos.redBaseINSSnúmeroPercentual de Redução da Base de Cálculo do INSS.
itensContrato[].itemImpostos.redBasePISnúmeroPercentual de Redução da Base de Cálculo do PIS.
itensContrato[].itemImpostos.retCOFINStexto · até 1Retém COFINS (S/N). Indica se o imposto deve ser retido ou não.
itensContrato[].itemImpostos.retCSLLtexto · até 1Retém CSLL (S/N). Indica se o imposto deve ser retido ou não.
itensContrato[].itemImpostos.retINSStexto · até 1Retém INSS (S/N). Indica se o imposto deve ser retido ou não.
itensContrato[].itemImpostos.retIRtexto · até 1Retém IR (S/N). Indica se o imposto deve ser retido ou não.
itensContrato[].itemImpostos.retISStexto · até 1Retém ISS (S/N). Indica se o imposto deve ser retido ou não.
itensContrato[].itemImpostos.retPIStexto · até 1Retém PIS (S/N). Indica se o imposto deve ser retido ou não.
itensContrato[].itemImpostos.valorCOFINSobrigatórionúmeroAlíquota de COFINS. Para o cálculo do imposto o preenchimento é obrigatório caso a tag [cUtilizaValorImposto] seja diferente de "S". Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
itensContrato[].itemImpostos.valorCSLLnúmeroValor de CSLL. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração caso a tag [cUtilizarValorImposto] seja diferente de "S". Caso a tag [cUtilizarValorImposto] seja preenchida com "S", indicará que o valor informado deve ser preservado e que a respectiva alíquota deve ser calculada ao invés do valor do imposto. Nesse caso, o alíquota informada na tag correspondente será desprezada.
itensContrato[].itemImpostos.valorCbsnúmeroValor da CBS. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
itensContrato[].itemImpostos.valorINSSnúmeroValor de INSS. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração caso a tag [cUtilizarValorImposto] seja diferente de "S". Caso a tag [cUtilizarValorImposto] seja preenchida com "S", indicará que o valor informado deve ser preservado e que a respectiva alíquota deve ser calculada ao invés do valor do imposto. Nesse caso, o alíquota informada na tag correspondente será desprezada.
itensContrato[].itemImpostos.valorIRnúmeroValor do IR. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração caso a tag [cUtilizarValorImposto] seja diferente de "S". Caso a tag [cUtilizarValorImposto] seja preenchida com "S", indicará que o valor informado deve ser preservado e que a respectiva alíquota deve ser calculada ao invés do valor do imposto. Nesse caso, o alíquota informada na tag correspondente será desprezada.
itensContrato[].itemImpostos.valorISSnúmeroValor do ISS. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração.
itensContrato[].itemImpostos.valorIbsMunnúmeroValor do IBS Municipal. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
itensContrato[].itemImpostos.valorIbsUfnúmeroValor do IBS Estadual. Não deve ser informado na Inclusão/Alteração. Campo disponível apenas para consulta. Para os métodos de inclusão e alteração, esse campo será preenchido conforme o cadastro do serviço no Omie.
itensContrato[].itemImpostos.valorPISnúmeroValor do PIS. Esse campo é calculado automaticamente pelo Omie e não deve ser informado na inclusão/alteração caso a tag [cUtilizarValorImposto] seja diferente de "S". Caso a tag [cUtilizarValorImposto] seja preenchida com "S", indicará que o valor informado deve ser preservado e que a respectiva alíquota deve ser calculada ao invés do valor do imposto. Nesse caso, o alíquota informada na tag correspondente será desprezada.
itensContrato[].itemLeiTranspImpobjeto
itensContrato[].itemLeiTranspImp.aliMunicipalnúmeroAlíquota Carga Trib. Aprox. Municipal
itensContrato[].itemLeiTranspImp.aliqEstadualnúmeroAlíquota Carga Trib. Aprox. Estadual
itensContrato[].itemLeiTranspImp.aliqFederalnúmeroAlíquota da Carga Tributária Aprox. Federal
itensContrato[].itemLeiTranspImp.chavetexto · até 6Chave do IBPT
itensContrato[].itemLeiTranspImp.fontetexto · até 34Fonte do IBPT
itensContrato[].itemOutrasInfobjetoOutras informações do item do contrato de serviços
itensContrato[].itemOutrasInf.dItVigFinaltexto · até 10Data da vigência final do item do contrato de serviços
itensContrato[].itemOutrasInf.dItVigInicialtexto · até 10Data da vigência inicial do item do contrato de serviços
itensContrato[].itemOutrasInf.nTipoItVigFinalnúmero inteiroTipo da vigência final do item do contrato de serviços. Valores possiveis: 1 - Data especifica 2 - Segue a vigência final do contrato 3 - Apenas para o proximo faturamento
itensContrato[].itemViaUnicaobjetoInformações referente ao serviço da NF modelo 21 ou 22.
itensContrato[].itemViaUnica.cCFOPtexto · até 10Código CFOP para NF Via Única (Modelos 21 e 22). Obrigatório quando a tag cEnvViaUnica for igual a "S". Utilize a tag "nCodigo" do método "ListarCFOP" da API /api/v1/produtos/cfop/ para obter essa informação.
itensContrato[].itemViaUnica.cClassifServicotexto · até 4Código da Classificação para NF Via Única (Modelos 21 e 22). Obrigatório quando a tag cEnvViaUnica for igual a "S". Utilize a tag "cCodigo" do método "ListarClassificacaoServico" da API /api/v1/servicos/classificacaoservico/ para obter essa informação.
itensContrato[].itemViaUnica.cModeloNFtexto · até 2Indica qual modelo de NF será emitida para o serviço. Obrigatório quando a tag cEnvViaUnica for igual a "S". Pode ser: 21 - Nota Fiscal de Serviço de Comunicação 22 - Nota Fiscal de Serviço de Telecomunicação
itensContrato[].itemViaUnica.cTipoReceitatexto · até 1Indicador do Tipo de Receita para NF Via Única (Modelos 21 e 22). Obrigatório quando a tag cEnvViaUnica for igual a "S". Pode ser: 0 - Receita própria - serviços prestados 1 - Receita própria - cobrança de débitos 2 - Receita própria - venda de mercadorias 3 - Receita própria - venda de serviço pré-pago 4 - Outras receitas próprias 5 - Receitas de terceiros (co-faturamento) 9 - Outras receitas de terceiros
itensContrato[].itemViaUnica.cTipoUtilizacaotexto · até 1Código do tipo de utilização para NF Via Única (Modelos 21 e 22). Obrigatório quando a tag cEnvViaUnica for igual a "S". Utilize a tag "cCodigo" do método "ListarTipoUtilizacao" da API /api/v1/servicos/tipoutilizacao/ para obter essa informação.
observacoesobjetoObservações do contrato
observacoes.cObsContratotextoObservações do Contrato. Essas informação não serão exibidas na Nota Fiscal).
produtosUtilizadosobjetoProdutos Utilizados no contrato.
produtosUtilizados.cAcaoProdUtilizadostexto · até 3Pode ser: REM - Será gerado uma remessa dos produtos para o cliente. EST - Será gerado uma saída de estoque. PED - Será gerado um pedido de venda. Obrigatório na inclusão.
produtosUtilizados.cCodCategRemtexto · até 20Código da Categoria da Remessa ou Pedido de Venda. Obrigatório quando usar [cAcaoFaturamento] como 'REM' ou 'PED'.
produtosUtilizados.produtoUtilizadolista de objetosProdutos utilizados no serviço.
produtosUtilizados.produtoUtilizado[].cAcaoItemPUtexto · até 1Pode ser: "A" - Alterar o item. "E" - Excluir o item. "I" - Incluir o item na alteração.
produtosUtilizados.produtoUtilizado[].codigo_local_estoquenúmero inteiroCódigo do Local do Estoque.
produtosUtilizados.produtoUtilizado[].lote_validadelista de objetosInformações referentes ao lote e validade do produto. A tag só deve ser informada se o produto possuir controle de lote e se a intenção é informar os lotes "manualmente" por API.
produtosUtilizados.produtoUtilizado[].lote_validade[].nIdLotenúmero inteiroId do lote do produto. Obrigatório quando o produto possui controle de lote e o método do consumo do lote está definido como 'Manual' nas configurações..
produtosUtilizados.produtoUtilizado[].lote_validade[].nQtdLoteobrigatórionúmeroInforme aqui a quantidade do lote para o produto. É obrigatório quando o produto possui controle de lote e o método do consumo do lote está definido como 'Manual' nas configurações.
produtosUtilizados.produtoUtilizado[].nCodProdutoPUnúmero inteiroCódigo interno do produto. (utilizado apenas na API). Esse código não aparece na tela do Omie.
produtosUtilizados.produtoUtilizado[].nIdItemPUnúmero inteiro(Código interno utilizado apenas na API). Não informar na inclusão. Esse código não aparece na tela do Omie.
produtosUtilizados.produtoUtilizado[].nQtdePUnúmeroQuantidade.
vencTextosobjeto
vencTextos.cAdContratotexto · até 1Adicionar o "Nº do Contrato" à descrição dos serviços na NFS-e
vencTextos.cAdPeriodotexto · até 1Adicionar o período de referência associado ao faturamento
vencTextos.cAdVenctexto · até 1Adicionar o vencimento da parcela à descrição dos serviços na NFS-e
vencTextos.cAntecipartexto · até 1Define se deve antecipar o vencimento ao considerar apenas dias úteis
vencTextos.cCodPerReftexto · até 3Período de Referência - Código do período de referência para o faturamento. Pode ser: 001 Mês do faturamento 002 Mês Anterior ao faturamento 003 Mês Posterior ao faturamento 004 Período Anterior ao faturamento 005 Período Posterior ao faturamento 006 Período Anterior específico 007 Número da Parcela 008 Período Posterior específico 009 Período Atual específico
vencTextos.cDiaFimtexto · até 2Dia Final - Dia para a data final do período de referência associado ao faturamento
vencTextos.cDiaInitexto · até 2Dia Inicial - Dia para a data inicial do período de referência associado ao faturamentDia Inicial
vencTextos.cPostergartexto · até 1Postergar Sábados, Domingos e Feriados Nacionais
vencTextos.cProxMestexto · até 1Define se o vencimento ocorrerá somente no mês seguinte.
vencTextos.cTpVenctexto · até 3Tipo de Vencimento. Pode ser: 001-Número de dias após faturar. 002-Fixar dia do mês (1 a 31).
vencTextos.nDiaFixonúmero inteiroDia de vencimento fixo para a gerar o contas a receber
vencTextos.nDiasnúmero inteiroNúmero de Dias para a gerar o contas a receber
Retorno 4O que volta numa chamada bem-sucedida
CampoTipoDescrição
cCodIntCtrtextoCódigo de Integração do Contrato de Serviço
cCodStatustextoCódigo do Status
cDescStatustextoDescrição do Status
nCodCtrnúmero inteiroCódigo da Contrato de Serviço
POST /api/v1/servicos/contrato/
curl -s https://app.omie.com.br/api/v1/servicos/contrato/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "UpsertContrato", "param": [{"cabecalho": {"cCodIntCtr": "019289Tb2", "cCodSit": "10", "cNumCtr": "2020/01001", "cTipoFat": "01", "dVigFinal": "30/03/2022", "dVigInicial": "29/03/2020", "nCodCli": 2370765, "nDiaFat": 30, "nValTotMes": 3302}, "departamentos": [], "emailCliente": {"cEnviarBoleto": "", "cEnviarLinkNfse": "", "cEnviarRecibo": "", "cUtilizarEmails": ""}, "infAdic": {"cCidPrestServ": "PETROPOLIS (RJ)", "cCodART": "", "cCodCateg": "1.01.02", "cCodObra": "", "cContato": "", "cDadosAdicNF": "", "nCodCC": 1208238, "nCodProj": 0, "nCodVend": 0}, "itensContrato": [{"itemCabecalho": {"codIntItem": "1", "cCodCategItem": "", "cNaoGerarFinanceiro": "N", "codLC116": "3.05", "codNBS": "", "codServMunic": "01292", "codServico": 0, "natOperacao": "01", "quant": 1, "seq": 1, "valorDed": 0, "valorTotal": 3002, "valorUnit": 3002}, "itemDescrServ": {"descrCompleta": "Serviços prestados"}, "itemImpostos": {"aliqCOFINS": 0, "aliqCSLL": 0, "aliqINSS": 0, "aliqIR": 0, "aliqISS": 5, "aliqPIS": 0, "redBaseINSS": 0, "retCOFINS": "", "retCSLL": "", "retINSS": "", "retIR": "", "retISS": "N", "retPIS": "", "valorCOFINS": 0, "valorCSLL": 0, "valorINSS": 0, "valorIR": 0, "valorISS": 150.1, "valorPIS": 0}, "itemLeiTranspImp": {"aliMunicipal": 0, "aliqEstadual": 0, "aliqFederal": 0, "chave": "", "fonte": ""}}, {"itemCabecalho": {"codIntItem": "2", "cCodCategItem": "", "cNaoGerarFinanceiro": "N", "codLC116": "17.01", "codNBS": "", "codServMunic": "0162-8/99", "codServico": 3412648, "natOperacao": "01", "quant": 1, "seq": 2, "valorDed": 0, "valorTotal": 300, "valorUnit": 300}, "itemDescrServ": {"descrCompleta": "Homologação de processo contábil"}, "itemImpostos": {"aliqCOFINS": 0, "aliqCSLL": 0, "aliqINSS": 0, "aliqIR": 0, "aliqISS": 3, "aliqPIS": 0, "redBaseINSS": 0, "retCOFINS": "", "retCSLL": "", "retINSS": "", "retIR": "", "retISS": "N", "retPIS": "", "valorCOFINS": 0, "valorCSLL": 0, "valorINSS": 0, "valorIR": 0, "valorISS": 9, "valorPIS": 0}, "itemLeiTranspImp": {"aliMunicipal": 0, "aliqEstadual": 0, "aliqFederal": 0, "chave": "", "fonte": ""}}], "observacoes": {"cObsContrato": ""}, "vencTextos": {"cAdContrato": "N", "cAdPeriodo": "N", "cAdVenc": " ", "cAntecipar": "", "cCodPerRef": "001", "cDiaFim": 0, "cDiaIni": 0, "cPostergar": "", "cProxMes": "", "cTpVenc": "001", "nDiaFixo": 0, "nDias": 5}}]}'