Produtos · sat

Importação de CF-e SAT

POSThttps://app.omie.com.br/api/v1/produtos/sat/WSDL

0consultas

1alteração

Claude · MCPpelos assistentes de IA

JSON · XMLformato

ImportarCfeSat

altera dadosClaudeMCP

Importa o XML de um CF-e SAT.

Obrigatórios 6

Campo	Tipo	Descrição
`chNFe`	texto · até 44	Chave de Acesso do CF-e-SAT.
`emiId`	texto · até 20	Identificação do computador onde o aplicativo emissor do cupom fiscal está instalado. É o código do PDV. Exemplos: "01", "20", "55".
`emiNome`	texto · até 20	Nome do aplicativo emissor do cupom fiscal. O aplicativo deve ser previamente cadastrado. Para isso entre em contato com a nosso suporte.
`emiVersao`	texto · até 20	Versão do aplicativo emissor do cupom fiscal.
`satMd5`	texto · até 32	MD5 do arquivo XML enviado em "satXml".
`satXml`	texto	XML do Cupom Fiscal enviado. Preechimento obrigatório. Antes de enviar, converta os seus seguintes caracteres: & para &amp; > para &gt; < para &lt; " para &quot; " para &apos; \| para &#124; Após essa conversão aplique o MD5 para enviar no campo "nfceMd5". Observação: Para requisições SOAP usar CDATA como demonstra o exemplo abaixo: <![CDATA[Conteúdo do campo convertido]]>.

Opcionais 8Campos e estruturas que você pode enviar

Campo	Tipo	Descrição
`cAcaoCliente`	texto · até 15	Ação a ser executada com relação a tag idCliente. Pode ser: - CONSUMIDOR: assumirá que a venda foi realizada para um cliente consumidor padrão. Caso não exista um cliente consumidor cadastrado, o mesmo será criado automaticamente. - ERRO (padrão): Exigirá a definição de um idCliente válido. - INCLUIR: Com base nos dados do XML irá fazer a inclusão de um novo cliente.
`cIncluirProduto`	texto · até 1	Indica se na inclusão do cupom os produtos não existentes devem ser incluídos automaticamente. Possíveis valores: S - Sim N - Não (padrão).
`cNaoGerarTitulo`	texto · até 1	Indica que a parcela não deve gerar um título no financeiro. Valores possíveis: S - Sim N - Não.
`cNaoMovEstoque`	texto · até 1	Indica que os items do Cupom Fiscal não devem movimentar o estoque. Valores possíveis: S - Sim N - Não.
`idCliente`	número inteiro	Código do cliente. - Se no XML não houver informações do cliente assumirá que a venda foi realizada para um cliente consumidor padrão. Caso não exista um cliente consumidor cadastrado, o mesmo será criado automaticamente. - Se no XML houver informações do cliente, seus dados serão consultados no Omie com base no CPF/CNPJ, caso não seja encontrado a tag cAcaoCliente será avaliada. Possível valores para tag cAcaoCliente: - CONSUMIDOR: assumirá que a venda foi realizada para um cliente consumidor padrão. Caso não exista um cliente consumidor cadastrado, o mesmo será criado automaticamente. - ERRO (padrão): Exigirá a definição de um idCliente válido. - INCLUIR: Com base nos dados do XML irá fazer a inclusão de um novo cliente.
`idLocalEstoque`	número inteiro	Código do Local do Estoque. Caso não informado assumirá o Local de Estoque padrão.
`idProjeto`	número inteiro	Código do projeto. Quando não informado, será criado um projeto padrão para o emissor de cupom fiscal.
`idVendedor`	número inteiro	Código do vendedor. Quando não informado, será criado um vendedor padrão para o emissor de cupom fiscal.

Retorno 5O que volta numa chamada bem-sucedida

Campo	Tipo	Descrição
`cCodStatus`	texto	Código do status de processamento do cupom fiscal. Se retornar 0 indica que o cupom foi processado com sucesso. Se retornar um valor maior que zero indica o código do erro gerado.
`cDesStatus`	texto	Descrição do status de processamento. Caso ocorra erro, retorna a descrição do erro gerado.
`idCupom`	número inteiro	Identificação do cupom fiscal.
`idImportacao`	número inteiro	ID da Importação.
`idLote`	número inteiro	Identificação do lote do cupom fiscal.

POST /api/v1/produtos/sat/

