All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.zuora.model.DebitMemoItemFromChargeDetail Maven / Gradle / Ivy

There is a newer version: 3.2.1
Show newest version
/*
 * Zuora API Reference
 * REST API reference for the Zuora Billing, Payments, and Central Platform! Check out the [REST API Overview](https://www.zuora.com/developer/api-references/api/overview/).
 *
 * The version of the OpenAPI document: 2024-05-20
 * Contact: [email protected]
 *
 * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
 * https://openapi-generator.tech
 * Do not edit the class manually.
 */


package com.zuora.model;

import java.util.Objects;
import com.google.gson.TypeAdapter;
import com.google.gson.annotations.JsonAdapter;
import com.google.gson.annotations.SerializedName;
import com.google.gson.stream.JsonReader;
import com.google.gson.stream.JsonWriter;
import com.zuora.model.DebitMemoItemFromChargeDetailFinanceInformation;
import java.io.IOException;
import java.math.BigDecimal;
import java.time.LocalDate;
import java.util.Arrays;

import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import com.google.gson.JsonArray;
import com.google.gson.JsonDeserializationContext;
import com.google.gson.JsonDeserializer;
import com.google.gson.JsonElement;
import com.google.gson.JsonObject;
import com.google.gson.JsonParseException;
import com.google.gson.TypeAdapterFactory;
import com.google.gson.reflect.TypeToken;
import com.google.gson.TypeAdapter;
import com.google.gson.stream.JsonReader;
import com.google.gson.stream.JsonWriter;
import java.io.IOException;

import java.util.HashMap;
import java.util.HashSet;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import java.util.Set;

import com.zuora.JSON;

/**
 * DebitMemoItemFromChargeDetail
 */
@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.6.0")
public class DebitMemoItemFromChargeDetail {
  public static final String SERIALIZED_NAME_AMOUNT = "amount";
  @SerializedName(SERIALIZED_NAME_AMOUNT)
  private BigDecimal amount;

  public static final String SERIALIZED_NAME_CHARGE_ID = "chargeId";
  @Deprecated
  @SerializedName(SERIALIZED_NAME_CHARGE_ID)
  private String chargeId;

  public static final String SERIALIZED_NAME_COMMENT = "comment";
  @Deprecated
  @SerializedName(SERIALIZED_NAME_COMMENT)
  private String comment;

  public static final String SERIALIZED_NAME_DESCRIPTION = "description";
  @SerializedName(SERIALIZED_NAME_DESCRIPTION)
  private String description;

  public static final String SERIALIZED_NAME_FINANCE_INFORMATION = "financeInformation";
  @SerializedName(SERIALIZED_NAME_FINANCE_INFORMATION)
  private DebitMemoItemFromChargeDetailFinanceInformation financeInformation;

  public static final String SERIALIZED_NAME_MEMO_ITEM_AMOUNT = "memoItemAmount";
  @Deprecated
  @SerializedName(SERIALIZED_NAME_MEMO_ITEM_AMOUNT)
  private BigDecimal memoItemAmount;

  public static final String SERIALIZED_NAME_PRODUCT_RATE_PLAN_CHARGE_ID = "productRatePlanChargeId";
  @SerializedName(SERIALIZED_NAME_PRODUCT_RATE_PLAN_CHARGE_ID)
  private String productRatePlanChargeId;

  public static final String SERIALIZED_NAME_QUANTITY = "quantity";
  @SerializedName(SERIALIZED_NAME_QUANTITY)
  private BigDecimal quantity;

  public static final String SERIALIZED_NAME_SERVICE_END_DATE = "serviceEndDate";
  @SerializedName(SERIALIZED_NAME_SERVICE_END_DATE)
  private LocalDate serviceEndDate;

  public static final String SERIALIZED_NAME_SERVICE_START_DATE = "serviceStartDate";
  @SerializedName(SERIALIZED_NAME_SERVICE_START_DATE)
  private LocalDate serviceStartDate;

