DigiOffice Gateway Web Services

GenerateDocumentBatch

Queue multiple (corporate identity) document(s) to generate later via the DigiOffice background agent.

**GenerateDocumentBatch** Parameters:
Name	Parameter	Data Type	Required	Description
User	query	UserReference	No	Owner of the badge (DigiOffice user)
Description	query	string	Yes	Description of the badge
Documents	query	List<BatchDocument>	Yes	Corporate identity document(s) to be generate
DontRegister	query	bool?	No	Generated document is not registered in DigiOffice DMS.
SendMail	query	bool	No	Send the generated e-mail via the e-mail queue.

**UserReference** Parameters:
Name	Parameter	Data Type	Required
ID	form	int?	No
LoginName	form	string	No
UserPrincipalName	form	string	No
FullName	form	string	No
EmailAddress	form	string	No
GlobalID	form	Guid?	No

**BatchDocument** Parameters:
Name	Parameter	Data Type	Required	Description
ConfigurationSource	form	ConfigurationSource	Yes	ConfigurationSource: DocumentgeneratorDocument of RegistratieProfiel.
RegistrationMetaData	form	RegistrationMetaData	Yes	Set references to bind with Registration profile
DataSourceEntity	form	CommonEntityBaseReference	No	Entity instance used as data source parent, if not exists default is Document registration instance.
CustomData	form	string	No	Hier kan de (dynamische) data voor het document geplaatst worden, de data kan middels tekstblokken en placeholders worden geplaatst.Het formaat binnen CustomData staat vrij maar vereist een 'root' element.
Watermark	form	Watermark	No	Insert a watermark into the document.
OutputType	form	string	No	Type van het gegenereerde document, bijvoorbeeld: Doc, Docx, Pdf.

**ConfigurationSource** Parameters:
Name	Parameter	Data Type	Required	Description
DocumentgeneratorDocument	form	DocumentgeneratorDocumentReference	No	Document genereren op basis van een DocGenDocument.
RegistrationProfile	form	RegistrationProfileReference	No	Document genereren op basis van een RegistratieProfiel.
RegisteredDocument	form	DocumentReference	No	Use existing document registration.
UnRegisteredDocument	form	DocumentInfo	No	Use documentInfo.
DraftDocumentRegistration	form	MessageQueueReference	No	Use draft document registration.
DocumentgeneratorType	form	Type	No
DocumentgeneratorTypeName	form	string	No	DocumentgeneratorType voor bijvoorbeeld Word of Email.
TemplateExtension	form	string	No
OutputExtension	form	string	No

**DocumentgeneratorDocumentReference** Parameters:
Name	Parameter	Data Type	Required
ID	form	Guid?	No
Name	form	string	No
GlobalID	form	Guid?	No

**RegistrationProfileReference** Parameters:
Name	Parameter	Data Type	Required	Description
ID	form	Guid	No
GlobalID	form	Guid?	No

**DocumentReference** Parameters:
Name	Parameter	Data Type	Required
ID	form	Guid?	No
Code	form	string	No
VersionCode	form	string	No
RootDocID	form	Guid?	No
InternalInvoiceCode	form	string	No
CompanyNumber	form	int?	No
DocumentTypeID	form	string	No
InvoiceType	form	int?	No
RegProfCatID	form	int?	No
GlobalID	form	Guid?	No
ExternalID	form	string	No
ExternNr	form	string	No
ExternVersieNr	form	string	No
InternNummer	form	string	No

**DocumentInfo** Parameters:
Name	Parameter	Data Type	Required
Action	form	DocInfoAction	No
Mode	form	DocInfoMode	No
Version	form	string	No
SilentMode	form	DocInfoSilentMode	No

**DocInfoAction** Enum:
Create
Register

**DocInfoMode** Enum:
New
Change
NewVersionPrimary
NewVersionSecondary
NewFromExistingDocument

**DocInfoSilentMode** Enum:
Off
AllowUserInteraction
DoNotAllowUserInteraction

**MessageQueueReference** Parameters:
Name	Parameter	Data Type	Required	Description
ID	form	int?	No
GlobalID	form	Guid?	No

**RegistrationMetaData** Parameters:
Name	Parameter	Data Type	Required	Description
Versioning	form	VersioningType?	No	Hoe moet het versiebeheer worden toegepast?
PreviousDocument	form	DocumentReference	No	Previous document will be used for registration of a new version.
Company	form	CompanyReference	No	Company
Relation	form	RelationReference	No	Relation
Person	form	PersonReference	No	Person
Project	form	ProjectReference	No	Project
SubProjects	form	List<SubProject>	No	Sub projects
Signers	form	List<Signer>	No	Signers
Fields	form	List<Field>	No	Bevat velden die gebruikt worden als additionele metadata voor het document, naast de vaste koppelingen zoals gebruiker, project en relatie.
Attachments	form	List<Attachment>	No	Attachments die aan de documentregistratie gekoppeld moet worden.

