Presence API - INCLUIR_VENDA

Presence API - INCLUIR_VENDA

INCLUIR-VENDA-HEADER


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
SITUAÇÃO_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_NOTA
Sim
String
E= entrada S= saída
SERIE_NF
Sim
Integer
Série da nota fiscal
NUMERO_NF
Sim
Integer
Número da nota fiscal
CLIENTE_COD_EXTERNO
Sim
String
Código externo do cliente
TIPO_DESTINATARIO
Sim
String
Tipo do destinatário (C = Cliente, L = Loja, F = Fornecedor ou R = Representante)
SUBTOTAL
Sim
Double
Subtotal da nota
TOTAL_DESCONTO
Sim
Double
Total de sobre a nota
TOTAL_FRETE
Sim
Double
Valor total de frete
TOTAL
Sim
Double
Total da nota
OBSERVAÇÃO
Não
String
Observação a ser incluído na nota
HORA_VENDA
Sim
String
Hora da venda
VERSAO_SISTEMA
Sim
String
Versão do sistema
PRODUTO_SERVICO
Sim
 String
P =  produto S = Serviço

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
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
 preco_liquido
Sim
 Double
 Preço final / Liquido

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",
  "CLIENTE_COD_EXTERNO": "01.0001074224",
  "TIPO_DESTINATARIO": "C",
  "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"
}



Quote
Endpoint: atualiza/INCLUIR-VENDA-ITEM

{
  "cod_loja": "07",
  "data_venda": "2023-12-15",
  "controle": "1199",
  "terminal": 9,
  "sequencia": 1,
  "desc_produto": "cod_barra: 0809979A363",
  "qt": "1",
  "preco_unitario": "1081.99",
  "desconto_item": "0",
  "desconto": "0",
  "preco_liquido": "1081.99"
}



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_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 - 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 - 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_CLIENTE

      Inclusão de Clientes (Atualização e Inclusão) Este módulo é responsável por incluir clientes na base da dados. Parâmetros Nome Obrigatório Tipo Descrição codigoExterno Não String Código do cliente no sistema de terceiros, obrigatório quando cpf_cnpj ...

    • Presence API - VENDAS_PAGAMENTOS

      Pagamentos das Vendas Este módulo é responsável por listar os tipos de pagamentos das vendas da base da dados. Parâmetros Nome Obrigatório Tipo Descrição loja Não Texto(2) Código da Loja dt_mov Não Texto Data de movimento da venda. Padrão ISO8601. ...