curl -s https://app.omie.com.br/api/v1/produtos/sat/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "ImportarCfeSat", "param": [{"emiNome": "SeuPDV", "emiVersao": "1.01.02", "emiId": "PDV01", "chNFe": "", "satXml": "", "satMd5": "", "cAcaoCliente": "INCLUIR", "idCliente": 0, "idVendedor": 0, "idProjeto": 0, "idLocalEstoque": 0, "cNaoMovEstoque": "N", "cNaoGerarTitulo": "N", "cIncluirProduto": "N"}]}'

import os
import requests

corpo = {'call': 'ImportarCfeSat',
 'param': [{'emiNome': 'SeuPDV',
            'emiVersao': '1.01.02',
            'emiId': 'PDV01',
            'chNFe': '',
            'satXml': '',
            'satMd5': '',
            'cAcaoCliente': 'INCLUIR',
            'idCliente': 0,
            'idVendedor': 0,
            'idProjeto': 0,
            'idLocalEstoque': 0,
            'cNaoMovEstoque': 'N',
            'cNaoGerarTitulo': 'N',
            'cIncluirProduto': 'N'}]}

resp = requests.post(
    "https://app.omie.com.br/api/v1/produtos/sat/",
    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/sat/", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "call": "ImportarCfeSat",
    "param": [
      {
        "emiNome": "SeuPDV",
        "emiVersao": "1.01.02",
        "emiId": "PDV01",
        "chNFe": "",
        "satXml": "",
        "satMd5": "",
        "cAcaoCliente": "INCLUIR",
        "idCliente": 0,
        "idVendedor": 0,
        "idProjeto": 0,
        "idLocalEstoque": 0,
        "cNaoMovEstoque": "N",
        "cNaoGerarTitulo": "N",
        "cIncluirProduto": "N"
      }
    ]
  }),
});
console.log(await resp.json());

<?php
$ch = curl_init("https://app.omie.com.br/api/v1/produtos/sat/");
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": "ImportarCfeSat",
    "param": [
        {
            "emiNome": "SeuPDV",
            "emiVersao": "1.01.02",
            "emiId": "PDV01",
            "chNFe": "",
            "satXml": "",
            "satMd5": "",
            "cAcaoCliente": "INCLUIR",
            "idCliente": 0,
            "idVendedor": 0,
            "idProjeto": 0,
            "idLocalEstoque": 0,
            "cNaoMovEstoque": "N",
            "cNaoGerarTitulo": "N",
            "cIncluirProduto": "N"
        }
    ]
}
JSON,
]);
echo curl_exec($ch);

require "net/http"

uri = URI("https://app.omie.com.br/api/v1/produtos/sat/")
corpo = <<~'JSON'
{
  "call": "ImportarCfeSat",
  "param": [
    {
      "emiNome": "SeuPDV",
      "emiVersao": "1.01.02",
      "emiId": "PDV01",
      "chNFe": "",
      "satXml": "",
      "satMd5": "",
      "cAcaoCliente": "INCLUIR",
      "idCliente": 0,
      "idVendedor": 0,
      "idProjeto": 0,
      "idLocalEstoque": 0,
      "cNaoMovEstoque": "N",
      "cNaoGerarTitulo": "N",
      "cIncluirProduto": "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": "ImportarCfeSat",
  "param": [
    {
      "emiNome": "SeuPDV",
      "emiVersao": "1.01.02",
      "emiId": "PDV01",
      "chNFe": "",
      "satXml": "",
      "satMd5": "",
      "cAcaoCliente": "INCLUIR",
      "idCliente": 0,
      "idVendedor": 0,
      "idProjeto": 0,
      "idLocalEstoque": 0,
      "cNaoMovEstoque": "N",
      "cNaoGerarTitulo": "N",
      "cIncluirProduto": "N"
    }
  ]
}
""";

var pedido = HttpRequest.newBuilder()
    .uri(URI.create("https://app.omie.com.br/api/v1/produtos/sat/"))
    .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/sat/",
        [
            Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
            Content = Text.ToBinary("{""call"": ""ImportarCfeSat"", ""param"": [{""emiNome"": ""SeuPDV"", ""emiVersao"": ""1.01.02"", ""emiId"": ""PDV01"", ""chNFe"": """", ""satXml"": """", ""satMd5"": """", ""cAcaoCliente"": ""INCLUIR"", ""idCliente"": 0, ""idVendedor"": 0, ""idProjeto"": 0, ""idLocalEstoque"": 0, ""cNaoMovEstoque"": ""N"", ""cNaoGerarTitulo"": ""N"", ""cIncluirProduto"": ""N""}]}")
        ]
    ),
    Dados = Json.Document(Resposta)
in
    Dados

Operações

ImportarCfeSat