Skip to main content

About Job

Learn more about the job

For sending an ePostage you need to create a job first, the final stage of creating an ePostage is known as a job. Sending an ePostage can't be done without this section.

You will require to make some required data available before calling job API. For example, Address ID, recipient ID, etc.

Job Attributes

An object job could have the following attributes.

KeyTypeLengthDescription
UniqueJobIdString150An Unique Id for every Job
CreatedDateDatetime150Date and time of creation
LastModifiedDatetime150Date and time of modification
ShipperHashString150Shipper Hash, to map with a particular shipper
TopicHashString150Unique Topic Hash ID, topic is a very interesting feature of DPS, to know more about this please check here
DocumentHashListArray150Array of string, containing the hashes of every document
NotarizedDocumentHashString150NotarizedDocumentHash is required if you want to mail a document and it should be notarized
AttachmentHashString150Optional, you can provide the hash or attachment if you want to attach any attachment to ePostage
ExtraWeightString150Optional, if ePostage have extra weight
ExtraInfoString150Optional, if you want to provide extra information for a particular ePostage
DoubleSidedBooleanfalseSet true if ePostage is double sided
FromNameString150Name of sender
FromCompanyString150Sender's Company name
FromAddressLine1String150Sender's first line address
FromAddressLine2String150Sender's second line address
FromCityString150Sender's city name
FromStateString2Sender's state code only two character
FromZipString6Zip code of sender
FromCountryString150Country name of sender.
Note: currently supported United state only.
FromPhoneNumber10Sender's phone number
Note: Do not add any prefix like std or ISD or country code etc just use your 10 digit phone number
ProviderString150ePostage provider
Note: currently supported USPS only.
PostageTypeString150Type of your postage for this job, Choices can be 'FC', 'FCSig', 'ERR', 'ERRSig', 'PMAIL', 'PRIL'
ContainerString150Possible containers for Priority (PMAIL), Express(PRIL), FC, FCSig, ERR and ERRSig mailings are this
DispatchStatusString150Your ePostage dispatch status initially set to draft
IsHazardousBoolean150Declaration if ePostage is containing any hazardous material
HazardousMaterialString150Detailed information of hazardous material, return/set blank if IsHazardous set to false
WeightFloat0.00Two floating point value
Note: all weights are considered ounces(oz) unit
UnitString2Valid Unit for weight is Lb and Oz (Lb stands for pounds and Oz stands for ounces)
PageCountNumber5Total number of pages that exist in a particular ePostage.
ModeString150Mode of ePostage , initially Draft.
IsDocumentVerifiedBooleanfalseReturn the value in form or boolean, return true if the document is verified.
ColorBooleanfalseReturn whether it is a black and white or color ePostage , return false if black & white else return true if colored.
COMTypeString150This would be the type of selected certificate of mailing.
COMCodeString150This is the certificate of mailing short code and valid codes are only COM.
IsComBooleanConfirmation of whether is a COM included or not.
StorageClassString150Type of storage class are 1Year, 2Year and 5Year, default set to "1Year"
ReturnEnvelopeBooleanfalse/trueThis would be boolean and true if you requested to attach a return envelope otherwise it would be false.
ProviderJobInfoString150Optional
ApiServiceString150Type of API service,
Note: only ePostage is supported
JobHashString150Hash id of that particular job, autogenerated

List of Postage and their valid containers

NoPostage TypeDescriptionContainers
1PMAILPriority MailFLAT RATE ENVELOPE.
LEGAL FLAT RATE ENVELOPE.
PADDED FLAT RATE ENVELOPE.
SM FLAT RATE ENVELOPE.
SM FLAT RATE BOX
MD FLAT RATE BOX.
LG FLAT RATE BOX.
REGIONALRATEBOXA.
REGIONALRATEBOXB.
VARIABLE.
2PRILPriority ExpressFLAT RATE ENVELOPE.
LEGAL FLAT RATE ENVELOPE.
PADDED FLAT RATE ENVELOPE.
VARIABLE.
3FCFirst Class PackageVARIABLE
4FCSigFirst Class Package with SignatureVARIABLE
5ERRFirst Class Certified Mail with return ReceiptVARIABLE
6ERRSigFirst Class Certified Mail with Return SignatureVARIABLE
7Parcel SelectParcel SelectVARIABLE