**VersioningType** Enum:
New
Change
Primary
Secondary

**CompanyReference** Parameters:
Name	Parameter	Data Type	Required
ID	form	int?	No
Number	form	int?	No
GlobalID	form	Guid?	No
ExternalID	form	string	No

**RelationReference** Parameters:
Name	Parameter	Data Type	Required
ID	form	int?	No
CreditorNumber	form	int?	No
DebtorNumber	form	int?	No
GlobalLocationNumber	form	string	No
GlobalID	form	Guid?	No
ExternalID	form	string	No

**PersonReference** Parameters:
Name	Parameter	Data Type	Required
ID	form	int?	No
Number	form	int?	No
GlobalID	form	Guid?	No
ExternalID	form	string	No

**ProjectReference** Parameters:
Name	Parameter	Data Type	Required
ID	form	int?	No
Code	form	string	No
TypeExternalID	form	string	No
CompanyNumber	form	int?	No
GlobalID	form	Guid?	No
ExternalID	form	string	No

**SubProject** Parameters:
Name	Parameter	Data Type	Required	Description
Project	form	ProjectReference	No

**Signer** Parameters:
Name	Parameter	Data Type	Required
MainSignerPostFix	form	string	No
User	form	UserReference	No
Person	form	PersonReference	No
Relation	form	RelationReference	No
ContactPerson	form	ContactPersonReference	No
RegisteredDocument	form	DocumentReference	No
Type	form	SignerType	No
ClosingSentence	form	string	No
Name	form	string	No
Subsidiary	form	string	No
Function	form	string	No
Department	form	string	No
PhoneNumber	form	string	No
FaxNumber	form	string	No
MobileNumber	form	string	No
Email	form	string	No
CustomText	form	string	No
Signature	form	List<string>	No
Initials	form	List<string>	No
SignatureVisible	form	bool?	No
InitialsVisible	form	bool?	No
Visible	form	bool?	No

**ContactPersonReference** Parameters:
Name	Parameter	Data Type	Required
ID	form	int?	No
GlobalID	form	Guid?	No
ExternalID	form	string	No
RelationID	form	int?	No
PersonID	form	int?	No

**SignerType** Enum:
MainSigner
AdditionalSigner
ConfirmationDeclarant
AdditionalConfirmationDeclarant

**Field** Parameters:
Name	Parameter	Data Type	Required
Name	form	string	No
OldValue	form	string	No
Value	form	string	No
Title	form	string	No

**Attachment** Parameters:
Name	Parameter	Data Type	Required	Description
Name	form	string	No
AttachmentData	form	AttachmentData	No

**AttachmentData** Parameters:
Name	Parameter	Data Type	Required	Description
ContentType	form	string	No
Data	form	string	No	Data base64-encoded zonder padding.

**CommonEntityBaseReference** Parameters:
Name	Parameter	Data Type	Required
ID	form	string	No
ExternalID	form	string	No
GlobalID	form	Guid?	No

**Watermark** Parameters:
Name	Parameter	Data Type	Required
Text	form	string	No
FontFamilyText	form	string	No
FontFamily	form	FontFamily	No
Direction	form	Direction?	No
StrokeColorText	form	string	No
StrokeColor	form	Color	No
FillColorText	form	string	No
FillColor	form	Color	No

**Direction** Enum:
Name	Value
Left2Right	0
UpLeft2DownRight	45
Up2Down	90
UpRight2DownLeft	135
Right2Left	180
DownRight2UpLeft	225
Down2Up	270
DownLeft2UpRight	315

