Serviços · OrdemServicoResumo

API Resumida de Ordem de serviço

POSThttps://app.omie.com.br/api/v1/servicos/ordemservico/WSDL

0consultas

2alterações

Claude · MCPpelos assistentes de IA

JSON · XMLformato

AdicionarItemOs

altera dadosClaudeMCP

Solicitação de inclusão de item para a OS.

Obrigatórios 2

Campo	Tipo	Descrição
`nCodServico`	número inteiro	Código interno do serviço conforme cadastrado na tabela de serviços. Obrigatório. Possível identificar através do método: https://app.omie.com.br/api/v1/geral/servicos/#ListarServicos Acessando a tag "nCodServ" dentro do objeto "cabec".
`nValUnit`	número	Valor unitário do serviço. Obrigatório e maior que zero.

Opcionais 12Campos e estruturas que você pode enviar

Campo	Tipo	Descrição
`cCodCateg`	texto · até 20	Código da Categoria.
`cCodIntOS`	texto · até 60	Código de integração da ordem de serviço. Informe nCodOS, cCodIntOS ou cNumOS.
`cNaoGerarFinanceiro`	texto · até 1	Não gerar conta a receber para este item. Informar "S" para não gerar movimento financeiro. Informar "N" para gerar movimento financeiro.
`cNumOS`	texto · até 15	Número da ordem de serviço. Conforme visualizado na tela pelo cliente.
`cRetemISS`	texto · até 1	Retém ISS (S/N).
`cTpDesconto`	texto · até 1	Pode ser: P - Percentual V - Valor
`cTribServ`	texto · até 2	Tipo de tributação do serviço. Possível identificar através do método: https://app.omie.com.br/api/v1/servicos/tipotrib/#ListarTiposTrib Acessando a tag "cIdTrib".
`nAliqDesconto`	número	Alíquota do desconto.
`nAliqISS`	número	Alíquota de ISS do item.
`nCodOS`	número inteiro	Código da ordem de serviço. Informe nCodOS, cCodIntOS ou cNumOS.
`nQtde`	número	Quantidade de serviços. Padrão 1; precisa ser maior que zero.
`nValorDesconto`	número	Valor do desconto.

Retorno 5O que volta numa chamada bem-sucedida

Campo	Tipo	Descrição
`cCodStatus`	texto	Código de Status
`cDesStatus`	texto	Descrição do Status
`cNumOS`	texto	Número da ordem de serviço.
`nCodItem`	número inteiro	Código do item criado na ordem de serviço.
`nCodOS`	número inteiro	Código da ordem de serviço.

POST /api/v1/servicos/ordemservico/

curl -s https://app.omie.com.br/api/v1/servicos/ordemservico/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "AdicionarItemOs", "param": [{"nCodOS": 0, "cCodIntOS": "", "cNumOS": "", "nCodServico": 0, "nQtde": 1, "nValUnit": 25, "cTpDesconto": "V", "nValorDesconto": 0, "nAliqDesconto": 0, "nAliqISS": 5, "cRetemISS": "S", "cTribServ": "01", "cCodCateg": "1.01.02", "cNaoGerarFinanceiro": "N"}]}'

import os
import requests

corpo = {'call': 'AdicionarItemOs',
 'param': [{'nCodOS': 0,
            'cCodIntOS': '',
            'cNumOS': '',
            'nCodServico': 0,
            'nQtde': 1,
            'nValUnit': 25,
            'cTpDesconto': 'V',
            'nValorDesconto': 0,
            'nAliqDesconto': 0,
            'nAliqISS': 5,
            'cRetemISS': 'S',
            'cTribServ': '01',
            'cCodCateg': '1.01.02',
            'cNaoGerarFinanceiro': 'N'}]}

resp = requests.post(
    "https://app.omie.com.br/api/v1/servicos/ordemservico/",
    headers={"Authorization": f"Bearer {os.environ['TOKEN_DO_APLICATIVO']}"},
    json=corpo,
    timeout=60,
)
print(resp.json())

const resp = await fetch("https://app.omie.com.br/api/v1/servicos/ordemservico/", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "call": "AdicionarItemOs",
    "param": [
      {
        "nCodOS": 0,
        "cCodIntOS": "",
        "cNumOS": "",
        "nCodServico": 0,
        "nQtde": 1,
        "nValUnit": 25,
        "cTpDesconto": "V",
        "nValorDesconto": 0,
        "nAliqDesconto": 0,
        "nAliqISS": 5,
        "cRetemISS": "S",
        "cTribServ": "01",
        "cCodCateg": "1.01.02",
        "cNaoGerarFinanceiro": "N"
      }
    ]
  }),
});
console.log(await resp.json());

