CreateInventoryTransfer

Description

This method creates a new inventory transfer document.

Parameters

Interfaces

• Dynamics GP
• Inventory

Examples

The following C# example creates a new inventory transfer document with the key "WSINVTRFR00000010". The example demonstrates setting the inventory transfer document's key, batch key, and date properties. The example uses a single inventory transfer line to specify the details of the transfer. All other properties use default values.

** Legacy endpoint**

using System;
using System.Collections.Generic;
using System.Text;
using DynamicsGPWebServiceSample.DynamicsGPService;

namespace DynamicsGPWebServiceSample
{
    class Program
    {
        static void Main(string[] args)
        {
            CompanyKey companyKey;
            Context context;
            BatchKey batchKey;
            ItemKey itemKey;
            Quantity itemQuantity;
            WarehouseKey fromWarehouseKey;
            WarehouseKey toWarehouseKey;
            InventoryKey inventoryKey;
            InventoryLineKey inventoryLineKey;
            InventoryTransfer inventoryTransfer;
            InventoryTransferLine inventoryTransferLine;
            Policy inventoryTransferCreatePolicy;

            // Create an instance of the service
            DynamicsGP wsDynamicsGP = new DynamicsGP();

            // Be sure the default credentials are used
            wsDynamicsGP.UseDefaultCredentials = true;

            // Create a context with which to call the service
            context = new Context();

            // Specify which company to use (sample company)
            companyKey = new CompanyKey();
            companyKey.Id = (-1);

            // Set up the context object
            context.OrganizationKey = (OrganizationKey)companyKey;

            // Create an inventory key to identify the inventory transfer object
            inventoryKey = new InventoryKey();
            inventoryKey.Id = "WSINVTRFR00000010";

            // Create a batch key object to specify a batch for the inventory transfer
            batchKey = new BatchKey();
            batchKey.Id = "TRANSFER 1";

            // Create an inventory transfer object
            inventoryTransfer = new InventoryTransfer();

            // Populate the inventory transfer object's required properties
            inventoryTransfer.Key = inventoryKey;
            inventoryTransfer.BatchKey = batchKey;
            inventoryTransfer.Date = DateTime.Today;

            // Create an inventory transfer line object to detail the inventory transfer
            inventoryTransferLine = new InventoryTransferLine();

            // Create an inventory line key to identify the inventory transfer line object
            inventoryLineKey = new InventoryLineKey();
            inventoryLineKey.InventoryKey = inventoryKey;

            // Create an item key object to specify the item
            itemKey = new ItemKey();
            itemKey.Id = "128 SDRAM";

            // Create a quantity object to specify the amount of the transfer
            itemQuantity = new Quantity();
            itemQuantity.Value = 5m;

            // Create a warehouse key to specify the location originating the transfer
            fromWarehouseKey = new WarehouseKey();
            fromWarehouseKey.Id = "NORTH";

            // Create a warehouse key to specify the location receiving the transfer
            toWarehouseKey = new WarehouseKey();
            toWarehouseKey.Id = "WAREHOUSE";

            // Populate the required properties of the inventory transfer line object
            inventoryTransferLine.Key = inventoryLineKey;
            inventoryTransferLine.ItemKey = itemKey;
            inventoryTransferLine.Quantity = itemQuantity;
            inventoryTransferLine.WarehouseFromKey = fromWarehouseKey;
            inventoryTransferLine.WarehouseToKey = toWarehouseKey;

            // Create an array to hold the inventory transfer line object
            InventoryTransferLine[] lines = { inventoryTransferLine };

            // Add the array of inventory transfer lines to the inventory transfer object
            inventoryTransfer.Lines = lines;

            // Get the create policy for an inventory transfer
            inventoryTransferCreatePolicy = wsDynamicsGP.GetPolicyByOperation(
            "CreateInventoryTransfer", context);

            // Create the inventory transfer
            wsDynamicsGP.CreateInventoryTransfer(inventoryTransfer,
            context, inventoryTransferCreatePolicy);
        }
    }
}

** Native endpoint **

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.ServiceModel;
using DynamicsGPWebServiceSample.DynamicsGPService;

namespace DynamicsGPWebServiceSample
{
    class Program
    {
        static void Main(string[] args)
        {
            CompanyKey companyKey;
            Context context;
            BatchKey batchKey;
            ItemKey itemKey;
            Quantity itemQuantity;
            WarehouseKey fromWarehouseKey;
            WarehouseKey toWarehouseKey;
            InventoryKey inventoryKey;
            InventoryLineKey inventoryLineKey;
            InventoryTransfer inventoryTransfer;
            InventoryTransferLine inventoryTransferLine;
            Policy inventoryTransferCreatePolicy;

            // Create an instance of the service
            DynamicsGPClient wsDynamicsGP = new DynamicsGPClient();

            // Create a context with which to call the service
            context = new Context();

            // Specify which company to use (sample company)
            companyKey = new CompanyKey();
            companyKey.Id = (-1);

            // Set up the context object
            context.OrganizationKey = (OrganizationKey)companyKey;

            // Create an inventory key to identify the inventory transfer object
            inventoryKey = new InventoryKey();
            inventoryKey.Id = "WSINVTRFR00000010";

            // Create a batch key object to specify a batch for the inventory transfer
            batchKey = new BatchKey();
            batchKey.Id = "TRANSFER 1";

            // Create an inventory transfer object
            inventoryTransfer = new InventoryTransfer();

            // Populate the inventory transfer object's required properties
            inventoryTransfer.Key = inventoryKey;
            inventoryTransfer.BatchKey = batchKey;
            inventoryTransfer.Date = DateTime.Today;

            // Create an inventory transfer line object to detail the inventory transfer
            inventoryTransferLine = new InventoryTransferLine();

            // Create an inventory line key to identify the inventory transfer line object
            inventoryLineKey = new InventoryLineKey();
            inventoryLineKey.InventoryKey = inventoryKey;

            // Create an item key object to specify the item
            itemKey = new ItemKey();
            itemKey.Id = "128 SDRAM";

            // Create a quantity object to specify the amount of the transfer
            itemQuantity = new Quantity();
            itemQuantity.Value = 5m;

            // Create a warehouse key to specify the location originating the transfer
            fromWarehouseKey = new WarehouseKey();
            fromWarehouseKey.Id = "NORTH";

            // Create a warehouse key to specify the location receiving the transfer
            toWarehouseKey = new WarehouseKey();
            toWarehouseKey.Id = "WAREHOUSE";

            // Populate the required properties of the inventory transfer line object
            inventoryTransferLine.Key = inventoryLineKey;
            inventoryTransferLine.ItemKey = itemKey;
            inventoryTransferLine.Quantity = itemQuantity;
            inventoryTransferLine.WarehouseFromKey = fromWarehouseKey;
            inventoryTransferLine.WarehouseToKey = toWarehouseKey;

            // Create an array to hold the inventory transfer line object
            InventoryTransferLine[] lines = { inventoryTransferLine };

            // Add the array of inventory transfer lines to the inventory transfer object
            inventoryTransfer.Lines = lines;

            // Get the create policy for an inventory transfer
            inventoryTransferCreatePolicy = wsDynamicsGP.GetPolicyByOperation(
            "CreateInventoryTransfer", context);

            // Create the inventory transfer
            wsDynamicsGP.CreateInventoryTransfer(inventoryTransfer,
            context, inventoryTransferCreatePolicy);

            // Close the service
            if(wsDynamicsGP.State != CommunicationState.Faulted)
            {
                wsDynamicsGP.Close();
            }
        }
    }
}