Cash Register - AggiungiScontrino

Creation of a new Till Receipt

Request

token_key

array

token

text

token_app

text

params

array

async

bool

If set to true, the receipt issuance request is sent asynchronously. You will then need to retrieve the receipt URL once it has been generated, using the DettaglioScontrino function

id_cashregister

char (36)

Id of the cash register to issue the receipt on. The id can be retrieved from the cash register list, function Cash Register -> List

valuta

char (36)

Enter the id of the currency to use. See the Currencies section. If not specified, the default one will be used.

prodotto

nome

text

codice

varchar (255)

importo_totale_iva

float (11,4)

importo_totale

float (11,4)

quantita

float (11,4)

prezzo_netto

float (11,4)

unita_misura

varchar (255)

sconto

float (11,4)

iva_importo

float (11,4)

iva_name

text

Enter the name of the VAT rate as reported in WindDoc. If you already know the unique Id of the VAT rate in WindDoc, enter it in the iva field and omit this one.

iva

char (36)

VAT rate Id. See the VAT Rates section

scarica_da_magazzino

bool

pagamento

importo

float (11,4)

valuta

tinyint (4)

id_cashregister_pagamento

varchar (255)

Id of the payment. Retrieve the Id from the Cashregister Payments -> List function

Response

Success

char (36)

Id of the document being generated

url

text

URL to download the document's PDF with a confirmation page.
Not present if the async parameter is set to true.

url_dir

text

Direct URL to download the document's PDF directly.
Not present if the async parameter is set to true.

Error

error

bool (1)

message

text

Installation

Request

<?php
$url = "https://app.winddoc.com/v1/api_json.php";
$token_app = "XXXXX";
$token = "XXXXXX";

$form_params = array("method"=>"cashregister_aggiungiScontrino",
              "request"=>array(
                  "token_key"=>array("token"=>$token,"token_app"=>$token_app),
                  "params"=>array('id_cashregister' => 'xxxxxxxx',
                                  "valuta" => "xxxxxxxx",
                                  "prodotti" => array(
                                                      array('importo_totale_iva' => 71.98,
                                                            'importo_totale' => 59.00,
                                                            'quantita' => 1,
                                                            'prezzo_netto' => 59.00,
                                                            'codice' => 'MG001',
                                                            'nome' => 'Magiletta',
                                                            'unita_misura' => 'pz',
                                                            'sconto' => 0,
                                                            'iva_importo' => 22,
                                                            'iva_name' => ''
                                                            )
                                                       ),
                                  "pagamento" => array(
                                                      array("importo"=>71.98,
                                                            "id_cashregister_pagamento"=>"xxxxxxxx",
                                                            "valuta" => "xxxxxxxx",                                              
                                                            )
                                                       )
                           )
                  )              
            );

$client = new \GuzzleHttp\Client();
$response = $client->request('POST', $url, [
    'form_params' => $form_params
]);
$response = json_decode($response->getBody()->getContents(),true);
?>

Request

<?php
$url = "https://app.winddoc.com/v1/api_json.php";
$token_app = "XXXXX";
$token = "XXXXXX";

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => $url,
    CURLOPT_POST => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_FAILONERROR => true,
    CURLOPT_POSTFIELDS => http_build_query($form_params),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,    
    CURLOPT_HTTPHEADER => [
        "Accept: application/json"
    ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
?>

Request

import requests
url = "https://app.winddoc.com/v1/api_json.php"
token = "XXXXX"
token_app = "XXXXX"
data = {
    "method": "cashregister_aggiungiScontrino",
    "request": {
        "token_key": {
            "token": token,
            "token_app": token_app
            },
        "params": {'id_cashregister' : 'xxxxxxxx',
                                  "valuta" : "xxxxxxxx",
                                  "prodotti" : array(
                                                      array('importo_totale_iva' : 71.98,
                                                            'importo_totale' : 59.00,
                                                            'quantita' : 1,
                                                            'prezzo_netto' : 59.00,
                                                            'codice' : 'MG001',
                                                            'nome' : 'Magiletta',
                                                            'unita_misura' : 'pz',
                                                            'sconto' : 0,
                                                            'iva_importo' : 22,
                                                            'iva_name' : ''
                                                            
                                                       ,
                                  "pagamento" : array(
                                                      array("importo":71.98,
                                                            "id_cashregister_pagamento":"xxxxxxxx",
                                                            "valuta" : "xxxxxxxx",                                              
                                                            
                                                       
                                   }
    }
response = requests.post(url, json=data)
if response.status_code == 200:
    response_data = response.json() # Parse the JSON response
else:
    print(f"Error: {response.status_code} - {response.text}")
exit(1)