Produtos ·
ProdutosLoteLotes de produtos
2consultas
0alterações
Claude · MCPpelos assistentes de IA
JSON · XMLformato
Método para realizar a consulta do lote do produto.
Obrigatórios 0
Nenhum campo obrigatório.
Opcionais 3Campos e estruturas que você pode enviar
| Campo | Tipo | Descrição |
|---|---|---|
cCodIntProd | texto · até 60 | Código de integração do produto. Esse campo deve ser informado apenas se você incluiu o produto via API e informou um código de integração para o produto. Do contrário, informe sempre a tag "nCodProd". |
nCodProd | número inteiro | Código interno de identificação do produto. É o ID do produto e será utilizado apenas nas APIs como chave principal para localizar um produto. Quando um produto for incluído via API, você receberá um ID para esse novo produto. Recomendamos que você guarde essa informação no aplicativo que estiver integrando. Utilize a tag "codigo_produto" do método "ListarProdutos" da API /api/v1/geral/produtos/ para obter essa informação. |
nIdLocal | número inteiro | Código interno de identificação do local(Estoque). |
Retorno 2O que volta numa chamada bem-sucedida
| Campo | Tipo | Descrição |
|---|---|---|
ident | objeto | Identificação do produto. |
ident.cCodIntProd | texto | Código de integração do produto. Esse campo deve ser informado apenas se você incluiu o produto via API e informou um código de integração para o produto. Do contrário, informe sempre a tag "nCodProd". |
ident.cCodProduto | texto | Código do Produto exibido na tela de Produtos. |
ident.cDescrProduto | texto | Descrição do produto. Descrição do nome do produto no Omie. |
ident.nCodProd | número inteiro | Código do produto. É o ID do produto e será utilizado apenas nas APIs como chave principal para localizar um produto. Quando um produto for incluído via API, você receberá um ID para esse novo produto. Recomendamos que você guarde essa informação no aplicativo que estiver integrando. Utilize a tag "codigo_produto" do método "ListarProdutos" da API /api/v1/geral/produtos/ para obter essa informação. |
lotes | lista de objetos | Informações do lote. |
lotes[].cCodAgregacao | texto | Código agregado do lote. |
lotes[].cNumLote | texto | Numero do lote. |
lotes[].cObs | texto | Observação. |
lotes[].dDataFabricacao | texto | Data fabricação do lote. |
lotes[].dDataValidade | texto | Data validade do lote. |
lotes[].nIdLocal | número inteiro | Código interno de identificação do local(Estoque). |
lotes[].nIdLote | número inteiro | Código interno de identificação do lote. É o ID do lote e será utilizado apenas nas APIs como chave principal para localizar um lote. |
lotes[].nQuantDisponivel | decimal | Quantidade disponível do lote. |
lotes[].nQuantEntradas | decimal | Quantidade entrada do lote. |
lotes[].nQuantReservada | decimal | Quantidade reservada do lote. |
lotes[].nQuantSaidas | decimal | Quantidade de saídas do lote. |
lotes[].nSaldoLote | decimal | Quantidade da entrada do produto menos a saída do produto. |
POST /api/v1/produtos/produtoslote/
curl -s https://app.omie.com.br/api/v1/produtos/produtoslote/ \
-H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
-H 'Content-Type: application/json' \
-d '{"call": "ConsultarLote", "param": [{"nCodProd": 0, "cCodIntProd": "", "nIdLocal": 0}]}'import os
import requests
corpo = {'call': 'ConsultarLote', 'param': [{'nCodProd': 0, 'cCodIntProd': '', 'nIdLocal': 0}]}
resp = requests.post(
"https://app.omie.com.br/api/v1/produtos/produtoslote/",
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/produtos/produtoslote/", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"call": "ConsultarLote",
"param": [
{
"nCodProd": 0,
"cCodIntProd": "",
"nIdLocal": 0
}
]
}),
});
console.log(await resp.json());<?php
$ch = curl_init("https://app.omie.com.br/api/v1/produtos/produtoslote/");
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": "ConsultarLote",
"param": [
{
"nCodProd": 0,
"cCodIntProd": "",
"nIdLocal": 0
}
]
}
JSON,
]);
echo curl_exec($ch);require "net/http"
uri = URI("https://app.omie.com.br/api/v1/produtos/produtoslote/")
corpo = <<~'JSON'
{
"call": "ConsultarLote",
"param": [
{
"nCodProd": 0,
"cCodIntProd": "",
"nIdLocal": 0
}
]
}
JSON
resp = Net::HTTP.post(uri, corpo,
"Authorization" => "Bearer #{ENV.fetch('TOKEN_DO_APLICATIVO')}",
"Content-Type" => "application/json")
puts resp.bodyimport java.net.URI;
import java.net.http.*;
var corpo = """
{
"call": "ConsultarLote",
"param": [
{
"nCodProd": 0,
"cCodIntProd": "",
"nIdLocal": 0
}
]
}
""";
var pedido = HttpRequest.newBuilder()
.uri(URI.create("https://app.omie.com.br/api/v1/produtos/produtoslote/"))
.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/produtos/produtoslote/",
[
Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
Content = Text.ToBinary("{""call"": ""ConsultarLote"", ""param"": [{""nCodProd"": 0, ""cCodIntProd"": """", ""nIdLocal"": 0}]}")
]
),
Dados = Json.Document(Resposta)
in
DadosMétodo para realizar a listagem dos lotes do produto.
Obrigatórios 0
Nenhum campo obrigatório.
Opcionais 6Campos e estruturas que você pode enviar
| Campo | Tipo | Descrição |
|---|---|---|
cFiltrarApenasAlteracao | texto · até 1 | |
cFiltrarApenasInclusao | texto · até 1 | |
cFiltrarPorDataAte | texto · até 10 | |
cFiltrarPorDataDe | texto · até 10 | |
nPagina | número inteiro | |
nRegPorPagina | número inteiro |
Retorno 5O que volta numa chamada bem-sucedida
| Campo | Tipo | Descrição |
|---|---|---|
listaLotes | lista de objetos | Informações dos lotes do produto. |
listaLotes[].ident | objeto | Identificação do produto. |
listaLotes[].ident.cCodIntProd | texto | Código de integração do produto. Esse campo deve ser informado apenas se você incluiu o produto via API e informou um código de integração para o produto. Do contrário, informe sempre a tag "nCodProd". |
listaLotes[].ident.cCodProduto | texto | Código do Produto exibido na tela de Produtos. |
listaLotes[].ident.cDescrProduto | texto | Descrição do produto. Descrição do nome do produto no Omie. |
listaLotes[].ident.nCodProd | número inteiro | Código do produto. É o ID do produto e será utilizado apenas nas APIs como chave principal para localizar um produto. Quando um produto for incluído via API, você receberá um ID para esse novo produto. Recomendamos que você guarde essa informação no aplicativo que estiver integrando. Utilize a tag "codigo_produto" do método "ListarProdutos" da API /api/v1/geral/produtos/ para obter essa informação. |
listaLotes[].lotes | lista de objetos | Informações dos lotes do produto. |
listaLotes[].lotes[].cCodAgregacao | texto | Código agregado do lote. |
listaLotes[].lotes[].cNumLote | texto | Numero do lote. |
listaLotes[].lotes[].cObs | texto | Observação. |
listaLotes[].lotes[].dDataFabricacao | texto | Data fabricação do lote. |
listaLotes[].lotes[].dDataValidade | texto | Data validade do lote. |
listaLotes[].lotes[].nIdLocal | número inteiro | Código interno de identificação do local(Estoque). |
listaLotes[].lotes[].nIdLote | número inteiro | Código interno de identificação do lote. É o ID do lote e será utilizado apenas nas APIs como chave principal para localizar um lote. |
listaLotes[].lotes[].nQuantDisponivel | decimal | Quantidade disponível do lote. |
listaLotes[].lotes[].nQuantEntrada | decimal | Quantidade entrada do lote. |
listaLotes[].lotes[].nQuantReservada | decimal | Quantidade reservada do lote. |
listaLotes[].lotes[].nQuantSaida | decimal | Quantidade de saídas do lote. |
listaLotes[].lotes[].nSaldoLote | decimal | Quantidade da entrada do produto menos a saída do produto. |
nPagina | número inteiro | |
nRegistros | número inteiro | |
nTotPaginas | número inteiro | |
nTotRegistros | número inteiro |
POST /api/v1/produtos/produtoslote/
curl -s https://app.omie.com.br/api/v1/produtos/produtoslote/ \
-H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
-H 'Content-Type: application/json' \
-d '{"call": "ListarLotes", "param": [{"nPagina": 1, "nRegPorPagina": 50}]}'import os
import requests
corpo = {'call': 'ListarLotes', 'param': [{'nPagina': 1, 'nRegPorPagina': 50}]}
resp = requests.post(
"https://app.omie.com.br/api/v1/produtos/produtoslote/",
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/produtos/produtoslote/", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"call": "ListarLotes",
"param": [
{
"nPagina": 1,
"nRegPorPagina": 50
}
]
}),
});
console.log(await resp.json());<?php
$ch = curl_init("https://app.omie.com.br/api/v1/produtos/produtoslote/");
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": "ListarLotes",
"param": [
{
"nPagina": 1,
"nRegPorPagina": 50
}
]
}
JSON,
]);
echo curl_exec($ch);require "net/http"
uri = URI("https://app.omie.com.br/api/v1/produtos/produtoslote/")
corpo = <<~'JSON'
{
"call": "ListarLotes",
"param": [
{
"nPagina": 1,
"nRegPorPagina": 50
}
]
}
JSON
resp = Net::HTTP.post(uri, corpo,
"Authorization" => "Bearer #{ENV.fetch('TOKEN_DO_APLICATIVO')}",
"Content-Type" => "application/json")
puts resp.bodyimport java.net.URI;
import java.net.http.*;
var corpo = """
{
"call": "ListarLotes",
"param": [
{
"nPagina": 1,
"nRegPorPagina": 50
}
]
}
""";
var pedido = HttpRequest.newBuilder()
.uri(URI.create("https://app.omie.com.br/api/v1/produtos/produtoslote/"))
.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/produtos/produtoslote/",
[
Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
Content = Text.ToBinary("{""call"": ""ListarLotes"", ""param"": [{""nPagina"": 1, ""nRegPorPagina"": 50}]}")
]
),
Dados = Json.Document(Resposta)
in
Dados