Search by Contract Number

<?php

// Load Enneo SDK. Input is made available through $in
use EnneoSDK\ApiEnneo;
use EnneoSDK\Setting;
use EnneoSDK\Api;
require(getenv()['SDK']);

$contractId = $in->contractId; // Populated with the data received, e.g. 1234 or "C-212"

// You can call your API and/or add your data processing logic here

// Option 1: Directly
// $contractRawData = Api::call(method: 'POST',url: 'https://xxx', headers: ['Authorization: AbC'], params: http_build_query(['contractId' => $contractId]));
$contractRawData = Api::call(method: 'GET', url: 'https://admin.enneo.ai/api/seed-contracts/' . $contractId);

// Option 2: Through a user-defined-function that handles e.g. OAuth2 session tokens
// $contractRawData = ApiEnneo::executeUdf('erpApiCall', ["method" => "GET", "api" => "vertrag/$contractId", "params" => false]);

// Option 3: By using Enneo user storage object as a database (only recommended for testing)
// $userDataObject = Setting::get('udfStorage');
// $contractRawData = array_search($contractId, array_column($userDataObject->contracts, 'contractId')) or throw new Exception("Contract $contractId not found");

// This is the data format you should return
$contract = [
    // Mandatory properties. Must be defined for Enneo to function
    'id' => $contractId, // must be an integer or string up to 50 characters
    'customerId' => $contractRawData->customerId, // must be an integer or string up to 50 characters
    'business' => $contractRawData->processedData->business, // boolean, indicating whether the customer is a company or individual
    'lastname' => $contractRawData->processedData->lastname, // customer's last name, can be null ONLY if business is true
    'company' => $contractRawData->processedData->company, // company name, e.g. "ACME Corp.", can be null ONLY if business is false

    // Recommended properties. Should be defined if possible and is used by Enneo's AI and customer identification logic. Default to null if not set
    'firstname' => $contractRawData->processedData->firstname, // customer's first name, can be null
    'email' => $contractRawData->processedData->email,
    'deliveryAddress' => $contractRawData->processedData->deliveryAddress, // customer's address
    'billingAddress' => $contractRawData->processedData->billingAddress, // Optional separate billing address. If null, billing address is the same as delivery address
    'letterAddress' => ($contractRawData->processedData->company ?: $contractRawData->processedData->firstname.' '.$contractRawData->processedData->lastname).', '.($contractRawData->processedData->billingAddress ?? $contractRawData->processedData->deliveryAddress),
    'phone' => $contractRawData->processedData->phone,

    // Preview section for the agent that is shown in the top right corner on ticket page
    'agentPreview' => array_map(function($item) {
        return [
            'url' => $item->url, // e.g. "https://my-erp/customers/1234#tab=billing"
            'type' => $item->type, // e.g. "string"
            'label' => $item->label, // e.g. "Installment"
            'value' => $item->value, // e.g. "39 €"
            'tooltip' => $item->tooltip, // e.g. "As of January 1, 2025"
        ];
    }, $contractRawData->processedData->agentPreview),

    // Links to any systems holding client data you want your agents to have quick access to
    'erpUrls' => [
        [
            'url' => 'https://my-erp.com/contract-details/1234',
            'icon' => '/icons/powercloud.svg'
        ],
        [
            'url' => 'https://my-marketing-crm.com/customer-details/c123',
            'icon' => '/icons/link.svg'
        ]
    ],
    'erpUrls' => array_map(function($item) {
        return [
            'url' => $item->url, // e.g. "https://sap.example.com/contracts/100001"
            'icon' => $item->icon, // e.g. "/icons/sap.svg",
            'title' => $item->title, // e.g. SAP
        ];
    }, $contractRawData->processedData->erpUrls),
];

// Any other properties that you want Enneo to be aware of can be defined here. 
$contract = [
    ...$contract,
    ...array_diff_key((array) $contractRawData->processedData, $contract)
];

echo json_encode($contract);