<?php
$ch = curl_init("https://app.omie.com.br/api/v1/servicos/ordemservico/");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("TOKEN_DO_APLICATIVO"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
    "call": "AdicionarItemOs",
    "param": [
        {
            "nCodOS": 0,
            "cCodIntOS": "",
            "cNumOS": "",
            "nCodServico": 0,
            "nQtde": 1,
            "nValUnit": 25,
            "cTpDesconto": "V",
            "nValorDesconto": 0,
            "nAliqDesconto": 0,
            "nAliqISS": 5,
            "cRetemISS": "S",
            "cTribServ": "01",
            "cCodCateg": "1.01.02",
            "cNaoGerarFinanceiro": "N"
        }
    ]
}
JSON,
]);
echo curl_exec($ch);

require "net/http"

uri = URI("https://app.omie.com.br/api/v1/servicos/ordemservico/")
corpo = <<~'JSON'
{
  "call": "AdicionarItemOs",
  "param": [
    {
      "nCodOS": 0,
      "cCodIntOS": "",
      "cNumOS": "",
      "nCodServico": 0,
      "nQtde": 1,
      "nValUnit": 25,
      "cTpDesconto": "V",
      "nValorDesconto": 0,
      "nAliqDesconto": 0,
      "nAliqISS": 5,
      "cRetemISS": "S",
      "cTribServ": "01",
      "cCodCateg": "1.01.02",
      "cNaoGerarFinanceiro": "N"
    }
  ]
}
JSON

resp = Net::HTTP.post(uri, corpo,
  "Authorization" => "Bearer #{ENV.fetch('TOKEN_DO_APLICATIVO')}",
  "Content-Type" => "application/json")
puts resp.body

import java.net.URI;
import java.net.http.*;

var corpo = """
{
  "call": "AdicionarItemOs",
  "param": [
    {
      "nCodOS": 0,
      "cCodIntOS": "",
      "cNumOS": "",
      "nCodServico": 0,
      "nQtde": 1,
      "nValUnit": 25,
      "cTpDesconto": "V",
      "nValorDesconto": 0,
      "nAliqDesconto": 0,
      "nAliqISS": 5,
      "cRetemISS": "S",
      "cTribServ": "01",
      "cCodCateg": "1.01.02",
      "cNaoGerarFinanceiro": "N"
    }
  ]
}
""";