  public static final String SERIALIZED_NAME_EXCLUDE_ITEM_BILLING_FROM_REVENUE_ACCOUNTING = "excludeItemBillingFromRevenueAccounting";
  @SerializedName(SERIALIZED_NAME_EXCLUDE_ITEM_BILLING_FROM_REVENUE_ACCOUNTING)
  private Boolean excludeItemBillingFromRevenueAccounting;

  public DebitMemoItemFromChargeDetail() {
  }

  public DebitMemoItemFromChargeDetail amount(BigDecimal amount) {
    this.amount = amount;
    return this;
  }

  /**
   * The amount of the debit memo item.  **Note**: This field is only available if you set the `zuora-version` request header to `224.0` or later.
   * @return amount
   */
  @javax.annotation.Nullable
  public BigDecimal getAmount() {
    return amount;
  }

  public void setAmount(BigDecimal amount) {
    this.amount = amount;
  }


  @Deprecated
  public DebitMemoItemFromChargeDetail chargeId(String chargeId) {
    this.chargeId = chargeId;
    return this;
  }

  /**
   * The ID of the product rate plan charge that the debit memo is created from.  **Note**: This field is not available if you set the `zuora-version` request header to `257.0` or later.
   * @return chargeId
   * @deprecated
   */
  @Deprecated
  @javax.annotation.Nonnull
  public String getChargeId() {
    return chargeId;
  }

  @Deprecated
  public void setChargeId(String chargeId) {
    this.chargeId = chargeId;
  }


  @Deprecated
  public DebitMemoItemFromChargeDetail comment(String comment) {
    this.comment = comment;
    return this;
  }

  /**
   * Comments about the product rate plan charge.  **Note**: This field is not available if you set the `zuora-version` request header to `257.0` or before.
   * @return comment
   * @deprecated
   */
  @Deprecated
  @javax.annotation.Nullable
  public String getComment() {
    return comment;
  }

  @Deprecated
  public void setComment(String comment) {
    this.comment = comment;
  }


  public DebitMemoItemFromChargeDetail description(String description) {
    this.description = description;
    return this;
  }

  /**
   * The description of the product rate plan charge.  **Note**: This field is only available if you set the `zuora-version` request header to `257.0` or later.
   * @return description
   */
  @javax.annotation.Nullable
  public String getDescription() {
    return description;
  }

  public void setDescription(String description) {
    this.description = description;
  }


  public DebitMemoItemFromChargeDetail financeInformation(DebitMemoItemFromChargeDetailFinanceInformation financeInformation) {
    this.financeInformation = financeInformation;
    return this;
  }

  /**
   * Get financeInformation
   * @return financeInformation
   */
  @javax.annotation.Nullable
  public DebitMemoItemFromChargeDetailFinanceInformation getFinanceInformation() {
    return financeInformation;
  }

  public void setFinanceInformation(DebitMemoItemFromChargeDetailFinanceInformation financeInformation) {
    this.financeInformation = financeInformation;
  }


  @Deprecated
  public DebitMemoItemFromChargeDetail memoItemAmount(BigDecimal memoItemAmount) {
    this.memoItemAmount = memoItemAmount;
    return this;
  }

  /**
   * The amount of the debit memo item.  **Note**: This field is not available if you set the `zuora-version` request header to `224.0` or later.
   * @return memoItemAmount
   * @deprecated
   */
  @Deprecated
  @javax.annotation.Nullable
  public BigDecimal getMemoItemAmount() {
    return memoItemAmount;
  }

  @Deprecated
  public void setMemoItemAmount(BigDecimal memoItemAmount) {
    this.memoItemAmount = memoItemAmount;
  }


  public DebitMemoItemFromChargeDetail productRatePlanChargeId(String productRatePlanChargeId) {
    this.productRatePlanChargeId = productRatePlanChargeId;
    return this;
  }

  /**
   * The ID of the product rate plan charge that the debit memo is created from.  **Note**: This field is only available if you set the `zuora-version` request header to `257.0` or later.
   * @return productRatePlanChargeId
   */
  @javax.annotation.Nonnull
  public String getProductRatePlanChargeId() {
    return productRatePlanChargeId;
  }

