Agencies

What is the meaning of agency?

We can understand an agency as a client, a buyer or a distribution channel. An organization has a set of agencies (at least one).


How to create an agency

Considerations

It is an incremental load, so bear in mind these considerations:

  • If an agency exists then it is updated.

  • If an agency does not exist then it is created. Existing agencies that are not referenced are not removed.

  • If an existing agency has to be removed from system then you have to contact with TravelgateX.

  • If there is any problem with an agency’s information then it is omitted (and logged) but the load continues.


Specifications

  • File name: Master_Agencies.csv.

  • Each line represents a unique agency and contains all the information (fields) about it.

  • The first line is not a header line: it contains data directly.

  • Inside a line fields are separated using the character #. This character can’t be used inside data because fields would be gathered in a wrong way.

  • The data of the fields is not encapsulated by or any other character: the information must be included directly.

  • Any blank line will be skipped.

  • The file and its data have to be encoded using UTF-8. Otherwise there can be stored strange characters.

  • If a field is mandatory then it has to be present in each line, even if it has no data: its used position cannot be omitted. If mandatory then we have to see if its data is mandatory or not.

  • If a field is not mandatory but we want to set it then all previous fields must be present: if any previous field is not mandatory and we don’t want to set a value we will have to include it with no value. We need it this way as it is used the field position to map it to the target data.

  • If a field’s data is not mandatory and we don’t want to set it then we just keep it empty: i.e. …##…

  • If a field’s data is mandatory then we have to set something (no value is not admitted).


Line fields

Position Mandatory Field Mandatory Data Type Description
0 Yes Yes string Agency code
1 Yes Yes string Agency name
2 Yes Yes boolean Access to be set

Example

350#My Agency#true