Customers¶

public async Task<Customer> GetCustomerAsync(string companyId, string customerId)
{
    var url = $"{_baseUrl}/entity/customers/{companyId}_{customerId}";
    var response = await _httpClient.GetAsync(url);
    response.EnsureSuccessStatusCode();

    var xml = await response.Content.ReadAsStringAsync();
    var serializer = new XmlSerializer(typeof(Customer));
    using var reader = new StringReader(xml);
    return (Customer)serializer.Deserialize(reader);
}

public async Task<Customer> GetNewCustomerTemplateAsync()
{
    var response = await _httpClient.GetAsync($"{_baseUrl}/entity/customers/new");
    response.EnsureSuccessStatusCode();

    var xml = await response.Content.ReadAsStringAsync();
    var serializer = new XmlSerializer(typeof(Customer));
    using var reader = new StringReader(xml);
    return (Customer)serializer.Deserialize(reader);
}

public async Task<Customer> CreateCustomerAsync(CustomerCreateRequest request)
{
    // Step 1: Always fetch the template first
    var template = await GetNewCustomerTemplateAsync();

    // Step 2: Populate required fields from your request
    template.customer_id   = request.CustomerId;
    template.customer_name = request.CustomerName;
    template.address1      = request.Address1;
    template.city          = request.City;
    template.state         = request.State;
    template.zip           = request.Zip;
    template.phone         = request.Phone;
    template.credit_limit  = request.CreditLimit;
    template.currency_id   = request.CurrencyId;
    template.terms_id      = request.TermsId;
    template.territory_id  = request.TerritoryId;

    // Step 3: Serialize and POST
    var serializer = new XmlSerializer(typeof(Customer));
    using var writer = new StringWriter();
    serializer.Serialize(writer, template);
    var xml = writer.ToString();

    var content = new StringContent(xml, Encoding.UTF8, "application/xml");
    var response = await _httpClient.PostAsync($"{_baseUrl}/entity/customers/", content);
    response.EnsureSuccessStatusCode();

    // Step 4: Deserialize and return created record
    var responseXml = await response.Content.ReadAsStringAsync();
    using var reader = new StringReader(responseXml);
    return (Customer)serializer.Deserialize(reader);
}

public async Task<Customer> UpdateCustomerAsync(string companyId, string customerId,
    Action<Customer> applyChanges)
{
    // Fetch the current record first
    var customer = await GetCustomerAsync(companyId, customerId);

    // Apply changes via a delegate
    applyChanges(customer);

    // Serialize and PUT
    var serializer = new XmlSerializer(typeof(Customer));
    using var writer = new StringWriter();
    serializer.Serialize(writer, customer);
    var xml = writer.ToString();

    var content = new StringContent(xml, Encoding.UTF8, "application/xml");
    var url = $"{_baseUrl}/entity/customers/{companyId}_{customerId}";
    var response = await _httpClient.PutAsync(url, content);
    response.EnsureSuccessStatusCode();

    var responseXml = await response.Content.ReadAsStringAsync();
    using var reader = new StringReader(responseXml);
    return (Customer)serializer.Deserialize(reader);
}