addDocumentsforOffering

This method is used to add a document to an offering. Only .pdf and .xls files can de uploaded. Only PDF files are able to be watermarked. 50 MB max file upload.

Request Parameters

ParameterRequiredTypeDescription
clientIDyesstringTransactAPI Client ID
developerAPIKeyyesstringTransactAPI Developer Key
offeringIdyesintegerOffering ID that is generated by the API once an offering is created (createOffering)
documentTitleyesstringTitle/label for the uploaded document
documentFileReferenceCodeyesstringReference code for the uploaded document (can be any number to use for tracking)
file_nameyesstringFile name of the uploaded document. No special characters can be included in the file name.
userfile0yesstringWhile uploading the PDF files, please provide a temporary file name. Prefix @ on the file name. Eg : @/tmp/phpAHi2ZC Request parameter should be userfile0, userfile1, userfile2,...userfilen for multiple documents upload. Refer Sample Request set below
templateNamenoconditionalOffering Document Template Name (can be used if using certain templates for tracking)
approvalnostringHas the Document been approved by a Registered Principal? Yes or No
supervisornamenostringName of the Approving Principal
datenointegerDate that the Document was Approved
createdIpAddressnostringIP Address of the addDocumentsforOffering method call

Sample Request

SINGLE UPLOAD
--------------------------------------
curl -k -X POST https://api-sandboxdash.norcapsecurities.com/tapiv3/index.php/v3/addDocumentsforOffering
-d developerAPIKey=somedeveloperkey
-d clientID=someclientid
-d offeringId=55593
-d documentTitle=documentTitle0=Tagme
-d documentFileReferenceCode=ReferenceCode
-d file_name=filename0=page2.pdf
-d [email protected]/tmp/phpAHi2ZC
-d templateName=sample document
-d approval=yes
-d supervisorname=peter
-d date=02-04-2016
-d createdIpAddress=10.0.0.9

MULTIPLE UPLOAD
--------------------------------------
curl -k -X POST https://api-sandboxdash.norcapsecurities.com/tapiv3/index.php/v3/addDocumentsforOffering
-d developerAPIKey=somedeveloperkey
-d clientID=someclientid
-d offeringId=55593
-d documentTitle=documentTitle0=Tagme&documentTitle1=Tested
-d documentFileReferenceCode=ReferenceCode
-d file_name=filename0=page2.pdf&filename1=page3.pdf
-d [email protected]/tmp/phpAHi2ZC
-d [email protected]/tmp/phpDSGTUT
-d templateName=sample document
-d approval=yes
-d supervisorname=peter
-d date=02-04-2016
-d createdIpAddress=10.0.0.9

Response Parameters

ParameterTypeDescription
statusCodestringAPI Status Code
statusDescstringAPI Status Description
offeringIdintegerOffering ID generated by the API
documentIdstringDocument ID generated by the API
documentURLstringUploaded document URL

Sample Response

{
  statusCode: "101",
  statusDesc: "Ok",
  document_details: [
    {
      offeringId: "7671",
      documentId: "21344",
      documentReferenceCode: "24102016121212",
      documentURL: "https://api-sandboxdash.norcapsecurities.com/tapiv3/index.php/stamp/PDF/VGVzdA==/GKrQ241016060807.pdf"
    },
    {
      offeringId: "7671",
      documentId: "52348",
      documentReferenceCode: "24102016121212",
      documentURL: "https://api-sandboxdash.norcapsecurities.com/tapiv3/index.php/stamp/PDF/VGVzdA==/GKrQ2410160608071.pdf"
    }
  ]
}

Test it Yourself!

Language
Click Try It! to start a request and see the response here!