  public void setProductRatePlanChargeId(String productRatePlanChargeId) {
    this.productRatePlanChargeId = productRatePlanChargeId;
  }


  public DebitMemoItemFromChargeDetail quantity(BigDecimal quantity) {
    this.quantity = quantity;
    return this;
  }

  /**
   * The number of units for the debit memo item.
   * @return quantity
   */
  @javax.annotation.Nullable
  public BigDecimal getQuantity() {
    return quantity;
  }

  public void setQuantity(BigDecimal quantity) {
    this.quantity = quantity;
  }


  public DebitMemoItemFromChargeDetail serviceEndDate(LocalDate serviceEndDate) {
    this.serviceEndDate = serviceEndDate;
    return this;
  }

  /**
   * The service end date of the debit memo item. If not specified, the effective end date of the corresponding product rate plan will be used.
   * @return serviceEndDate
   */
  @javax.annotation.Nullable
  public LocalDate getServiceEndDate() {
    return serviceEndDate;
  }

  public void setServiceEndDate(LocalDate serviceEndDate) {
    this.serviceEndDate = serviceEndDate;
  }


  public DebitMemoItemFromChargeDetail serviceStartDate(LocalDate serviceStartDate) {
    this.serviceStartDate = serviceStartDate;
    return this;
  }

  /**
   * The service start date of the debit memo item. If not specified, the effective start date of the corresponding product rate plan will be used.
   * @return serviceStartDate
   */
  @javax.annotation.Nullable
  public LocalDate getServiceStartDate() {
    return serviceStartDate;
  }

  public void setServiceStartDate(LocalDate serviceStartDate) {
    this.serviceStartDate = serviceStartDate;
  }


  public DebitMemoItemFromChargeDetail excludeItemBillingFromRevenueAccounting(Boolean excludeItemBillingFromRevenueAccounting) {
    this.excludeItemBillingFromRevenueAccounting = excludeItemBillingFromRevenueAccounting;
    return this;
  }

  /**
   * The flag to exclude the debit memo item from revenue accounting.  **Note**: This field is only available if you have the Billing - Revenue Integration feature enabled. 
   * @return excludeItemBillingFromRevenueAccounting
   */
  @javax.annotation.Nullable
  public Boolean getExcludeItemBillingFromRevenueAccounting() {
    return excludeItemBillingFromRevenueAccounting;
  }

  public void setExcludeItemBillingFromRevenueAccounting(Boolean excludeItemBillingFromRevenueAccounting) {
    this.excludeItemBillingFromRevenueAccounting = excludeItemBillingFromRevenueAccounting;
  }

  /**
   * A container for additional, undeclared properties.
   * This is a holder for any undeclared properties as specified with
   * the 'additionalProperties' keyword in the OAS document.
   */
  private Map additionalProperties;

  /**
   * Set the additional (undeclared) property with the specified name and value.
   * If the property does not already exist, create it otherwise replace it.
   *
   * @param key name of the property
   * @param value value of the property
   * @return the DebitMemoItemFromChargeDetail instance itself
   */
  public DebitMemoItemFromChargeDetail putAdditionalProperty(String key, Object value) {
    if (this.additionalProperties == null) {
        this.additionalProperties = new HashMap();
    }
    this.additionalProperties.put(key, value);
    return this;
  }

  /**
   * Return the additional (undeclared) property.
   *
   * @return a map of objects
   */
  public Map getAdditionalProperties() {
    return additionalProperties;
  }

  /**
   * Return the additional (undeclared) property with the specified name.
   *
   * @param key name of the property
   * @return an object
   */
  public Object getAdditionalProperty(String key) {
    if (this.additionalProperties == null) {
        return null;
    }
    return this.additionalProperties.get(key);
  }