var pedido = HttpRequest.newBuilder()
    .uri(URI.create("https://app.omie.com.br/api/v1/servicos/ordemservico/"))
    .header("Authorization", "Bearer " + System.getenv("TOKEN_DO_APLICATIVO"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(corpo))
    .build();
var resp = HttpClient.newHttpClient().send(pedido, HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

// TokenDoAplicativo: parâmetro do Power BI (Página Inicial > Gerenciar parâmetros)
let
    Resposta = Web.Contents(
        "https://app.omie.com.br/api/v1/servicos/ordemservico/",
        [
            Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
            Content = Text.ToBinary("{""call"": ""AdicionarItemOs"", ""param"": [{""nCodOS"": 0, ""cCodIntOS"": """", ""cNumOS"": """", ""nCodServico"": 0, ""nQtde"": 1, ""nValUnit"": 25, ""cTpDesconto"": ""V"", ""nValorDesconto"": 0, ""nAliqDesconto"": 0, ""nAliqISS"": 5, ""cRetemISS"": ""S"", ""cTribServ"": ""01"", ""cCodCateg"": ""1.01.02"", ""cNaoGerarFinanceiro"": ""N""}]}")
        ]
    ),
    Dados = Json.Document(Resposta)
in
    Dados

AdicionarOs

altera dadosClaudeMCP

Solicitação de inclusão de OS resumida.

Obrigatórios 3

Campo	Tipo	Descrição
`cCidPrestServ`	texto · até 40	Cidade da prestação do serviço, no formato "CIDADE (UF)". Obrigatório. É validada no cadastro de cidades.
`cCodCateg`	texto · até 20	Código da categoria de receita da OS. Obrigatório.
`nCodCC`	número inteiro	Código da conta corrente da OS. Obrigatório. Para enviar PIX (cEnvPix "S"), a conta precisa ter PIX habilitado.

Opcionais 21Campos e estruturas que você pode enviar

Campo	Tipo	Descrição
`ServicosPrestados`	lista de objetos	Serviços prestados. Obrigatório, com ao menos um item.
`ServicosPrestados[].cCodCategItem`	texto · até 20	Código da Categoria.
`ServicosPrestados[].cCodServLC116`	texto · até 20	Código do serviço conforme Lei Complementar (LC 116).
`ServicosPrestados[].cCodServMun`	texto · até 20	Código do serviço municipal ou CNAE. 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.
`ServicosPrestados[].cNaoGerarFinanceiro`	texto · até 1	Não gerar conta a receber para este item. Informar "S" para não gerar movimento financeiro. Informar "N" para gerar movimento financeiro.
`ServicosPrestados[].cTpDesconto`	texto · até 1	Pode ser: P - Percentual V - Valor
`ServicosPrestados[].cTribServ`	texto · até 2	Tipo de tributação do serviço. Possível identificar através do método: https://app.omie.com.br/api/v1/servicos/tipotrib/#ListarTiposTrib Acessando a tag "cIdTrib".
`ServicosPrestados[].impostos`	objeto	Impostos do item.
`ServicosPrestados[].impostos.cCST`	texto · até 3	Có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.
`ServicosPrestados[].impostos.cClassTrib`	texto · até 6	Có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.
`ServicosPrestados[].impostos.cDeduzISS`	texto · até 1	Deduz o ISS da base de cálculo de PIS e COFINS (S/N).
`ServicosPrestados[].impostos.cIndOPer`	texto · até 6	Có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.
`ServicosPrestados[].impostos.cRetemCOFINS`	texto · até 1	Retém COFINS (S/N). Padrão é "N". Indica se o imposto deve ser retido ou não.
`ServicosPrestados[].impostos.cRetemCSLL`	texto · até 1	Retém CSLL (S/N). Padrão é "N". Indica se o imposto deve ser retido ou não.
`ServicosPrestados[].impostos.cRetemINSS`	texto · até 1	Retém INSS (S/N). Padrão é "N". Indica se o imposto deve ser retido ou não.
`ServicosPrestados[].impostos.cRetemIRRF`	texto · até 1	Retém IRRF (S/N). Padrão é "N". Indica se o imposto deve ser retido ou não.
`ServicosPrestados[].impostos.cRetemISS`	texto · até 1	Retém ISS (S/N). Padrão é "N". Indica se o imposto deve ser retido ou não.
`ServicosPrestados[].impostos.cRetemPIS`	texto · até 1	Retém PIS (S/N). Padrão é "N". Indica se o imposto deve ser retido ou não.
`ServicosPrestados[].impostos.cUtilizaValorImposto`	texto · até 1	Aceita S/N, mas hoje não tem efeito nesta operação: PIS, COFINS, CSLL, IR e INSS são sempre calculados a partir da alíquota, e os valores informados desses impostos são ignorados.
`ServicosPrestados[].impostos.nAliqCOFINS`	número	Alíquota de COFINS. Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
`ServicosPrestados[].impostos.nAliqCSLL`	número	Alíquota de CSLL. Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
`ServicosPrestados[].impostos.nAliqCbs`	número	Alíquota do 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.
`ServicosPrestados[].impostos.nAliqINSS`	número	Alíquota de INSS. Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
`ServicosPrestados[].impostos.nAliqIRRF`	número	Alíquota de IRRF. Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
`ServicosPrestados[].impostos.nAliqISS`	número	Alíquota de ISS.
`ServicosPrestados[].impostos.nAliqIbsMun`	número	Alí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.
`ServicosPrestados[].impostos.nAliqIbsUf`	número	Alí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.
`ServicosPrestados[].impostos.nAliqPIS`	número	Alíquota de PIS. Lembre-se também de indicar se o imposto deve ser retido ou não na tag correspondente.
`ServicosPrestados[].impostos.nAliqRedBaseCOFINS`	número	Percentual de redução da base de cálculo do COFINS.
`ServicosPrestados[].impostos.nAliqRedBaseINSS`	número	Percentual de dedução da base de cálculo do INSS.
`ServicosPrestados[].impostos.nAliqRedBasePIS`	número	Percentual de redução da base de cálculo do PIS.
`ServicosPrestados[].impostos.nBaseCalcIbsCbs`	número	Valor da Base de Calculo do IBS e CBS.
`ServicosPrestados[].impostos.nPercReducaoCbs`	número	Percentual 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.
`ServicosPrestados[].impostos.nPercReducaoIbsMun`	número	Percentual 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.
`ServicosPrestados[].impostos.nPercReducaoIbsUf`	número	Percentual 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.
`ServicosPrestados[].impostos.nValorCOFINS`	número	Valor do COFINS. Ignorado nesta operação: o Omie calcula o valor pela alíquota informada.
`ServicosPrestados[].impostos.nValorCSLL`	número	Valor de CSLL. Ignorado nesta operação: o Omie calcula o valor pela alíquota informada.
`ServicosPrestados[].impostos.nValorDeducao`	número	Valor de dedução. Por padrão, esse campo afeta a base de cálculo do ISS. Para atender a condições legais acordadas para cada munícipio pode afetar as Bases de Cálculos dos Impostos Federais também. Consulte a legislação do seu município.
`ServicosPrestados[].impostos.nValorDeducaoIRRF`	número	Valor da dedução do IR.
`ServicosPrestados[].impostos.nValorINSS`	número	Valor de INSS. Ignorado nesta operação: o Omie calcula o valor pela alíquota informada.
`ServicosPrestados[].impostos.nValorIRRF`	número	Valor do IRRF. Ignorado nesta operação: o Omie calcula o valor pela alíquota informada.
`ServicosPrestados[].impostos.nValorISS`	número	Valor do ISS. Se informado, é gravado como valor do ISS do item; senão, o Omie calcula pela alíquota.
`ServicosPrestados[].impostos.nValorPIS`	número	Valor do PIS. Ignorado nesta operação: o Omie calcula o valor pela alíquota informada.
`ServicosPrestados[].nAliqDesconto`	número	Alíquota do desconto.
`ServicosPrestados[].nCodServico`obrigatório	texto · até 20	Código interno do serviço conforme cadastrado na tabela de serviços. Obrigatório. Possível identificar através do método: https://app.omie.com.br/api/v1/geral/servicos/#ListarServicos Acessando a tag "nCodServ" dentro do objeto "cabec".
`ServicosPrestados[].nQtde`	número	Quantidade de serviços. Padrão 1; precisa ser maior que zero.
`ServicosPrestados[].nValUnit`obrigatório	número	Valor unitário do serviço. Obrigatório e maior que zero.
`ServicosPrestados[].nValorAcrescimos`	número	Valor de acréscimos e taxas. Disponível apenas para cidades que oferecem esse recurso.
`ServicosPrestados[].nValorDesconto`	número	Valor do desconto.
`ServicosPrestados[].nValorOutrasRetencoes`	número	Valor de outras retenções. Disponível apenas para cidades que oferecem esse recurso.
`cCnpjCpf`	texto · até 20	CNPJ ou CPF do cliente. Obrigatório caso não enviar [nIdCliente]. O documento é validado e o cliente precisa já estar cadastrado (esta operação não cadastra cliente).
`cCodART`	texto · até 20	Código da ART (Anotação de Responsabilidade Técnica).
`cCodObra`	texto · até 15	Código da obra (construção civil).
`cCodParc`	texto · até 3	Código da condição de pagamento (parcelas). Padrão 999. Utilize o método "ListarParcelas" da API /api/v1/geral/parcelas/ para obter os códigos.
`cDadosAdicNF`	texto	Dados adicionais para a NFS-e. Use \| (pipe) como separador de linhas.
`cEnvBoleto`	texto · até 1	Enviar boleto por e-mail (S/N). Não pode ser "S" junto com cEnvPix.
`cEnvLink`	texto · até 1	Enviar o link da NFS-e por e-mail (S/N).
`cEnvPix`	texto · até 1	Enviar PIX por e-mail (S/N). Exige conta corrente com PIX; não pode ser "S" junto com cEnvBoleto.
`cEnvRecibo`	texto · até 1	Enviar recibo (S/N). Padrão N.
`cEnvViaUnica`	texto · até 1	Enviar via única (S/N). Padrão N.
`cEnviarPara`	texto	E-mails para onde a NFS-e e os anexos serão enviados quando a OS for faturada.
`cEtapa`	texto · até 2	Etapa da OS: 00, 10, 20, 30, 40 ou 50. Padrão 10. Só posiciona a OS; esta operação não fatura.
`cObservacao`	texto	Observações internas da OS. Use \| (pipe) como separador de linhas.
`cOrigem`	texto · até 3	Indica qual a origem da ordem de serviço. Default: API - Importado via API
`cUsoConsumo`	texto · até 1	Uso ou consumo pessoal (S/N), para a Reforma Tributária. Padrão N.
`dDataCompetencia`	texto · até 10	Data de competência da NFS-e (dd/mm/aaaa). Não pode ser anterior a 365 dias atrás.
`dDataPrevisao`	texto · até 10	Data de previsão (dd/mm/aaaa). Padrão hoje. Não pode ser anterior a 365 dias atrás.
`nCodVend`	número inteiro	Código do vendedor.
`nIdCliente`	número inteiro	Código do cliente. Obrigatório envio caso não enviar [cCnpjCpf].
`nIdDestinatario`	número inteiro	Código do cliente destinatário, quando diferente do tomador (Reforma Tributária).

Retorno 4O que volta numa chamada bem-sucedida

Campo	Tipo	Descrição
`cCodStatus`	texto	Código de Status
`cDesStatus`	texto	Descrição do Status
`cNumOS`	texto	Número da ordem de serviço gerada.
`nCodOS`	número inteiro	Código da ordem de serviço gerada.

POST /api/v1/servicos/ordemservico/

curl -s https://app.omie.com.br/api/v1/servicos/ordemservico/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "AdicionarOs", "param": [{"nCodCC": 0, "nIdCliente": 0, "nCodVend": 0, "cCnpjCpf": "455.763.860-00", "cCodParc": "000", "cCodCateg": "1.01.02", "cCidPrestServ": "BELO HORIZONTE (MG)", "cEtapa": "50", "cCodObra": "", "cCodART": "", "cDadosAdicNF": "OS da proposta 60895665", "cEnviarPara": "nfse.marketplace@mercantil.com.br", "cEnvLink": "N", "cEnvBoleto": "N", "cEnvPix": "N", "cEnvViaUnica": "N", "cEnvRecibo": "N", "dDataPrevisao": "23/09/2026", "dDataCompetencia": "23/09/2026", "cOrigem": "", "cObservacao": "", "ServicosPrestados": [{"nCodServico": 0, "nQtde": 1, "nValUnit": 25, "cTpDesconto": "V", "nValorDesconto": 5, "nAliqDesconto": 0, "nValorOutrasRetencoes": 0, "nValorAcrescimos": 0, "cTribServ": "01", "cCodCategItem": "1.01.02", "cCodServLC116": "1.04", "cCodServMun": "", "cNaoGerarFinanceiro": "N", "impostos": {"nValorDeducao": 0, "cUtilizaValorImposto": "N", "cDeduzISS": "N", "cRetemISS": "N", "nAliqISS": 0, "nValorISS": 0, "cRetemCSLL": "N", "nAliqCSLL": 0, "nValorCSLL": 0, "cRetemIRRF": "N", "nAliqIRRF": 0, "nValorIRRF": 0, "nValorDeducaoIRRF": 0, "cRetemINSS": "N", "nAliqINSS": 0, "nValorINSS": 0, "nAliqRedBaseINSS": 0, "cRetemPIS": "N", "nAliqPIS": 0, "nValorPIS": 0, "nAliqRedBasePIS": 0, "cRetemCOFINS": "N", "nAliqCOFINS": 0, "nValorCOFINS": 0, "nAliqRedBaseCOFINS": 0}}]}]}'

import os
import requests

corpo = {'call': 'AdicionarOs',
 'param': [{'nCodCC': 0,
            'nIdCliente': 0,
            'nCodVend': 0,
            'cCnpjCpf': '455.763.860-00',
            'cCodParc': '000',
            'cCodCateg': '1.01.02',
            'cCidPrestServ': 'BELO HORIZONTE (MG)',
            'cEtapa': '50',
            'cCodObra': '',
            'cCodART': '',
            'cDadosAdicNF': 'OS da proposta 60895665',
            'cEnviarPara': 'nfse.marketplace@mercantil.com.br',
            'cEnvLink': 'N',
            'cEnvBoleto': 'N',
            'cEnvPix': 'N',
            'cEnvViaUnica': 'N',
            'cEnvRecibo': 'N',
            'dDataPrevisao': '23/09/2026',
            'dDataCompetencia': '23/09/2026',
            'cOrigem': '',
            'cObservacao': '',
            'ServicosPrestados': [{'nCodServico': 0,
                                   'nQtde': 1,
                                   'nValUnit': 25,
                                   'cTpDesconto': 'V',
                                   'nValorDesconto': 5,
                                   'nAliqDesconto': 0,
                                   'nValorOutrasRetencoes': 0,
                                   'nValorAcrescimos': 0,
                                   'cTribServ': '01',
                                   'cCodCategItem': '1.01.02',
                                   'cCodServLC116': '1.04',
                                   'cCodServMun': '',
                                   'cNaoGerarFinanceiro': 'N',
                                   'impostos': {'nValorDeducao': 0,
                                                'cUtilizaValorImposto': 'N',
                                                'cDeduzISS': 'N',
                                                'cRetemISS': 'N',
                                                'nAliqISS': 0,
                                                'nValorISS': 0,
                                                'cRetemCSLL': 'N',
                                                'nAliqCSLL': 0,
                                                'nValorCSLL': 0,
                                                'cRetemIRRF': 'N',
                                                'nAliqIRRF': 0,
                                                'nValorIRRF': 0,
                                                'nValorDeducaoIRRF': 0,
                                                'cRetemINSS': 'N',
                                                'nAliqINSS': 0,
                                                'nValorINSS': 0,
                                                'nAliqRedBaseINSS': 0,
                                                'cRetemPIS': 'N',
                                                'nAliqPIS': 0,
                                                'nValorPIS': 0,
                                                'nAliqRedBasePIS': 0,
                                                'cRetemCOFINS': 'N',
                                                'nAliqCOFINS': 0,
                                                'nValorCOFINS': 0,
                                                'nAliqRedBaseCOFINS': 0}}]}]}

resp = requests.post(
    "https://app.omie.com.br/api/v1/servicos/ordemservico/",
    headers={"Authorization": f"Bearer {os.environ['TOKEN_DO_APLICATIVO']}"},
    json=corpo,
    timeout=60,
)
print(resp.json())

const resp = await fetch("https://app.omie.com.br/api/v1/servicos/ordemservico/", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "call": "AdicionarOs",
    "param": [
      {
        "nCodCC": 0,
        "nIdCliente": 0,
        "nCodVend": 0,
        "cCnpjCpf": "455.763.860-00",
        "cCodParc": "000",
        "cCodCateg": "1.01.02",
        "cCidPrestServ": "BELO HORIZONTE (MG)",
        "cEtapa": "50",
        "cCodObra": "",
        "cCodART": "",
        "cDadosAdicNF": "OS da proposta 60895665",
        "cEnviarPara": "nfse.marketplace@mercantil.com.br",
        "cEnvLink": "N",
        "cEnvBoleto": "N",
        "cEnvPix": "N",
        "cEnvViaUnica": "N",
        "cEnvRecibo": "N",
        "dDataPrevisao": "23/09/2026",
        "dDataCompetencia": "23/09/2026",
        "cOrigem": "",
        "cObservacao": "",
        "ServicosPrestados": [
          {
            "nCodServico": 0,
            "nQtde": 1,
            "nValUnit": 25,
            "cTpDesconto": "V",
            "nValorDesconto": 5,
            "nAliqDesconto": 0,
            "nValorOutrasRetencoes": 0,
            "nValorAcrescimos": 0,
            "cTribServ": "01",
            "cCodCategItem": "1.01.02",
            "cCodServLC116": "1.04",
            "cCodServMun": "",
            "cNaoGerarFinanceiro": "N",
            "impostos": {
              "nValorDeducao": 0,
              "cUtilizaValorImposto": "N",
              "cDeduzISS": "N",
              "cRetemISS": "N",
              "nAliqISS": 0,
              "nValorISS": 0,
              "cRetemCSLL": "N",
              "nAliqCSLL": 0,
              "nValorCSLL": 0,
              "cRetemIRRF": "N",
              "nAliqIRRF": 0,
              "nValorIRRF": 0,
              "nValorDeducaoIRRF": 0,
              "cRetemINSS": "N",
              "nAliqINSS": 0,
              "nValorINSS": 0,
              "nAliqRedBaseINSS": 0,
              "cRetemPIS": "N",
              "nAliqPIS": 0,
              "nValorPIS": 0,
              "nAliqRedBasePIS": 0,
              "cRetemCOFINS": "N",
              "nAliqCOFINS": 0,
              "nValorCOFINS": 0,
              "nAliqRedBaseCOFINS": 0
            }
          }
        ]
      }
    ]
  }),
});
console.log(await resp.json());

