Geral · ProdutosKit

KIT de produtos

POSThttps://app.omie.com.br/api/v1/geral/produtoskit/WSDL

0consultas

1alteração

Claude · MCPpelos assistentes de IA

JSON · XMLformato

AlterarComponentesKit

altera dadosClaudeMCP

Inclui/Altera/Exclui os componentes do KIT.

Obrigatórios 1

Campo	Tipo	Descrição
`codigo_produto`	número inteiro	ID do produto que irá receber os componentes do KIT. (utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno gerado pelo Omie ao cadastrar o produto. Para incluir componentes do KIT, o Tipo do Produto deve ser: "KT - Kit".

Opcionais 1Campos e estruturas que você pode enviar

Campo	Tipo	Descrição
`componentes_kit`	lista de objetos	Lista de Componentes do KIT.
`componentes_kit[].acao_componente`obrigatório	texto · até 1	Indica se irá Incluir/Alterar ou Excluir o componente. Pode ser: "A" - Alterar o componente. "E" - Excluir o componente "I" - Incluir o componente.
`componentes_kit[].codigo_componente`	número inteiro	Identificação do componente do KIT, deve ser utilizado para Alterar e Excluir o componente. Não deve ser informado na inclusão. Esse código não aparece na tela do Omie.
`componentes_kit[].codigo_local_estoque`	número inteiro	ID do local de estoque Caso não seja informado será atribuido o local de estoque padrão. Utilize a tag "codigo_local_estoque" do método "ListarLocaisEstoque" da API: https://app.omie.com.br/api/v1/estoque/local/ para obter essa informação.
`componentes_kit[].codigo_produto_componente`	número inteiro	ID do produto que deseja Incluir ou Alterar no KIT. (utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno gerado pelo Omie ao cadastrar o produto.
`componentes_kit[].obs_componente`	texto	Observações do Componente.
`componentes_kit[].quantidade_componente`	número	Quantidade do componente.
`componentes_kit[].valor_unitario_componente`	número	Valor unitário do componente.

Retorno 4O que volta numa chamada bem-sucedida

Campo	Tipo	Descrição
`cCodStatus`	texto	Código do status do processamento. Se o retorno for "0" significa que a solicitação foi executada com sucesso. Se o retorno for maior que "0" ocorreu algum erro durante o processamento da solicitação. A tag "cDesStatus" descreve o problema ocorrido.
`cDesStatus`	texto	Descrição do status do processamento. Essa tag explica o resultado da tag "cCodigoStatus".
`codigo_produto`	número inteiro	ID do produto que irá receber os componentes do KIT. (utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno gerado pelo Omie ao cadastrar o produto. Para incluir componentes do KIT, o Tipo do Produto deve ser: "KT - Kit".
`componentes_kit`	lista de objetos	Lista de Componentes do KIT.
`componentes_kit[].acao_componente`	texto	Indica se irá Incluir/Alterar ou Excluir o componente. Pode ser: "A" - Alterar o componente. "E" - Excluir o componente "I" - Incluir o componente.
`componentes_kit[].codigo_componente`	número inteiro	Identificação do componente do KIT, deve ser utilizado para Alterar e Excluir o componente. Não deve ser informado na inclusão. Esse código não aparece na tela do Omie.
`componentes_kit[].codigo_local_estoque`	número inteiro	ID do local de estoque Caso não seja informado será atribuido o local de estoque padrão. Utilize a tag "codigo_local_estoque" do método "ListarLocaisEstoque" da API: https://app.omie.com.br/api/v1/estoque/local/ para obter essa informação.
`componentes_kit[].codigo_produto_componente`	número inteiro	ID do produto que deseja Incluir ou Alterar no KIT. (utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno gerado pelo Omie ao cadastrar o produto.
`componentes_kit[].obs_componente`	texto	Observações do Componente.
`componentes_kit[].quantidade_componente`	decimal	Quantidade do componente.
`componentes_kit[].valor_unitario_componente`	decimal	Valor unitário do componente.

POST /api/v1/geral/produtoskit/

curl -s https://app.omie.com.br/api/v1/geral/produtoskit/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "AlterarComponentesKit", "param": [{"codigo_produto": 0, "componentes_kit": [{"acao_componente": "I", "codigo_componente": 0, "codigo_produto_componente": 0, "valor_unitario_componente": 1.99, "quantidade_componente": 1, "codigo_local_estoque": 0}]}]}'

import os
import requests

corpo = {'call': 'AlterarComponentesKit',
 'param': [{'codigo_produto': 0,
            'componentes_kit': [{'acao_componente': 'I',
                                 'codigo_componente': 0,
                                 'codigo_produto_componente': 0,
                                 'valor_unitario_componente': 1.99,
                                 'quantidade_componente': 1,
                                 'codigo_local_estoque': 0}]}]}

resp = requests.post(
    "https://app.omie.com.br/api/v1/geral/produtoskit/",
    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/geral/produtoskit/", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "call": "AlterarComponentesKit",
    "param": [
      {
        "codigo_produto": 0,
        "componentes_kit": [
          {
            "acao_componente": "I",
            "codigo_componente": 0,
            "codigo_produto_componente": 0,
            "valor_unitario_componente": 1.99,
            "quantidade_componente": 1,
            "codigo_local_estoque": 0
          }
        ]
      }
    ]
  }),
});
console.log(await resp.json());

<?php
$ch = curl_init("https://app.omie.com.br/api/v1/geral/produtoskit/");
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": "AlterarComponentesKit",
    "param": [
        {
            "codigo_produto": 0,
            "componentes_kit": [
                {
                    "acao_componente": "I",
                    "codigo_componente": 0,
                    "codigo_produto_componente": 0,
                    "valor_unitario_componente": 1.99,
                    "quantidade_componente": 1,
                    "codigo_local_estoque": 0
                }
            ]
        }
    ]
}
JSON,
]);
echo curl_exec($ch);

require "net/http"

uri = URI("https://app.omie.com.br/api/v1/geral/produtoskit/")
corpo = <<~'JSON'
{
  "call": "AlterarComponentesKit",
  "param": [
    {
      "codigo_produto": 0,
      "componentes_kit": [
        {
          "acao_componente": "I",
          "codigo_componente": 0,
          "codigo_produto_componente": 0,
          "valor_unitario_componente": 1.99,
          "quantidade_componente": 1,
          "codigo_local_estoque": 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": "AlterarComponentesKit",
  "param": [
    {
      "codigo_produto": 0,
      "componentes_kit": [
        {
          "acao_componente": "I",
          "codigo_componente": 0,
          "codigo_produto_componente": 0,
          "valor_unitario_componente": 1.99,
          "quantidade_componente": 1,
          "codigo_local_estoque": 0
        }
      ]
    }
  ]
}
""";

var pedido = HttpRequest.newBuilder()
    .uri(URI.create("https://app.omie.com.br/api/v1/geral/produtoskit/"))
    .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/geral/produtoskit/",
        [
            Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
            Content = Text.ToBinary("{""call"": ""AlterarComponentesKit"", ""param"": [{""codigo_produto"": 0, ""componentes_kit"": [{""acao_componente"": ""I"", ""codigo_componente"": 0, ""codigo_produto_componente"": 0, ""valor_unitario_componente"": 1.99, ""quantidade_componente"": 1, ""codigo_local_estoque"": 0}]}]}")
        ]
    ),
    Dados = Json.Document(Resposta)
in
    Dados

Operações

AlterarComponentesKit