% GRID-PO-VERSION-UPDATE(1) Cargill, Incorporated | Grid

NAME

grid-po-version-update - Update an existing Grid Purchase Order Version.

SYNOPSIS

grid po version update [FLAGS] [OPTIONS]

DESCRIPTION

This command allows for the update of Grid Purchase Orders versions. It submits a Sabre transaction to create the purchase order version. Each update creates a new revision of that version.

The PO_NUMBER and VERSION_ID arguments are required.

ARGS

PO_NUMBER: The UID or an alternate ID of the purchase order this version is for.
VERSION_ID: The user-specified version identifier.

FLAGS

-h, --help: Prints help information.
-q, --quiet: Do not display output.
-V, --version: Prints version information.
-v: Increases verbosity (the opposite of -q). Specify multiple times for more output.
--draft: Sets the resulting version as a draft. Conflicts with --not-draft.
--not-draft: Sets the resulting version as a non-draft. Conflicts with --draft.

OPTIONS

-k, --key: base name or path to a private signing key file
--order-xml: Specify the path to an order xml FILE to load. The file must conform to the GS1 Order spec v3.4
--service-id: The ID of the service the payload should be sent to; required if running on Splinter. Format: <circuit-id>::<service-id>.
--url: URL for the REST API
--wait: Maximum number of seconds to wait for the batch to be committed.
--workflow-state: Specifies the initial workflow state of the purchase order.

EXAMPLES

The command

$ grid po version update \
    PO-00000-1111 \
    v3 \
    --workflow-state review \
    --wait=10

will update the version v3 of purchase order PO-00000-1111 to have the workflow state of review. It will generate output like the following:

Submitting request to update purchase order version...
Submitted batch: efed2ff3efc50ac32a81b05b8d330fdb154d...
Batch and transaction structure was valid. Batch queued.

ENVIRONMENT VARIABLES

CYLINDER_PATH: Colon-separated path used to search for the key which will be used to sign transactions
GRID_DAEMON_ENDPOINT: Specifies a default value for --url
GRID_DAEMON_KEY: Specifies a default value for -k, --key
GRID_SERVICE_ID: Specifies a default value for --service-id
GRID_STATE_DIR: Specifies the local path to the directory containing Grid state, which would contain “xsd/po/gs1/ecom/Order.xsd” for validating purchase orders. The default value is “/var/lib/grid”.