Presence API - INCLUIR_VENDA

Presence API - INCLUIR_VENDA

AlertPara os dados retornarem corretamente, o Endpoint de chamada é diferente, deve-se utilizar a seguinte URL:
https://dados.presence.com.br/api/PresenceWebApi.dll/api/v1/WebMethods/atualiza

INCLUIR-VENDA-HEADER


Nome
Obrigatório
Tipo
Descrição
cod_lojaSim
String
Código da loja
data_venda
Sim
Data (AAAA-MM-DDT00:00:00)
Data da venda
controle
Sim
Integer
Controle da venda
terminal
Sim
Integer
Terminal da venda
situacao_venda
Sim
String
E= emitido C= cancelado
tipo_doc
Sim
String
N= nota, R= romaneio E= ecf
modelo_nf
Sim
Integer
Modelo da nota fiscal
tipo_notaSim
String
E= entrada S= saída
serie_nf
Sim
Integer
Série da nota fiscal
numero_nf
Sim
Integer
Número da nota fiscal
 chave_nfNão
String
Chave de acesso da nota fiscal
 cliente_cod_loja
Não
String
Código da loja do cliente
 cliente_loja
Não
Integer
Código do cliente
 cpf_cnpj
Não
String
CPF ou CNPJ  do cliente
 tipo_destinatarioNão
String
Tipo do destinatário (C = Cliente, L = Loja, F = Fornecedor ou R = Representante)
cliente_cod_externoNão
String
Código externo do cliente
codigo_vendadorSimIntegerCódigo do vendedor
subtotal
Sim
Double
Subtotal da nota
total_descontoNão
Double
Total de sobre a nota
total_freteNão
Double
Valor total de frete
total
Sim
Double
Total da nota
observacaoNão
String
Observação a ser incluído na nota
hora_vendaNão
String
Hora da venda
versao_sistemaNão
String
Versão do sistema
 produto_serviço Sim
 String
P =  produto S = Serviço
 plano Não
 String
 Plano

INCLUIR-VENDA-ITEM


Nome
Obrigatório
Tipo
Descrição
cod_loja
Sim
String
Código da loja
data_venda
Sim
Data (AAAA-MM-DDT00:00:00)
Data de venda
controle
Sim
Integer
Controle da venda
terminal
Sim
Integer
Terminal da venda
sequencia
Sim
Integer
Sequência do item na venda
 codigo
Sim
String
Referência do produto
 tamanho
Sim
String
Tamanho do produto
 codigo_aux
Não
String
Código auxiliar vinculado ao produto (SKU). Obrigatório quando não informado código, tamanho e cor ou código de barras.
cor
Não
String
Cor do produto
desc_produtos
Sim
Double
desconto aplicado por item 
qt
Sim
Integer
Quantidade do item
preco_unitario
Sim
Double
Preço do unitário do item
desconto_item
Não
Double
Desconto unitário do item
desconto
Não
Double
Valor total de desconto
 desconto_percentual
 Não
 Double

 acrescimo
 Não
 Double

 preco_liquido
 Sim
 Double
 Preço final / Liquido
 preco_medio2
 Sim
 Double

 serie_ped
 Não
 Integer

 numero_ped
 Não
 Integer

 controle_item_ped
 Não
 Integer

 cod_situacao
 Não
 Integer

 codigo_barras
 Não
 String

 previsao_entrega
 Não
 String


INCLUIR-VENDA-PAGAMENTO


Nome
Obrigatório
Tipo
Descrição
cod_loja
Sim
String
Código da loja
data_venda
Sim
Data (AAAA-MM-DDT00:00:00)
Data da venda
controle
Sim
Integer
Controle da venda
terminal
Sim
Integer
Terminal da venda
parcela
Sim
Integer
Número da parcela
qtd_parcelas
Sim
Integer
Quantidade de parcelas
cond_pgto_externa
Sim
String
condição de pagamento de sistemas externos
id_webservice
Sim
Interger
ID de identificação da plataforma de e-commerce
dt_vencimento
Sim
Data (AAAA-MM-DDT00:00:00)
Data de vencimento da parcela
valor
Sim
Double
Valor da parcela
autorizacao
Sim
String
Autorização do cartão de crédito
conta
Sim
String
Conta da conta corrente

