tools/sdk-php/crud-customer.md

metadata

title: CRUD Customer - Sage Intacct SDK for PHP | Sage Intacct Developer
url: https://developer.intacct.com/tools/sdk-php/crud-customer/

CRUD Customer - Sage Intacct SDK for PHP | Sage Intacct Developer

Overview

Getting Started

List AR Invoices

List Vendors (Legacy)

CRUD Customer

Custom Object Function

Troubleshooting

• Prerequisites
• Run the example
• Extra credit
  • Get a customer by name
  • Try a different object
• What’s next?

---

This example shows you how to:

• Create a customer
• Read a customer
• Update a customer
• Delete a customer

---

Prerequisites

• You have downloaded or cloned the Sage Intacct SDK for PHP examples.
• You successfully ran the getting started example—in particular, you set up the .credentials.ini file required by bootstrap.php.
• The user you are using has add, edit, delete, list, and view permissions for the customer object.

---

Run the example

1. Run the crud-customer.php file:

   php crud-customer.php
   

2. Observe the terminal output.

   Information is echoed for each customer API function executed:

   Created inactive customer ID 10066
   Updated customer ID 10066 to active
   Read customer ID 10066
   Deleted customer ID 10066
      
   Process finished with exit code 0
   

3. Open the generated logs/intacct.html file in your browser and review the entries.

   The file provides info and debug entries. The SDK provides a debug entry for each HTTP request/response (with the Sage Intacct endpoint).

   Note that the log file was created by the logger set in the client config.

---

Extra credit

Get a customer by name

1. Execute a ReadByName function (instead of Read):

   $readByName = new ReadByName();
   $readByName->setObjectName('CUSTOMER');
   $readByName->setFields([
       'RECORDNO',
       'CUSTOMERID',
       'STATUS',
   ]);
   $readByName->setNames([
       $customerId,
   ]);
   $response = $client->execute($readByName);
   echo "Read customer ID $customerId using ReadByName" .  PHP_EOL;
   

Try a different object

1. Try a different object’s CRUD functions from the Intacct\Functions\ namespace.

---

What’s next?

• Try an example that implements the FunctionInterface for use with a custom object.
• Browse the reference documentation for the SDK.

Provide feedback