<?php
$ch = curl_init("https://app.omie.com.br/api/v1/servicos/ordemservico/");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("TOKEN_DO_APLICATIVO"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
    "call": "AdicionarOs",
    "param": [
        {
            "nCodCC": 0,
            "nIdCliente": 0,
            "nCodVend": 0,
            "cCnpjCpf": "455.763.860-00",
            "cCodParc": "000",
            "cCodCateg": "1.01.02",
            "cCidPrestServ": "BELO HORIZONTE (MG)",
            "cEtapa": "50",
            "cCodObra": "",
            "cCodART": "",
            "cDadosAdicNF": "OS da proposta 60895665",
            "cEnviarPara": "nfse.marketplace@mercantil.com.br",
            "cEnvLink": "N",
            "cEnvBoleto": "N",
            "cEnvPix": "N",
            "cEnvViaUnica": "N",
            "cEnvRecibo": "N",
            "dDataPrevisao": "23/09/2026",
            "dDataCompetencia": "23/09/2026",
            "cOrigem": "",
            "cObservacao": "",
            "ServicosPrestados": [
                {
                    "nCodServico": 0,
                    "nQtde": 1,
                    "nValUnit": 25,
                    "cTpDesconto": "V",
                    "nValorDesconto": 5,
                    "nAliqDesconto": 0,
                    "nValorOutrasRetencoes": 0,
                    "nValorAcrescimos": 0,
                    "cTribServ": "01",
                    "cCodCategItem": "1.01.02",
                    "cCodServLC116": "1.04",
                    "cCodServMun": "",
                    "cNaoGerarFinanceiro": "N",
                    "impostos": {
                        "nValorDeducao": 0,
                        "cUtilizaValorImposto": "N",
                        "cDeduzISS": "N",
                        "cRetemISS": "N",
                        "nAliqISS": 0,
                        "nValorISS": 0,
                        "cRetemCSLL": "N",
                        "nAliqCSLL": 0,
                        "nValorCSLL": 0,
                        "cRetemIRRF": "N",
                        "nAliqIRRF": 0,
                        "nValorIRRF": 0,
                        "nValorDeducaoIRRF": 0,
                        "cRetemINSS": "N",
                        "nAliqINSS": 0,
                        "nValorINSS": 0,
                        "nAliqRedBaseINSS": 0,
                        "cRetemPIS": "N",
                        "nAliqPIS": 0,
                        "nValorPIS": 0,
                        "nAliqRedBasePIS": 0,
                        "cRetemCOFINS": "N",
                        "nAliqCOFINS": 0,
                        "nValorCOFINS": 0,
                        "nAliqRedBaseCOFINS": 0
                    }
                }
            ]
        }
    ]
}
JSON,
]);
echo curl_exec($ch);