INCLUIR_CLIENTE

Nome
Obrigatório
Tipo
Descrição
codigoExterno
Sim
String
Código de outro sistema
loja
Sim
String
Código da loja
cpf_cnp
Sim
String
CPF / CNPJ do cliente
razao
Sim
String
Nome razão do cliente
nome
Sim
String
Nome do cliente ou nome fantasia
tipoPessoa
Sim
String
F= fisica J= jurídica
operacao
Sim
String
A= atacado v=varejo r= representante B= ambos
situacao
Sim
Siring
L=Liberado B=Bloqueado
rg_ie
Sim
String
RG do cliente
email
Sim
String
e-mail do cliente
sexo
Sim
String
Sexo do cliente M= masculino F=feminino I= indefinido
dataNascimento
Sim
Data (AAAA-MM-DDT00:00:00)
Data de nascimento do cliente
dddTelefone
Não
String
DDD telefone do cliente
telefone
Não
String
número de telefone do cliente
dddCelular
Não
String
DDD celular do cliente
celular
Não
String
Número de celular do cliente
dddTelComercial
NãoString
DDD telefone comercial do cliente
telComercial
Não
String
Número de telefone comercial do cliente
dddFax
Não
String
DDD do fax do cliente
fax
Não
String
Número do fax do cliente
endereco
Sim
String
Endereço do cliente
numero
Sim
String
Número do endereço do cliente
complemento
Sim
String
Complemento do endereço do cliente
bairro
Sim
String
Bairro do endereço do cliente
cep
Sim
String
CEP do endereço do cliente
cidade
Sim
String
Cidade do endereço do cliente
uf
Sim
String
Estado do endereço do cliente
pais
Não
String
País do do endereço do cliente
enderecoCobranca
Sim
String
Endereço de cobrança
endereco
 Sim
 String
 Endereço de cobrança
numero
 Sim
 String
 Número do endereço de cobrança
complemento
 Sim
 String
 Complemento do endereço de ocbrança
bairro
 Sim
 String
 Bairro do endereço de cobrança
cep
 Sim
 String
 CEP do endereço de cobrança
cidade
 Sim
 String
 Cidade do endereço de cobrança
uf
 Sim
 String
 Estado do endereço de cobrança
pais
 Não
 String
 País do endereço de cobrança
endereçoEntrega
 Sim
 String
 Endereço de entrega
numero
 Sim
 String
 Número do endereço de entrega
complemento
 Sim
 String
 Complemento do endereço de entrega
bairro
 Sim
 String
 Bairro do endereço de entrega
cep
 Não
 String
 CEP do endereço de entrega
cidade
 Sim
 String
 Cidade do endereço de entrega
uf
 Sim
 String
 Estado do endereço de entrega
pais
 Não
 String

 País do endereço de entrega







Quote
Endpoint: atualiza/INCLUIR-VENDA-HEADER
{
  "cod_loja": "01",
  "data_venda": "2024-03-13",
  "controle": "1600",
  "terminal": "01",
  "situacao_venda": "e",
  "tipo_doc": "r",
  "modelo_nf": "55",
  "tipo_nota": "s",
  "serie_nf": "01",
  "numero_nf": "0",
  "chave_nf":"",
  "cliente_cod_loja": "",
  "cliente_codigo":0,
  "cpf_cnpj":"",
  "tipo_destinatario": "c",
  "cliente_cod_externo": "01.0001074224",
  "codigo_vendedor":0,
  "subtotal": "58",
  "total_desconto": "0",
  "total_frete": 0,
  "total": "58",
  "observacao": "rol=1600",
  "hora_venda": "08:55",
  "versao_sistema": " 1.7.1.1",
  "produto_servico": "s",
  "plano":""
}



Quote
Endpoint: atualiza/INCLUIR-VENDA-ITEM