  @Override
  public boolean equals(Object o) {
    if (this == o) {
      return true;
    }
    if (o == null || getClass() != o.getClass()) {
      return false;
    }
    DebitMemoItemFromChargeDetail debitMemoItemFromChargeDetail = (DebitMemoItemFromChargeDetail) o;
    return Objects.equals(this.amount, debitMemoItemFromChargeDetail.amount) &&
        Objects.equals(this.chargeId, debitMemoItemFromChargeDetail.chargeId) &&
        Objects.equals(this.comment, debitMemoItemFromChargeDetail.comment) &&
        Objects.equals(this.description, debitMemoItemFromChargeDetail.description) &&
        Objects.equals(this.financeInformation, debitMemoItemFromChargeDetail.financeInformation) &&
        Objects.equals(this.memoItemAmount, debitMemoItemFromChargeDetail.memoItemAmount) &&
        Objects.equals(this.productRatePlanChargeId, debitMemoItemFromChargeDetail.productRatePlanChargeId) &&
        Objects.equals(this.quantity, debitMemoItemFromChargeDetail.quantity) &&
        Objects.equals(this.serviceEndDate, debitMemoItemFromChargeDetail.serviceEndDate) &&
        Objects.equals(this.serviceStartDate, debitMemoItemFromChargeDetail.serviceStartDate) &&
        Objects.equals(this.excludeItemBillingFromRevenueAccounting, debitMemoItemFromChargeDetail.excludeItemBillingFromRevenueAccounting)&&
        Objects.equals(this.additionalProperties, debitMemoItemFromChargeDetail.additionalProperties);
  }

  @Override
  public int hashCode() {
    return Objects.hash(amount, chargeId, comment, description, financeInformation, memoItemAmount, productRatePlanChargeId, quantity, serviceEndDate, serviceStartDate, excludeItemBillingFromRevenueAccounting, additionalProperties);
  }

  @Override
  public String toString() {
    StringBuilder sb = new StringBuilder();
    sb.append("class DebitMemoItemFromChargeDetail {\n");
    sb.append("    amount: ").append(toIndentedString(amount)).append("\n");
    sb.append("    chargeId: ").append(toIndentedString(chargeId)).append("\n");
    sb.append("    comment: ").append(toIndentedString(comment)).append("\n");
    sb.append("    description: ").append(toIndentedString(description)).append("\n");
    sb.append("    financeInformation: ").append(toIndentedString(financeInformation)).append("\n");
    sb.append("    memoItemAmount: ").append(toIndentedString(memoItemAmount)).append("\n");
    sb.append("    productRatePlanChargeId: ").append(toIndentedString(productRatePlanChargeId)).append("\n");
    sb.append("    quantity: ").append(toIndentedString(quantity)).append("\n");
    sb.append("    serviceEndDate: ").append(toIndentedString(serviceEndDate)).append("\n");
    sb.append("    serviceStartDate: ").append(toIndentedString(serviceStartDate)).append("\n");
    sb.append("    excludeItemBillingFromRevenueAccounting: ").append(toIndentedString(excludeItemBillingFromRevenueAccounting)).append("\n");
    sb.append("    additionalProperties: ").append(toIndentedString(additionalProperties)).append("\n");
    sb.append("}");
    return sb.toString();
  }

  /**
   * Convert the given object to string with each line indented by 4 spaces
   * (except the first line).
   */
  private String toIndentedString(Object o) {
    if (o == null) {
      return "null";
    }
    return o.toString().replace("\n", "\n    ");
  }


  public static HashSet openapiFields;
  public static HashSet openapiRequiredFields;

  static {
    // a set of all properties/fields (JSON key names)
    openapiFields = new HashSet();
    openapiFields.add("amount");
    openapiFields.add("chargeId");
    openapiFields.add("comment");
    openapiFields.add("description");
    openapiFields.add("financeInformation");
    openapiFields.add("memoItemAmount");
    openapiFields.add("productRatePlanChargeId");
    openapiFields.add("quantity");
    openapiFields.add("serviceEndDate");
    openapiFields.add("serviceStartDate");
    openapiFields.add("excludeItemBillingFromRevenueAccounting");

    // a set of required properties/fields (JSON key names)
    openapiRequiredFields = new HashSet();
    openapiRequiredFields.add("chargeId");
    openapiRequiredFields.add("productRatePlanChargeId");
  }