**GenerateDocumentBatchResponse** Parameters:
Name	Parameter	Data Type	Required	Description
BatchID	form	Guid	Yes	ID of the batch
Processed	form	int	Yes	Document processed count
TrackAndTraceUrl	form	string	Yes	Track and Trace url

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /jsv/reply/GenerateDocumentBatch HTTP/1.1 
Host: doapigw.baasbv.nl 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	User: 
	{
		ID: 0,
		LoginName: String,
		UserPrincipalName: String,
		FullName: String,
		EmailAddress: String,
		GlobalID: 00000000-0000-0000-0000-000000000000
	},
	Description: String,
	Documents: 
	[
		{
			ConfigurationSource: 
			{
				DocumentgeneratorDocument: 
				{
					ID: 00000000-0000-0000-0000-000000000000,
					Name: String
				},
				RegistrationProfile: {},
				RegisteredDocument: 
				{
					ID: 00000000-0000-0000-0000-000000000000,
					Code: String,
					VersionCode: String,
					RootDocID: 00000000-0000-0000-0000-000000000000,
					InternalInvoiceCode: String,
					CompanyNumber: 0,
					DocumentTypeID: String,
					InvoiceType: 0,
					RegProfCatID: 0,
					GlobalID: 00000000-0000-0000-0000-000000000000,
					ExternalID: String,
					ExternVersieNr: String
				},
				UnRegisteredDocument: 
				{
					Action: Create,
					Mode: New,
					Version: String,
					SilentMode: Off
				},
				DraftDocumentRegistration: 
				{
					ID: 0
				},
				TemplateExtension: String,
				OutputExtension: String
			},
			RegistrationMetaData: 
			{
				Versioning: New,
				PreviousDocument: 
				{
					ID: 00000000-0000-0000-0000-000000000000,
					Code: String,
					VersionCode: String,
					RootDocID: 00000000-0000-0000-0000-000000000000,
					InternalInvoiceCode: String,
					CompanyNumber: 0,
					DocumentTypeID: String,
					InvoiceType: 0,
					RegProfCatID: 0,
					GlobalID: 00000000-0000-0000-0000-000000000000,
					ExternalID: String,
					ExternVersieNr: String
				},
				Company: 
				{
					ID: 0,
					Number: 0,
					GlobalID: 00000000-0000-0000-0000-000000000000,
					ExternalID: String
				},
				Relation: 
				{
					ID: 0,
					CreditorNumber: 0,
					DebtorNumber: 0,
					GlobalLocationNumber: String,
					GlobalID: 00000000-0000-0000-0000-000000000000,
					ExternalID: String
				},
				Person: 
				{
					ID: 0,
					Number: 0,
					GlobalID: 00000000-0000-0000-0000-000000000000,
					ExternalID: String
				},
				Project: 
				{
					ID: 0,
					Code: String,
					TypeExternalID: String,
					CompanyNumber: 0,
					GlobalID: 00000000-0000-0000-0000-000000000000,
					ExternalID: String
				},
				SubProjects: 
				[
					{
						Project: 
						{
							ID: 0,
							Code: String,
							TypeExternalID: String,
							CompanyNumber: 0,
							GlobalID: 00000000-0000-0000-0000-000000000000,
							ExternalID: String
						}
					}
				],
				Signers: 
				[
					{
						MainSignerPostFix: String,
						User: 
						{
							ID: 0,
							LoginName: String,
							UserPrincipalName: String,
							FullName: String,
							EmailAddress: String,
							GlobalID: 00000000-0000-0000-0000-000000000000
						},
						Person: 
						{
							ID: 0,
							Number: 0,
							GlobalID: 00000000-0000-0000-0000-000000000000,
							ExternalID: String
						},
						Relation: 
						{
							ID: 0,
							CreditorNumber: 0,
							DebtorNumber: 0,
							GlobalLocationNumber: String,
							GlobalID: 00000000-0000-0000-0000-000000000000,
							ExternalID: String
						},
						ContactPerson: 
						{
							ID: 0,
							GlobalID: 00000000-0000-0000-0000-000000000000,
							ExternalID: String,
							RelationID: 0,
							PersonID: 0
						},
						RegisteredDocument: 
						{
							ID: 00000000-0000-0000-0000-000000000000,
							Code: String,
							VersionCode: String,
							RootDocID: 00000000-0000-0000-0000-000000000000,
							InternalInvoiceCode: String,
							CompanyNumber: 0,
							DocumentTypeID: String,
							InvoiceType: 0,
							RegProfCatID: 0,
							GlobalID: 00000000-0000-0000-0000-000000000000,
							ExternalID: String,
							ExternVersieNr: String
						},
						Type: MainSigner,
						ClosingSentence: String,
						Name: String,
						Subsidiary: String,
						Function: String,
						Department: String,
						PhoneNumber: String,
						FaxNumber: String,
						MobileNumber: String,
						Email: String,
						CustomText: String,
						Signature: 
						[
							String
						],
						Initials: 
						[
							String
						],
						SignatureVisible: False,
						InitialsVisible: False,
						Visible: False
					}
				],
				Fields: 
				[
					{
						Name: String,
						OldValue: String,
						Value: String,
						Title: String = String -> String
					}
				],
				Attachments: 
				[
					{
						Name: String,
						AttachmentData: 
						{
							ContentType: String,
							Data: String
						}
					}
				]
			},
			DataSourceEntity: 
			{
				ID: String,
				ExternalID: String,
				GlobalID: 00000000-0000-0000-0000-000000000000
			},
			CustomData: String,
			Watermark: 
			{
				Text: String,
				Direction: Left2Right
			},
			OutputType: String
		}
	],
	DontRegister: False,
	SendMail: False
}

HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	Processed: 0,
	TrackAndTraceUrl: String
}