OmieapiDocumentaçãoOperações
← Referência das operações

TrocarEtapaOSaltera dados

Troca a Etapa da Ordem de Serviço.

Identificação

Operaçãoservicos/os:TrocarEtapaOS
ServiçoOrdemServico
MóduloServiços
Endpoint/api/v1/servicos/os/

Parâmetros

CampoTipoDescrição
cCodIntOSstringCódigo de integração da Ordem de Serviço. Preenchimento Obrigatório na inclusão/alteração. Preenchimento Opcional na Consulta/Pesquisa. Preencha esse campo com o código da Ordem de Serviço no aplicativo que você está integração com o Omie. A função dele é servir como uma mapa de relacionamento entre as aplicações. Ao realizar uma consulta/listagem de Ordem de Serviço você conseguirá ver a relação entre o id da Ordem de Serviço gerada no Omie e o código da Ordem de Serviço existente em sua aplicação.
cEtapastringEtapa da Ordem de Serviço. Preenchimento Obrigatório. Esse campo indica em que coluna a Ordem de Serviço irá figurar no processo de faturamento do Omie. Utilize a tag "codigo" do método "ListarEtapasFaturamento" da API http://app.omie.com.br/api/v1/produtos/etapafat/ para obter essa informação. Os valores são fixos, mas as descrições (funções atribuídas a cada coluna pode mudar. A API irá indicar a descrição de cada coluna. Os valores disponíveis para esse campo podem ser: "10" - Primeira coluna "20" - Segunda coluna "30" - Terceira coluna "40" - Quarta coluna "50" - Faturar
cNumOSstringNúmero da Ordem de Serviço. Preenchimento automático na inclusão/alteração. Preenchimento disponível apenas na consulta/pesquisa. Esse é o número da Ordem de Serviço no Omie, que é gerado automaticamente e exibido na tela.
nCodOSintegerID da Ordem de Serviço. Preenchimento automático na inclusão - Informe esse campo somente para pesquisa. Esse campo não é exibido na tela da Ordem de Serviço. É uma informação interna, utilizada apenas nas APIs.

Exemplo de chamada

{
  "cCodIntOS": "",
  "nCodOS": 0,
  "cNumOS": "",
  "cEtapa": ""
}
Esta operação altera dados de verdade, na hora. Não existe ambiente de ensaio neste endereço.
api.omie.com.br/mcp · Documentação · Operações