  /**
   * Validates the JSON Element and throws an exception if issues found
   *
   * @param jsonElement JSON Element
   * @throws IOException if the JSON Element is invalid with respect to DebitMemoItemFromChargeDetail
   */
  public static void validateJsonElement(JsonElement jsonElement) throws IOException {
      if (jsonElement == null) {
        if (!DebitMemoItemFromChargeDetail.openapiRequiredFields.isEmpty()) { // has required fields but JSON element is null
          throw new IllegalArgumentException(String.format("The required field(s) %s in DebitMemoItemFromChargeDetail is not found in the empty JSON string", DebitMemoItemFromChargeDetail.openapiRequiredFields.toString()));
        }
      }

      // check to make sure all required properties/fields are present in the JSON string
      for (String requiredField : DebitMemoItemFromChargeDetail.openapiRequiredFields) {
        if (jsonElement.getAsJsonObject().get(requiredField) == null) {
          throw new IllegalArgumentException(String.format("The required field `%s` is not found in the JSON string: %s", requiredField, jsonElement.toString()));
        }
      }
        JsonObject jsonObj = jsonElement.getAsJsonObject();
      if (!jsonObj.get("chargeId").isJsonPrimitive()) {
        throw new IllegalArgumentException(String.format("Expected the field `chargeId` to be a primitive type in the JSON string but got `%s`", jsonObj.get("chargeId").toString()));
      }
      if ((jsonObj.get("comment") != null && !jsonObj.get("comment").isJsonNull()) && !jsonObj.get("comment").isJsonPrimitive()) {
        throw new IllegalArgumentException(String.format("Expected the field `comment` to be a primitive type in the JSON string but got `%s`", jsonObj.get("comment").toString()));
      }
      if ((jsonObj.get("description") != null && !jsonObj.get("description").isJsonNull()) && !jsonObj.get("description").isJsonPrimitive()) {
        throw new IllegalArgumentException(String.format("Expected the field `description` to be a primitive type in the JSON string but got `%s`", jsonObj.get("description").toString()));
      }
      // validate the optional field `financeInformation`
      if (jsonObj.get("financeInformation") != null && !jsonObj.get("financeInformation").isJsonNull()) {
        DebitMemoItemFromChargeDetailFinanceInformation.validateJsonElement(jsonObj.get("financeInformation"));
      }
      if (!jsonObj.get("productRatePlanChargeId").isJsonPrimitive()) {
        throw new IllegalArgumentException(String.format("Expected the field `productRatePlanChargeId` to be a primitive type in the JSON string but got `%s`", jsonObj.get("productRatePlanChargeId").toString()));
      }
  }