require "net/http"

uri = URI("https://app.omie.com.br/api/v1/servicos/ordemservico/")
corpo = <<~'JSON'
{
  "call": "AdicionarOs",
  "param": [
    {
      "nCodCC": 0,
      "nIdCliente": 0,
      "nCodVend": 0,
      "cCnpjCpf": "455.763.860-00",
      "cCodParc": "000",
      "cCodCateg": "1.01.02",
      "cCidPrestServ": "BELO HORIZONTE (MG)",
      "cEtapa": "50",
      "cCodObra": "",
      "cCodART": "",
      "cDadosAdicNF": "OS da proposta 60895665",
      "cEnviarPara": "nfse.marketplace@mercantil.com.br",
      "cEnvLink": "N",
      "cEnvBoleto": "N",
      "cEnvPix": "N",
      "cEnvViaUnica": "N",
      "cEnvRecibo": "N",
      "dDataPrevisao": "23/09/2026",
      "dDataCompetencia": "23/09/2026",
      "cOrigem": "",
      "cObservacao": "",
      "ServicosPrestados": [
        {
          "nCodServico": 0,
          "nQtde": 1,
          "nValUnit": 25,
          "cTpDesconto": "V",
          "nValorDesconto": 5,
          "nAliqDesconto": 0,
          "nValorOutrasRetencoes": 0,
          "nValorAcrescimos": 0,
          "cTribServ": "01",
          "cCodCategItem": "1.01.02",
          "cCodServLC116": "1.04",
          "cCodServMun": "",
          "cNaoGerarFinanceiro": "N",
          "impostos": {
            "nValorDeducao": 0,
            "cUtilizaValorImposto": "N",
            "cDeduzISS": "N",
            "cRetemISS": "N",
            "nAliqISS": 0,
            "nValorISS": 0,
            "cRetemCSLL": "N",
            "nAliqCSLL": 0,
            "nValorCSLL": 0,
            "cRetemIRRF": "N",
            "nAliqIRRF": 0,
            "nValorIRRF": 0,
            "nValorDeducaoIRRF": 0,
            "cRetemINSS": "N",
            "nAliqINSS": 0,
            "nValorINSS": 0,
            "nAliqRedBaseINSS": 0,
            "cRetemPIS": "N",
            "nAliqPIS": 0,
            "nValorPIS": 0,
            "nAliqRedBasePIS": 0,
            "cRetemCOFINS": "N",
            "nAliqCOFINS": 0,
            "nValorCOFINS": 0,
            "nAliqRedBaseCOFINS": 0
          }
        }
      ]
    }
  ]
}
JSON

