Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Quando houver a necessidade de interagir com a API no fechamento da venda.

Nesta etapa de conclusão da venda, o parceiro integra a venda na integra, podendo ser utilizado para relatórios ou gerenciamento do parceiro. 

Na Header, temos um campo para identificação do cliente para envio ao parceiro, o campo Identification,  que contém os seguintes campos: 

IdentificationType : citInternal (veja a tabela abaixo os tipos de identificações)
DocumentType: cdtCPF  (cdtCNPJ ou cdtCPF) ==> Tipo de documento
Document : 11111111111 ==> Dados do documento apresentado
PartnerCode := 30 ==> Código do parceiro

Valores para TIdentificationType abaixo :  

TIdentificationType

Descrição do tipo de identificação

citInternal,Identificação interna
citInvoiceIdentificação fiscal (Nota fiscal paulista e outros)
citRewardIdentificação de recompensas, parceiros, etc.
citOtherOutras identificações
citUnknownDesconhecido


Temos a opção de informar na integração o segmento e a pré-venda que deu origem a mesma, veja na tag Items:

  • IdSegment: Integer; – Número do segmento de faturamento
  • OrderNumber: String; – Número da pré-venda de faturamento

O campo com número da chave do SAT ou chave da NFC-e, é o campo IdInvoiceKey, que no final da venda será populado e passado para o parceiro

Na tag TaxDocument, seráenviado os campos relacionado ao tipo de documento fiscal que foi emitido no PDV: 

Tag

Descrição 

DocumentXML da nota (NF-e, NFCE ou SAT)
IdDocumentNúmero da nota (NF-e, NFCE ou SAT)
KindDocumentModelo do documento fiscal
SerialNumberSérie do documento fiscal
URLUrl QrCode do documento eleltrônico


Com o PDV na operação “Finalização Finalização da venda”venda, a notificação da API trará o “Operation” com Operation com valor “cotEndSale” cotEndSale, informará também as informações da venda e dos itens.

...

{
 "Version": 1, 
 "Event": "cetBefore",
 "Execution": "cetContinue",
 "ID": "001212000628810",
 "Operation": "cotEndSale",
 "ParkingTicket": null,
 "Pay": null,
 "Response": "",
 "Sale": {
    "Discount": 0.0,
    "DiscountCodes": [],
    "Header": {
       "AccountingDate": "2020-12-28T00:00:00",
       "DateTimeIssue": "2020-12-28T11:13:48",
       "IdDocument": 628810,
      "CooDocument": 527,
       "IdStore": 1,
       "IdTerminal": 212,
       "IdUser": 2,
       "Identification": [
{
"IdentificationType" : citInternal,
"Document" : LCpfCnpj,
"DocumentType" : 11111111111,
"PartnerCode" := 0
}
],
       "Status": "sttValid"  
},
     "ID": "001212000628810",
     "Increase": 0.0,
     "Items": [ 
{
         "BarCode": "255",
        "CaptionPacking": "KG",
         "Description": "SALADA MISTA kg",
         "DiscountPrice": 1.98,
         "IncreasePrice": 0.0,
         "InternalCode": "255",
         "ItemNumber": 1,
         "PackingQuantity": 1.0,
         "PartitionDiscount": [ 
{
            "DiscountAmount": 1.0,
             "PartnerCode": 20,
             "Price": 0.99,
           "PromotionCode": 24,
             "PromotionCodeIncreDiscType": 2 24 
},
            {
             "DiscountAmount": 1.0,
             "PartnerCode": 20,
             "Price": 0.99,
             "PromotionCodeIncreDiscType": 1
}
          ],
          "PartitionIncrease": [],
          "Quantity": 2.0,
          "SellerCode": 0,
         ,
"IdSegment": 3,
"OrderNumber": 1526,
"Status": "sttValid",
          "TotalPrice": 17.82,
          "UnitPrice": 9.9
}
      ],
     "Messages": {
        "Customer": [],
        "User": [] 
},
     "PartitionDiscount": [],
     "PartitionIncrease": [],
     "PaymentChange": null,
     "Payments": [
{
         "AuthorizationCode": "",
         "Discount": 0.0,
         "ExpirationDateCard": "",
         "FirstDigitCard": "",
         "FlagCard": "",
        "IdWallet": "",
         "Increase": 0.0,
         "InstallmentAmount": 0,
         "ItemNumber": 1,
         "LastDigitCard": "",
         "NetworkCard": "",
         "OwnerCard": "",
         "PartitionDiscount": [],
         "PartitionIncrease": [],
         "PaymentNumber": 1,
         "PaymentType": "cptMoney",
         "Total": 17.82,
         "TransactionCanceledCode": "",
         "TransactionCode": "",
         "TypeWallet": "" 
}
      ],
      "SolidaryChange": null,
"TaxDocument": }
{
            "Document": "",
            "IdDocument": 689,
        ],
    "KindDocument": "65",
            "SolidaryChangeSerialNumber": null"412",
          "URL": ""
}
      "Total": 17.82,
      "VouchersPrint": [] 
,
"IdInvoiceKey" : "29210214200166000166657020000001019138217110"
}
}