  public static class CustomTypeAdapterFactory implements TypeAdapterFactory {
    @SuppressWarnings("unchecked")
    @Override
    public  TypeAdapter create(Gson gson, TypeToken type) {
       if (!DebitMemoItemFromChargeDetail.class.isAssignableFrom(type.getRawType())) {
         return null; // this class only serializes 'DebitMemoItemFromChargeDetail' and its subtypes
       }
       final TypeAdapter elementAdapter = gson.getAdapter(JsonElement.class);
       final TypeAdapter thisAdapter
                        = gson.getDelegateAdapter(this, TypeToken.get(DebitMemoItemFromChargeDetail.class));

       return (TypeAdapter) new TypeAdapter() {
           @Override
           public void write(JsonWriter out, DebitMemoItemFromChargeDetail value) throws IOException {
             JsonObject obj = thisAdapter.toJsonTree(value).getAsJsonObject();
             obj.remove("additionalProperties");

             // support null values
             out.beginObject();
             Iterator iterator = obj.entrySet().iterator();
             while(iterator.hasNext()) {
                 Map.Entry e = (Map.Entry) iterator.next();
                 out.name((String)e.getKey());
                 elementAdapter.write(out, e.getValue());
             }

             // end

             // serialize additional properties
             if (value.getAdditionalProperties() != null) {
               // support null values
               boolean oldSerializeNulls = out.getSerializeNulls();
               out.setSerializeNulls(true); //force serialize
               // end
               for (Map.Entry entry : value.getAdditionalProperties().entrySet()) {
                 if (entry.getValue() instanceof String)
                   obj.addProperty(entry.getKey(), (String) entry.getValue());
                 else if (entry.getValue() instanceof Number)
                   obj.addProperty(entry.getKey(), (Number) entry.getValue());
                 else if (entry.getValue() instanceof Boolean)
                   obj.addProperty(entry.getKey(), (Boolean) entry.getValue());
                 else if (entry.getValue() instanceof Character)
                   obj.addProperty(entry.getKey(), (Character) entry.getValue());
                 else if (entry.getValue() == null)
                    obj.add(entry.getKey(), null);
                 else {
                   JsonElement jsonElement = gson.toJsonTree(entry.getValue());
                   if (jsonElement.isJsonArray()) {
                     obj.add(entry.getKey(), jsonElement.getAsJsonArray());
                   } else {
                     obj.add(entry.getKey(), jsonElement.getAsJsonObject());
                   }
                 }
                 out.name((String)entry.getKey());
                 elementAdapter.write(out, obj.get(entry.getKey()));
               }
               out.setSerializeNulls(oldSerializeNulls); //restore
             }
             out.endObject();

           }

           @Override
           public DebitMemoItemFromChargeDetail read(JsonReader in) throws IOException {
             JsonElement jsonElement = elementAdapter.read(in);
             validateJsonElement(jsonElement);
             JsonObject jsonObj = jsonElement.getAsJsonObject();
             // store additional fields in the deserialized instance
             DebitMemoItemFromChargeDetail instance = thisAdapter.fromJsonTree(jsonObj);
             for (Map.Entry entry : jsonObj.entrySet()) {
               if (!openapiFields.contains(entry.getKey())) {
                 if (entry.getValue().isJsonPrimitive()) { // primitive type
                   if (entry.getValue().getAsJsonPrimitive().isString())
                     instance.putAdditionalProperty(entry.getKey(), entry.getValue().getAsString());
                   else if (entry.getValue().getAsJsonPrimitive().isNumber())
                     instance.putAdditionalProperty(entry.getKey(), entry.getValue().getAsNumber());
                   else if (entry.getValue().getAsJsonPrimitive().isBoolean())
                     instance.putAdditionalProperty(entry.getKey(), entry.getValue().getAsBoolean());
                   else
                     throw new IllegalArgumentException(String.format("The field `%s` has unknown primitive type. Value: %s", entry.getKey(), entry.getValue().toString()));
                 } else if (entry.getValue().isJsonArray()) {
                     instance.putAdditionalProperty(entry.getKey(), gson.fromJson(entry.getValue(), List.class));
                 } else { // JSON object
                     instance.putAdditionalProperty(entry.getKey(), gson.fromJson(entry.getValue(), HashMap.class));
                 }
               }
             }
             return instance;
           }

       }.nullSafe();
    }
  }

  /**
   * Create an instance of DebitMemoItemFromChargeDetail given an JSON string
   *
   * @param jsonString JSON string
   * @return An instance of DebitMemoItemFromChargeDetail
   * @throws IOException if the JSON string is invalid with respect to DebitMemoItemFromChargeDetail
   */
  public static DebitMemoItemFromChargeDetail fromJson(String jsonString) throws IOException {
    return JSON.getGson().fromJson(jsonString, DebitMemoItemFromChargeDetail.class);
  }

  /**
   * Convert an instance of DebitMemoItemFromChargeDetail to an JSON string
   *
   * @return JSON string
   */
  public String toJson() {
    return JSON.getGson().toJson(this);
  }
}





© 2015 - 2025 Weber Informatics LLC | Privacy Policy