resp = Net::HTTP.post(uri, corpo,
  "Authorization" => "Bearer #{ENV.fetch('TOKEN_DO_APLICATIVO')}",
  "Content-Type" => "application/json")
puts resp.body

import java.net.URI;
import java.net.http.*;

var corpo = """
{
  "call": "AdicionarOs",
  "param": [
    {
      "nCodCC": 0,
      "nIdCliente": 0,
      "nCodVend": 0,
      "cCnpjCpf": "455.763.860-00",
      "cCodParc": "000",
      "cCodCateg": "1.01.02",
      "cCidPrestServ": "BELO HORIZONTE (MG)",
      "cEtapa": "50",
      "cCodObra": "",
      "cCodART": "",
      "cDadosAdicNF": "OS da proposta 60895665",
      "cEnviarPara": "nfse.marketplace@mercantil.com.br",
      "cEnvLink": "N",
      "cEnvBoleto": "N",
      "cEnvPix": "N",
      "cEnvViaUnica": "N",
      "cEnvRecibo": "N",
      "dDataPrevisao": "23/09/2026",
      "dDataCompetencia": "23/09/2026",
      "cOrigem": "",
      "cObservacao": "",
      "ServicosPrestados": [
        {
          "nCodServico": 0,
          "nQtde": 1,
          "nValUnit": 25,
          "cTpDesconto": "V",
          "nValorDesconto": 5,
          "nAliqDesconto": 0,
          "nValorOutrasRetencoes": 0,
          "nValorAcrescimos": 0,
          "cTribServ": "01",
          "cCodCategItem": "1.01.02",
          "cCodServLC116": "1.04",
          "cCodServMun": "",
          "cNaoGerarFinanceiro": "N",
          "impostos": {
            "nValorDeducao": 0,
            "cUtilizaValorImposto": "N",
            "cDeduzISS": "N",
            "cRetemISS": "N",
            "nAliqISS": 0,
            "nValorISS": 0,
            "cRetemCSLL": "N",
            "nAliqCSLL": 0,
            "nValorCSLL": 0,
            "cRetemIRRF": "N",
            "nAliqIRRF": 0,
            "nValorIRRF": 0,
            "nValorDeducaoIRRF": 0,
            "cRetemINSS": "N",
            "nAliqINSS": 0,
            "nValorINSS": 0,
            "nAliqRedBaseINSS": 0,
            "cRetemPIS": "N",
            "nAliqPIS": 0,
            "nValorPIS": 0,
            "nAliqRedBasePIS": 0,
            "cRetemCOFINS": "N",
            "nAliqCOFINS": 0,
            "nValorCOFINS": 0,
            "nAliqRedBaseCOFINS": 0
          }
        }
      ]
    }
  ]
}
""";