{
    "cod_loja": "20",
    "data_venda": "2025-02-26",
    "controle": "107516",
    "terminal": 1,
    "sequencia": 10,
    "codigo":"",
    "tamanho":"",
    "codigo_aux":"TESTEEEEEaDsD",
    "cor":"",
    "desc_produto": "",
    "qt": 1.00,
    "preco_unitario": 0.00,
    "desconto_item": 0.00,
    "desconto": 0.00,
    "desconto_percentual": 0.00,
    "acrescimo": 0.00,
    "preco_liquido": 0.00,
    "preco_medio2": 0.00,
    "serie_ped": 0,
    "numero_ped": 0,
    "controle_item_ped": 0,
    "cod_situacao" : 0,
    "codigo_barras" : "",
    "previsao_entrega" : ""
  }


Quote
Endpoint: atualiza/INCLUIR-VENDA-PAGAMENTO

{
  "cod_loja": "07",
  "data_venda": "2023-12-20",
  "controle": 5574,
  "terminal": 9,
  "parcela": 1,
  "qtd_parcelas": 7,
  "cond_pgto_externa": "AMEX PARC. 2 A 10X (CIELO)",
  "id_webservice": 990,
  "dt_vencimento": "2024-01-19",
  "valor": "230",
  "autorizacao": "642237",
  "conta": "261975"
}




Quote
Endpoint: atualiza/INCLUIR_CLIENTE

{
  "codigoExterno": "A01.25",
  "loja": "01",
  "cpf_cnpj": "05161834862",
  "razao": "CLIENTE TESTE API",
  "nome": "CLIENTE TESTE API",
  "tipoPessoa": "F",
  "operacao": "B",
  "situacao": "L",
  "rg_ie": "",
  "email": "",
  "sexo": "M",
  "dataNascimento": "1962-11-21",
  "dddTelefone": "",
  "telefone": "",
  "dddCelular": "",
  "celular": "",
  "dddTelComercial": "",
  "telComercial": "",
  "dddFax": "",
  "fax": "",
  "endereco": "RUA AQUIANES",
  "numero": "22",
  "complemento": "",
  "bairro": "BUTANTA",
  "cep": "05360120",
  "cidade": "Sao Paulo",
  "uf": "SP",
  "pais": "",
  "enderecoCobranca": {
    "endereco": "RUA AQUIANES1",
    "numero": "223",
    "complemento": "",
    "bairro": "BUTANTA1",
    "cep": "04772000",
    "cidade": "Sao Paulo",
    "uf": "SP",
    "pais": ""
  },
  "enderecoEntrega": {
    "endereco": "RUA AQUIANES2",
    "numero": "224",
    "complemento": "",
    "bairro": "BUTANTA2",
    "cep": "04773000",
    "cidade": "Sao Paulo",
    "uf": "SP",
    "pais": ""
  }
}


    • Related Articles

    • Presence API - INCLUIR_PRODUTO

      Inclusão de Produtos (Atualização e Inclusão) Este módulo é responsável por incluir produtos na base da dados. Parâmetros Campos Tipo Obrigatório Descrição codigo string(8) Não para inclusão, sim para alteração, quando codigoExterno ou codigoLegado ...
    • Presence API - INCLUIR_PEDIDO

      Inclusão de Pedidos (Somente Inclusão) Este módulo é responsável por incluir pedidos na base da dados. BODY Pedido Nome Obrigatório Tipo Descrição codigoPedidoExterno Sim String Código do pedido na plataforma dataEmissão Sim Data ...
    • Presence API - Página Inicial

      Essa API permite o consumo de informações disponíveis nos sistemas Presence através de chamadas de serviço, bem como a inserção de dados nos sistemas. Para ter acesso aos métodos já existentes, ou solicitação da criação de novos métodos, consulte as ...
    • Presence API - INCLUIR_DOC_FISCAL_DADOS

      Inclusão de Documento Fiscal (Somente Inclusão) Este método é responsável por incluir um documento fiscal na base da dados do Presence Domain. Regras gerais Este método deve ser invocado exclusivamente para notas que tenham o XML previamente ...
    • Presence API - INCLUIR_CFOP

      Inclusão de Naturezas de Operação (CFOP) (Atualização e Inclusão) Este módulo é responsável por incluir Naturezas de Operação (CFOP) na base da dados. BODY Campos Tipos Obrigatório Observação codigo String(7) Sim, será usado para busca do CFOP ...