client.channels.list() -> ListChannelsResponseclient.channels.bulkRetrieve(request) -> BulkRetrieveChannelsResponseclient.channels.get(channelId) -> RetrieveChannelResponseclient.vendors.batchCreate(request) -> BatchCreateVendorsResponseclient.transferOrders.create(request) -> CreateTransferOrderResponseclient.transferOrders.search(request) -> SearchTransferOrdersResponseclient.transferOrders.get(transferOrderId) -> RetrieveTransferOrderResponseclient.transferOrders.update(transferOrderId, request) -> UpdateTransferOrderResponseclient.transferOrders.delete(transferOrderId) -> DeleteTransferOrderResponseclient.transferOrders.cancel(transferOrderId, request) -> CancelTransferOrderResponseclient.transferOrders.receive(transferOrderId, request) -> ReceiveTransferOrderResponseclient.transferOrders.start(transferOrderId, request) -> StartTransferOrderResponseclient.vendors.batchCreate(request) -> BatchCreateVendorsResponseclient.loyalty.programs.promotions.get(promotionId, programId) -> GetLoyaltyPromotionResponseclient.loyalty.programs.promotions.get(programId, promotionId) -> GetLoyaltyPromotionResponseclient.loyalty.programs.promotions.cancel(promotionId, programId) -> CancelLoyaltyPromotionResponseclient.loyalty.programs.promotions.cancel(programId, promotionId) -> CancelLoyaltyPromotionResponseIn DRAFT status, you can:
+ *The request requires source_location_id and destination_location_id. + * Inventory levels are not affected until the order is started via + * StartTransferOrder.
+ *Common integration points:
+ *Creates a transfer_order.created webhook event.
+ */ + public CompletableFutureIn DRAFT status, you can:
+ *The request requires source_location_id and destination_location_id. + * Inventory levels are not affected until the order is started via + * StartTransferOrder.
+ *Common integration points:
+ *Creates a transfer_order.created webhook event.
+ */ + public CompletableFutureCommon search scenarios:
+ *Common search scenarios:
+ *Common search scenarios:
+ *Creates a transfer_order.updated webhook event.
+ */ + public CompletableFutureCreates a transfer_order.updated webhook event.
+ */ + public CompletableFutureCreates a transfer_order.deleted webhook event.
+ */ + public CompletableFutureCreates a transfer_order.deleted webhook event.
+ */ + public CompletableFutureCommon reasons for cancellation:
+ *Creates a transfer_order.updated webhook event.
+ */ + public CompletableFutureCommon reasons for cancellation:
+ *Creates a transfer_order.updated webhook event.
+ */ + public CompletableFutureFor each line item, you can specify:
+ *The order must be in STARTED or PARTIALLY_RECEIVED status. + * Received quantities are added to the destination Location's inventory according to their condition. + * Canceled quantities are immediately returned to the source Location's inventory.
+ *When all items are either received, damaged, or canceled, the order moves to + * COMPLETED status.
+ *Creates a transfer_order.updated webhook event.
+ */ + public CompletableFutureFor each line item, you can specify:
+ *The order must be in STARTED or PARTIALLY_RECEIVED status. + * Received quantities are added to the destination Location's inventory according to their condition. + * Canceled quantities are immediately returned to the source Location's inventory.
+ *When all items are either received, damaged, or canceled, the order moves to + * COMPLETED status.
+ *Creates a transfer_order.updated webhook event.
+ */ + public CompletableFutureThe order must be in DRAFT status and have all required fields populated. + * Once started, the order can no longer be deleted, but it can be canceled via + * CancelTransferOrder.
+ *Creates a transfer_order.updated webhook event.
+ */ + public CompletableFutureThe order must be in DRAFT status and have all required fields populated. + * Once started, the order can no longer be deleted, but it can be canceled via + * CancelTransferOrder.
+ *Creates a transfer_order.updated webhook event.
+ */ + public CompletableFutureIn DRAFT status, you can:
+ *The request requires source_location_id and destination_location_id. + * Inventory levels are not affected until the order is started via + * StartTransferOrder.
+ *Common integration points:
+ *Creates a transfer_order.created webhook event.
+ */ + public CompletableFutureIn DRAFT status, you can:
+ *The request requires source_location_id and destination_location_id. + * Inventory levels are not affected until the order is started via + * StartTransferOrder.
+ *Common integration points:
+ *Creates a transfer_order.created webhook event.
+ */ + public CompletableFutureCommon search scenarios:
+ *Common search scenarios:
+ *Common search scenarios:
+ *Creates a transfer_order.updated webhook event.
+ */ + public CompletableFutureCreates a transfer_order.updated webhook event.
+ */ + public CompletableFutureCreates a transfer_order.deleted webhook event.
+ */ + public CompletableFutureCreates a transfer_order.deleted webhook event.
+ */ + public CompletableFutureCommon reasons for cancellation:
+ *Creates a transfer_order.updated webhook event.
+ */ + public CompletableFutureCommon reasons for cancellation:
+ *Creates a transfer_order.updated webhook event.
+ */ + public CompletableFutureFor each line item, you can specify:
+ *The order must be in STARTED or PARTIALLY_RECEIVED status. + * Received quantities are added to the destination Location's inventory according to their condition. + * Canceled quantities are immediately returned to the source Location's inventory.
+ *When all items are either received, damaged, or canceled, the order moves to + * COMPLETED status.
+ *Creates a transfer_order.updated webhook event.
+ */ + public CompletableFutureFor each line item, you can specify:
+ *The order must be in STARTED or PARTIALLY_RECEIVED status. + * Received quantities are added to the destination Location's inventory according to their condition. + * Canceled quantities are immediately returned to the source Location's inventory.
+ *When all items are either received, damaged, or canceled, the order moves to + * COMPLETED status.
+ *Creates a transfer_order.updated webhook event.
+ */ + public CompletableFutureThe order must be in DRAFT status and have all required fields populated. + * Once started, the order can no longer be deleted, but it can be canceled via + * CancelTransferOrder.
+ *Creates a transfer_order.updated webhook event.
+ */ + public CompletableFutureThe order must be in DRAFT status and have all required fields populated. + * Once started, the order can no longer be deleted, but it can be canceled via + * CancelTransferOrder.
+ *Creates a transfer_order.updated webhook event.
+ */ + public CompletableFutureIn DRAFT status, you can:
+ *The request requires source_location_id and destination_location_id. + * Inventory levels are not affected until the order is started via + * StartTransferOrder.
+ *Common integration points:
+ *Creates a transfer_order.created webhook event.
+ */ + public SquareClientHttpResponseIn DRAFT status, you can:
+ *The request requires source_location_id and destination_location_id. + * Inventory levels are not affected until the order is started via + * StartTransferOrder.
+ *Common integration points:
+ *Creates a transfer_order.created webhook event.
+ */ + public SquareClientHttpResponseCommon search scenarios:
+ *Common search scenarios:
+ *Common search scenarios:
+ *Creates a transfer_order.updated webhook event.
+ */ + public SquareClientHttpResponseCreates a transfer_order.updated webhook event.
+ */ + public SquareClientHttpResponseCreates a transfer_order.deleted webhook event.
+ */ + public SquareClientHttpResponseCreates a transfer_order.deleted webhook event.
+ */ + public SquareClientHttpResponseCommon reasons for cancellation:
+ *Creates a transfer_order.updated webhook event.
+ */ + public SquareClientHttpResponseCommon reasons for cancellation:
+ *Creates a transfer_order.updated webhook event.
+ */ + public SquareClientHttpResponseFor each line item, you can specify:
+ *The order must be in STARTED or PARTIALLY_RECEIVED status. + * Received quantities are added to the destination Location's inventory according to their condition. + * Canceled quantities are immediately returned to the source Location's inventory.
+ *When all items are either received, damaged, or canceled, the order moves to + * COMPLETED status.
+ *Creates a transfer_order.updated webhook event.
+ */ + public SquareClientHttpResponseFor each line item, you can specify:
+ *The order must be in STARTED or PARTIALLY_RECEIVED status. + * Received quantities are added to the destination Location's inventory according to their condition. + * Canceled quantities are immediately returned to the source Location's inventory.
+ *When all items are either received, damaged, or canceled, the order moves to + * COMPLETED status.
+ *Creates a transfer_order.updated webhook event.
+ */ + public SquareClientHttpResponseThe order must be in DRAFT status and have all required fields populated. + * Once started, the order can no longer be deleted, but it can be canceled via + * CancelTransferOrder.
+ *Creates a transfer_order.updated webhook event.
+ */ + public SquareClientHttpResponseThe order must be in DRAFT status and have all required fields populated. + * Once started, the order can no longer be deleted, but it can be canceled via + * CancelTransferOrder.
+ *Creates a transfer_order.updated webhook event.
+ */ + public SquareClientHttpResponseIn DRAFT status, you can:
+ *The request requires source_location_id and destination_location_id. + * Inventory levels are not affected until the order is started via + * StartTransferOrder.
+ *Common integration points:
+ *Creates a transfer_order.created webhook event.
+ */ + public CreateTransferOrderResponse create(CreateTransferOrderRequest request) { + return this.rawClient.create(request).body(); + } + + /** + * Creates a new transfer order in DRAFT status. A transfer order represents the intent + * to move CatalogItemVariations from one Location to another. + * The source and destination locations must be different and must belong to your Square account. + *In DRAFT status, you can:
+ *The request requires source_location_id and destination_location_id. + * Inventory levels are not affected until the order is started via + * StartTransferOrder.
+ *Common integration points:
+ *Creates a transfer_order.created webhook event.
+ */ + public CreateTransferOrderResponse create(CreateTransferOrderRequest request, RequestOptions requestOptions) { + return this.rawClient.create(request, requestOptions).body(); + } + + /** + * Searches for transfer orders using filters. Returns a paginated list of matching + * TransferOrders sorted by creation date. + *Common search scenarios:
+ *Common search scenarios:
+ *Common search scenarios:
+ *Creates a transfer_order.updated webhook event.
+ */ + public UpdateTransferOrderResponse update(UpdateTransferOrderRequest request) { + return this.rawClient.update(request).body(); + } + + /** + * Updates an existing transfer order. This endpoint supports sparse updates, + * allowing you to modify specific fields without affecting others. + *Creates a transfer_order.updated webhook event.
+ */ + public UpdateTransferOrderResponse update(UpdateTransferOrderRequest request, RequestOptions requestOptions) { + return this.rawClient.update(request, requestOptions).body(); + } + + /** + * Deletes a transfer order in DRAFT status. + * Only draft orders can be deleted. Once an order is started via + * StartTransferOrder, it can no longer be deleted. + *Creates a transfer_order.deleted webhook event.
+ */ + public DeleteTransferOrderResponse delete(DeleteTransferOrdersRequest request) { + return this.rawClient.delete(request).body(); + } + + /** + * Deletes a transfer order in DRAFT status. + * Only draft orders can be deleted. Once an order is started via + * StartTransferOrder, it can no longer be deleted. + *Creates a transfer_order.deleted webhook event.
+ */ + public DeleteTransferOrderResponse delete(DeleteTransferOrdersRequest request, RequestOptions requestOptions) { + return this.rawClient.delete(request, requestOptions).body(); + } + + /** + * Cancels a transfer order in STARTED or + * PARTIALLY_RECEIVED status. Any unreceived quantities will no + * longer be receivable and will be immediately returned to the source Location's inventory. + *Common reasons for cancellation:
+ *Creates a transfer_order.updated webhook event.
+ */ + public CancelTransferOrderResponse cancel(CancelTransferOrderRequest request) { + return this.rawClient.cancel(request).body(); + } + + /** + * Cancels a transfer order in STARTED or + * PARTIALLY_RECEIVED status. Any unreceived quantities will no + * longer be receivable and will be immediately returned to the source Location's inventory. + *Common reasons for cancellation:
+ *Creates a transfer_order.updated webhook event.
+ */ + public CancelTransferOrderResponse cancel(CancelTransferOrderRequest request, RequestOptions requestOptions) { + return this.rawClient.cancel(request, requestOptions).body(); + } + + /** + * Records receipt of CatalogItemVariations for a transfer order. + * This endpoint supports partial receiving - you can receive items in multiple batches. + *For each line item, you can specify:
+ *The order must be in STARTED or PARTIALLY_RECEIVED status. + * Received quantities are added to the destination Location's inventory according to their condition. + * Canceled quantities are immediately returned to the source Location's inventory.
+ *When all items are either received, damaged, or canceled, the order moves to + * COMPLETED status.
+ *Creates a transfer_order.updated webhook event.
+ */ + public ReceiveTransferOrderResponse receive(ReceiveTransferOrderRequest request) { + return this.rawClient.receive(request).body(); + } + + /** + * Records receipt of CatalogItemVariations for a transfer order. + * This endpoint supports partial receiving - you can receive items in multiple batches. + *For each line item, you can specify:
+ *The order must be in STARTED or PARTIALLY_RECEIVED status. + * Received quantities are added to the destination Location's inventory according to their condition. + * Canceled quantities are immediately returned to the source Location's inventory.
+ *When all items are either received, damaged, or canceled, the order moves to + * COMPLETED status.
+ *Creates a transfer_order.updated webhook event.
+ */ + public ReceiveTransferOrderResponse receive(ReceiveTransferOrderRequest request, RequestOptions requestOptions) { + return this.rawClient.receive(request, requestOptions).body(); + } + + /** + * Changes a DRAFT transfer order to STARTED status. + * This decrements inventory at the source Location and marks it as in-transit. + *The order must be in DRAFT status and have all required fields populated. + * Once started, the order can no longer be deleted, but it can be canceled via + * CancelTransferOrder.
+ *Creates a transfer_order.updated webhook event.
+ */ + public StartTransferOrderResponse start(StartTransferOrderRequest request) { + return this.rawClient.start(request).body(); + } + + /** + * Changes a DRAFT transfer order to STARTED status. + * This decrements inventory at the source Location and marks it as in-transit. + *The order must be in DRAFT status and have all required fields populated. + * Once started, the order can no longer be deleted, but it can be canceled via + * CancelTransferOrder.
+ *Creates a transfer_order.updated webhook event.
+ */ + public StartTransferOrderResponse start(StartTransferOrderRequest request, RequestOptions requestOptions) { + return this.rawClient.start(request, requestOptions).body(); + } +} diff --git a/src/main/java/com/squareup/square/core/ClientOptions.java b/src/main/java/com/squareup/square/core/ClientOptions.java index 3ff46663..0960b301 100644 --- a/src/main/java/com/squareup/square/core/ClientOptions.java +++ b/src/main/java/com/squareup/square/core/ClientOptions.java @@ -32,10 +32,10 @@ private ClientOptions( this.headers.putAll(headers); this.headers.putAll(new HashMapACTIVE or SCHEDULED status.
@@ -40,14 +48,6 @@ public String getPromotionId() {
return promotionId;
}
- /**
- * @return The ID of the base loyalty program.
- */
- @JsonProperty("program_id")
- public String getProgramId() {
- return programId;
- }
-
@java.lang.Override
public boolean equals(Object other) {
if (this == other) return true;
@@ -60,12 +60,12 @@ public MapThe ID of the loyalty promotion to cancel. You can cancel a
- * promotion that has an ACTIVE or SCHEDULED status.
The ID of the base loyalty program.
*/ - ProgramIdStage promotionId(@NotNull String promotionId); + PromotionIdStage programId(@NotNull String programId); Builder from(CancelPromotionsRequest other); } - public interface ProgramIdStage { + public interface PromotionIdStage { /** - *The ID of the base loyalty program.
+ *The ID of the loyalty promotion to cancel. You can cancel a
+ * promotion that has an ACTIVE or SCHEDULED status.
The ID of the loyalty promotion to cancel. You can cancel a
- * promotion that has an ACTIVE or SCHEDULED status.
The ID of the loyalty promotion to cancel. You can cancel a
- * promotion that has an ACTIVE or SCHEDULED status.
The ID of the base loyalty program.
+ *The ID of the base loyalty program.
* @return Reference to {@code this} so that method calls can be chained together. */ @java.lang.Override - @JsonSetter("promotion_id") - public ProgramIdStage promotionId(@NotNull String promotionId) { - this.promotionId = Objects.requireNonNull(promotionId, "promotionId must not be null"); + @JsonSetter("program_id") + public PromotionIdStage programId(@NotNull String programId) { + this.programId = Objects.requireNonNull(programId, "programId must not be null"); return this; } /** - *The ID of the base loyalty program.
- *The ID of the base loyalty program.
+ *The ID of the loyalty promotion to cancel. You can cancel a
+ * promotion that has an ACTIVE or SCHEDULED status.
The ID of the loyalty promotion to cancel. You can cancel a
+ * promotion that has an ACTIVE or SCHEDULED status.
main keyword.
@@ -48,6 +40,14 @@ public String getProgramId() {
return programId;
}
+ /**
+ * @return The ID of the loyalty promotion to retrieve.
+ */
+ @JsonProperty("promotion_id")
+ public String getPromotionId() {
+ return promotionId;
+ }
+
@java.lang.Override
public boolean equals(Object other) {
if (this == other) return true;
@@ -60,12 +60,12 @@ public MapThe ID of the loyalty promotion to retrieve.
+ *The ID of the base loyalty program. To get the program ID,
+ * call RetrieveLoyaltyProgram using the main keyword.
The ID of the base loyalty program. To get the program ID,
- * call RetrieveLoyaltyProgram using the main keyword.
The ID of the loyalty promotion to retrieve.
*/ - _FinalStage programId(@NotNull String programId); + _FinalStage promotionId(@NotNull String promotionId); } public interface _FinalStage { @@ -99,11 +99,11 @@ public interface _FinalStage { } @JsonIgnoreProperties(ignoreUnknown = true) - public static final class Builder implements PromotionIdStage, ProgramIdStage, _FinalStage { - private String promotionId; - + public static final class Builder implements ProgramIdStage, PromotionIdStage, _FinalStage { private String programId; + private String promotionId; + @JsonAnySetter private MapThe ID of the loyalty promotion to retrieve.
- *The ID of the loyalty promotion to retrieve.
+ *The ID of the base loyalty program. To get the program ID,
+ * call RetrieveLoyaltyProgram using the main keyword.
The ID of the base loyalty program. To get the program ID,
+ * call RetrieveLoyaltyProgram using the main keyword.
The ID of the base loyalty program. To get the program ID,
- * call RetrieveLoyaltyProgram using the main keyword.
The ID of the base loyalty program. To get the program ID,
- * call RetrieveLoyaltyProgram using the main keyword.
The ID of the loyalty promotion to retrieve.
+ *The ID of the loyalty promotion to retrieve.
* @return Reference to {@code this} so that method calls can be chained together. */ @java.lang.Override - @JsonSetter("program_id") - public _FinalStage programId(@NotNull String programId) { - this.programId = Objects.requireNonNull(programId, "programId must not be null"); + @JsonSetter("promotion_id") + public _FinalStage promotionId(@NotNull String promotionId) { + this.promotionId = Objects.requireNonNull(promotionId, "promotionId must not be null"); return this; } @java.lang.Override public GetPromotionsRequest build() { - return new GetPromotionsRequest(promotionId, programId, additionalProperties); + return new GetPromotionsRequest(programId, promotionId, additionalProperties); } } } diff --git a/src/main/java/com/squareup/square/types/BulkRetrieveChannelsRequest.java b/src/main/java/com/squareup/square/types/BulkRetrieveChannelsRequest.java new file mode 100644 index 00000000..7555331f --- /dev/null +++ b/src/main/java/com/squareup/square/types/BulkRetrieveChannelsRequest.java @@ -0,0 +1,104 @@ +/** + * This file was auto-generated by Fern from our API Definition. + */ +package com.squareup.square.types; + +import com.fasterxml.jackson.annotation.JsonAnyGetter; +import com.fasterxml.jackson.annotation.JsonAnySetter; +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.annotation.JsonSetter; +import com.fasterxml.jackson.annotation.Nulls; +import com.fasterxml.jackson.databind.annotation.JsonDeserialize; +import com.squareup.square.core.ObjectMappers; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Objects; + +@JsonInclude(JsonInclude.Include.NON_ABSENT) +@JsonDeserialize(builder = BulkRetrieveChannelsRequest.Builder.class) +public final class BulkRetrieveChannelsRequest { + private final ListInformation about errors encountered during the request.
+ */ + @JsonSetter(value = "errors", nulls = Nulls.SKIP) + public Builder errors(OptionalA map of channel IDs to channel responses which tell whether + * retrieval for a specific channel is success or not. + * Channel response of a success retrieval would contain channel info + * whereas channel response of a failed retrieval would have error info.
+ */ + @JsonSetter(value = "responses", nulls = Nulls.SKIP) + public Builder responses(OptionalThe ID of the transfer order to cancel. Must be in STARTED or PARTIALLY_RECEIVED status.
+ */ + IdempotencyKeyStage transferOrderId(@NotNull String transferOrderId); + + Builder from(CancelTransferOrderRequest other); + } + + public interface IdempotencyKeyStage { + /** + *A unique string that identifies this UpdateTransferOrder request. Keys can be + * any valid string but must be unique for every UpdateTransferOrder request.
+ */ + _FinalStage idempotencyKey(@NotNull String idempotencyKey); + } + + public interface _FinalStage { + CancelTransferOrderRequest build(); + + /** + *Version for optimistic concurrency
+ */ + _FinalStage version(OptionalThe ID of the transfer order to cancel. Must be in STARTED or PARTIALLY_RECEIVED status.
+ *The ID of the transfer order to cancel. Must be in STARTED or PARTIALLY_RECEIVED status.
+ * @return Reference to {@code this} so that method calls can be chained together. + */ + @java.lang.Override + @JsonSetter("transfer_order_id") + public IdempotencyKeyStage transferOrderId(@NotNull String transferOrderId) { + this.transferOrderId = Objects.requireNonNull(transferOrderId, "transferOrderId must not be null"); + return this; + } + + /** + *A unique string that identifies this UpdateTransferOrder request. Keys can be + * any valid string but must be unique for every UpdateTransferOrder request.
+ *A unique string that identifies this UpdateTransferOrder request. Keys can be + * any valid string but must be unique for every UpdateTransferOrder request.
+ * @return Reference to {@code this} so that method calls can be chained together. + */ + @java.lang.Override + @JsonSetter("idempotency_key") + public _FinalStage idempotencyKey(@NotNull String idempotencyKey) { + this.idempotencyKey = Objects.requireNonNull(idempotencyKey, "idempotencyKey must not be null"); + return this; + } + + /** + *Version for optimistic concurrency
+ * @return Reference to {@code this} so that method calls can be chained together. + */ + @java.lang.Override + public _FinalStage version(Long version) { + this.version = Optional.ofNullable(version); + return this; + } + + /** + *Version for optimistic concurrency
+ */ + @java.lang.Override + @JsonSetter(value = "version", nulls = Nulls.SKIP) + public _FinalStage version(OptionalThe updated transfer order with status changed to CANCELED
+ */ + @JsonSetter(value = "transfer_order", nulls = Nulls.SKIP) + public Builder transferOrder(OptionalAny errors that occurred during the request
+ */ + @JsonSetter(value = "errors", nulls = Nulls.SKIP) + public Builder errors(OptionalThe channel's unique ID.
+ */ + @JsonSetter(value = "id", nulls = Nulls.SKIP) + public Builder id(OptionalThe unique ID of the merchant this channel belongs to.
+ */ + @JsonSetter(value = "merchant_id", nulls = Nulls.SKIP) + public Builder merchantId(OptionalThe name of the channel.
+ */ + @JsonSetter(value = "name", nulls = Nulls.SKIP) + public Builder name(OptionalThe version number which is incremented each time an update is made to the channel.
+ */ + @JsonSetter(value = "version", nulls = Nulls.SKIP) + public Builder version(OptionalRepresents an entity the channel is associated with.
+ */ + @JsonSetter(value = "reference", nulls = Nulls.SKIP) + public Builder reference(OptionalStatus of the channel. + * See Status for possible values
+ */ + @JsonSetter(value = "status", nulls = Nulls.SKIP) + public Builder status(OptionalThe timestamp for when the channel was created, in RFC 3339 format (for example, "2016-09-04T23:59:33.123Z"). + * For more information, see Working with Dates.
+ */ + @JsonSetter(value = "created_at", nulls = Nulls.SKIP) + public Builder createdAt(OptionalThe timestamp for when the channel was last updated, in RFC 3339 format (for example, "2016-09-04T23:59:33.123Z"). + * For more information, see Working with Dates.
+ */ + @JsonSetter(value = "updated_at", nulls = Nulls.SKIP) + public Builder updatedAt(Optional