var pedido = HttpRequest.newBuilder()
    .uri(URI.create("https://app.omie.com.br/api/v1/servicos/ordemservico/"))
    .header("Authorization", "Bearer " + System.getenv("TOKEN_DO_APLICATIVO"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(corpo))
    .build();
var resp = HttpClient.newHttpClient().send(pedido, HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

// TokenDoAplicativo: parâmetro do Power BI (Página Inicial > Gerenciar parâmetros)
let
    Resposta = Web.Contents(
        "https://app.omie.com.br/api/v1/servicos/ordemservico/",
        [
            Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
            Content = Text.ToBinary("{""call"": ""AdicionarOs"", ""param"": [{""nCodCC"": 0, ""nIdCliente"": 0, ""nCodVend"": 0, ""cCnpjCpf"": ""455.763.860-00"", ""cCodParc"": ""000"", ""cCodCateg"": ""1.01.02"", ""cCidPrestServ"": ""BELO HORIZONTE (MG)"", ""cEtapa"": ""50"", ""cCodObra"": """", ""cCodART"": """", ""cDadosAdicNF"": ""OS da proposta 60895665"", ""cEnviarPara"": ""nfse.marketplace@mercantil.com.br"", ""cEnvLink"": ""N"", ""cEnvBoleto"": ""N"", ""cEnvPix"": ""N"", ""cEnvViaUnica"": ""N"", ""cEnvRecibo"": ""N"", ""dDataPrevisao"": ""23/09/2026"", ""dDataCompetencia"": ""23/09/2026"", ""cOrigem"": """", ""cObservacao"": """", ""ServicosPrestados"": [{""nCodServico"": 0, ""nQtde"": 1, ""nValUnit"": 25, ""cTpDesconto"": ""V"", ""nValorDesconto"": 5, ""nAliqDesconto"": 0, ""nValorOutrasRetencoes"": 0, ""nValorAcrescimos"": 0, ""cTribServ"": ""01"", ""cCodCategItem"": ""1.01.02"", ""cCodServLC116"": ""1.04"", ""cCodServMun"": """", ""cNaoGerarFinanceiro"": ""N"", ""impostos"": {""nValorDeducao"": 0, ""cUtilizaValorImposto"": ""N"", ""cDeduzISS"": ""N"", ""cRetemISS"": ""N"", ""nAliqISS"": 0, ""nValorISS"": 0, ""cRetemCSLL"": ""N"", ""nAliqCSLL"": 0, ""nValorCSLL"": 0, ""cRetemIRRF"": ""N"", ""nAliqIRRF"": 0, ""nValorIRRF"": 0, ""nValorDeducaoIRRF"": 0, ""cRetemINSS"": ""N"", ""nAliqINSS"": 0, ""nValorINSS"": 0, ""nAliqRedBaseINSS"": 0, ""cRetemPIS"": ""N"", ""nAliqPIS"": 0, ""nValorPIS"": 0, ""nAliqRedBasePIS"": 0, ""cRetemCOFINS"": ""N"", ""nAliqCOFINS"": 0, ""nValorCOFINS"": 0, ""nAliqRedBaseCOFINS"": 0}}]}]}")
        ]
    ),
    Dados = Json.Document(Resposta)
in
    Dados

Operações

AdicionarItemOs
AdicionarOs