Create or Update Asset Batch Data

Use this endpoint to create or update asset batch data. An asset batch represents a product (asset class) along with a batch or lot number. The data and documents contained on an asset batch record can be accessed regardless of where batches are located.

Outcome

The result of the API is to create or update an asset batch.

Endpoint

https://tracapi.com/api.v2/batch/

Fields/Parameters

Fields/Parameter Value
auth_key Your api key "blockchain address:secret key" assigned for the location receiving the product Required
gtin The globally unique item number of the product. Usually GTIN or UPC code. Required
lot Lot number, batch number, or serial number of the product. Required
data Optional data related to the item, purchase order, shipment that will be returned in a trace if included. Data must be formatted as a JSON object. Optional

Test it

Sample Code - PHP/Curl

<?php

$auth_key=$_POST['auth_key'];
$gtin=$_POST['gtin'];
$lot=$_POST['lot'];
$data=$_POST['data'];
$documents=$_POST['documents'];

//URL of the endpoint.
$url = 'https://tracapi.com/api.v2/batch/';

//Create an array of POST data to be sent to the endpoint.
$fields = array(
'auth_key' => $auth_key,
'gtin' => $gtin,
'lot' => $lot,
'data' => $data,
'documents' => $documents);

//url-ify the data for the POST
foreach($fields as $key=>$value) { $fields_string .= $key.'='.$value.'&'; }
rtrim($fields_string, '&');

//open connection
$ch = curl_init();

//set the url, number of POST vars, POST data
curl_setopt($ch,CURLOPT_URL, $url);
curl_setopt($ch,CURLOPT_POST, count($fields));
curl_setopt($ch,CURLOPT_POSTFIELDS, $fields_string);
curl_setopt($ch,CURLOPT_RETURNTRANSFER,true);

//execute post
$result = curl_exec($ch);

//echo the result
echo $result;

//close connection
curl_close($ch);
?>