Bulk Importing Seafarer Documents - Rules

In Martide you can upload multiple seafarer documents at once, however there are rules that need to be followed so that the import is successful.

The following are the different sections of a seafarer’s profile, plus whether that entry is required or optional, the rules for uploading documents and any reasons for possible errors.

If no embarkation record is found with the specified seafarer_rank_id, employment_vessel_imo or employment_actual_sign_on, please add the missing document to the seafarer’s profile or adjust the employment data in the import file.

If more than one embarkation record is found with the specified seafarer_rank_id, employment_vessel_imo or employment_actual_sign_on, please delete the duplicated record from the seafarer’s profile.

If the seafarer is not found, and the data/document in the profile is already set, please update the details manually in Martide.

email

· Required: Yes.

· Rule: The email address must have at least one @ and one . (full stop/period.)

· Reasons for errors: The email has not been entered or is invalid.

first_name

· Required: Yes.

· Rule: The entry must be text only.

· Reason for errors: The name has not been entered.

last_name

· Required: Yes.

· Rule: The entry must be text only.

· Reason for errors: The name has not been entered.

date_of_birth

· Required: Yes.

· Rule: Format must be dd/mm/yyyy

· Reasons for errors: The date has not been entered or is entered incorrectly.

employment_seafarer_rank

· Required: Yes.

· Rule: Use the rank display name from Martide. For more about seafarer ranks in Martide, see this page.

· Reasons for errors: The rank has not been entered or is entered incorrectly.

employment_vessel_imo

· Required: Yes.

· Rule: Entry must be 7 numbers

· Reasons for errors: The IMO has not been entered or is entered incorrectly.

employment_actual_sign_on

· Required: Yes.

· Rule: Format must be dd/mm/yyyy

· Reasons for errors: The date has not been entered or is entered incorrectly.

appraisal_type

· Required: Yes.

· Rule: The type must match one of the Appraisal Types in Martide. For more about Appraisal Types in Martide, see this page.

· Reason for errors: The type has not been entered or is invalid.

report_date

· Required: Yes.

· Rule: Format must be dd/mm/yyyy

· Reasons for errors: The date has not been entered or is entered incorrectly.

attachment_1

· Required: Yes.

· Rule: A URL that links to a publicly available attachment must be entered.

· Reasons for errors: The URL has not been entered or the document is invalid.

attachment_2-10

· Required: No.

· Rule: If using, a URL that links to a publicly available attachment must be entered.

· Reasons for errors: The document or link is invalid.

email

· Required: Yes.

· Rule: The email address must have at least one @ and one . (full stop/period.)

· Reasons for errors: The email has not been entered or is invalid.

first_name

· Required: Yes.

· Rule: The entry must be text only.

· Reason for errors: The name has not been entered.

last_name

· Required: Yes.

· Rule: The entry must be text only.

· Reason for errors: The name has not been entered.

date_of_birth

· Required: Yes.

· Rule: Format must be dd/mm/yyyy

· Reasons for errors: The date has not been entered or is entered incorrectly.

employment_seafarer_rank

· Required: Yes, if any other ‘Employment’ field is set.

· Rule: Use the rank display name from Martide. For more about seafarer ranks in Martide, see this page.

· Reasons for errors: The rank has not been entered or is invalid.

employment_vessel_imo

· Required: Yes, if any other ‘Employment’ field is set.

· Rule: Entry must be 7 numbers

· Reasons for errors: The IMO has not been entered or is entered incorrectly.

employment_actual_sign_on

· Required: Yes, if any other ‘Employment’ field is set.

· Rule: Format must be dd/mm/yyyy

· Reason for errors: The date has not been entered or is entered incorrectly.

assessment_type

· Required: Yes.

· Rule: Use the Assessment Type from Martide. For more about Assessment Types in Martide, see this page.

· Reason for errors: The assessment type has not been entered or is invalid.

assessment_date

· Required: Yes.

· Rule: Format must be dd/mm/yyyy

· Reason for errors: The date has not been entered or is entered incorrectly.

test_score

· Required: Yes.

· Rule: Must be a number from 0 to 100.

· Reason for errors: The date has not been entered

test_result

· Required: Yes.

· Rule: A URL that links to a publicly available attachment must be entered.

· Reason for errors: The date has not been entered

failed_test_answers

· Required: No.

· Rule: If using, a URL that links to a publicly available attachment must be entered.

· Reason for error: The document or link is invalid.

email

· Required: Yes.

· Rule: The email address must have at least one @ and one . (full stop/period.)

· Reasons for errors: The email has not been entered or is invalid.

first_name

· Required: Yes.

· Rule: The entry must be text only.

· Reason for errors: The name has not been entered.

last_name

· Required: Yes.

· Rule: The entry must be text only.

· Reason for errors: The name has not been entered.

date_of_birth

· Required: Yes.

· Rule: Format must be dd/mm/yyyy

· Reasons for errors: The date has not been entered or is entered incorrectly.

employment_seafarer_rank

· Required: Yes, if any other ‘Employment’ field is set.

· Rule: Use the rank display name from Martide. For more about seafarer ranks in Martide, see this page.

· Reasons for errors: The rank has not been entered or is invalid.

employment_vessel_imo

· Required: Yes, if any other ‘Employment’ field is set.

· Rule: Entry must be 7 numbers

· Reasons for errors: The IMO has not been entered or is entered incorrectly.

employment_actual_sign_on

· Required: Yes, if any other ‘Employment’ field is set.

· Rule: Format must be dd/mm/yyyy

· Reason for errors: The date has not been entered or is entered incorrectly.

agreed_salary

· Required: Yes.

· Rule: The entry must be a number.

· Reasons for error: The salary has not been entered or is entered incorrectly.

currency_code

· Required: Yes.

· Rule: The entry must be an ISO 4217 currency code – for example PHP for Philippines Peso or USD for US Dollar. See Google if unsure.

· Reasons for error: The currency code has not been entered or is invalid.

contract_length

· Required: Yes.

· Rule: The entry must be a number.

· Reasons for errors: The number has not been entered or is invalid.

contract_length_unit

· Required: Yes.

· Rule: The entry must be months or days.

· Reasons for error: The unit has not been entered or is invalid

contract_variance

· Required: Yes.

· Rule: The entry must be a number.

· Reasons for error: The number has not been entered or is invalid.

contract_variance_unit

· Required: Yes.

· Rule: The entry must be months or days.

· Reasons for error: The unit has not been entered or is invalid

contract_start_date_effective_at

· Required: Yes.

· Rule: The entry must be the contract start date.

· Reasons for error: The date has not been entered or is invalid.

attachment_1

· Required: Yes.

· Rule: A URL that links to a publicly available attachment must be entered.

· Reasons for errors: The URL has not been entered or the document is invalid.

attachment_2-10

· Required: No.

· Rule: If using, a URL that links to a publicly available attachment must be entered.

· Reasons for errors: The document or link is invalid.

email

· Required: Yes.

· Rule: The email address must have at least one @ and one . (full stop/period.)

· Reasons for errors: The email has not been entered or is invalid.

first_name

· Required: Yes.

· Rule: The entry must be text only.

· Reasons for error: The name has not been entered.

last_name

· Required: Yes.

· Rule: The entry must be text only.

· Reasons for error: The name has not been entered.

date_of_birth

· Required: Yes.

· Rule: Format must be dd/mm/yyyy

· Reasons for errors: The date has not been entered or is entered incorrectly.

document_number

· Required: Yes.

· Rule: The entry must be a number.

· Reasons for error: The document number has not been entered.

country_of_issue

· Required: Yes.

· Rule: The entry must be the country’s ISO3 code. For example: PHL for Philippines – check Google if uncertain.

· Reasons for errors: The code has not been entered or is invalid.

start_date

· Required: Yes.

· Rule: Format must be dd/mm/yyyy

· Reasons for errors: The date has not been entered or is entered incorrectly.

end_date

· Required: No.

· Rule: If entered, the format must be dd/mm/yyyy

vessel_ecdis_type

· Required: Yes.

· Rule: The entry must be one of the ECDIS types in Martide.

· Reasons for errors: The type has not been entered or is invalid

attachment_1

· Required: Yes.

· Rule: A URL that links to a publicly available attachment must be entered.

· Reasons for errors: The URL has not been entered or the document is invalid.

attachment_2-10

· Required: No.

· Rule: If using, a URL that links to a publicly available attachment must be entered.

· Reasons for errors: The document or link is invalid.

email

· Required: Yes.

· Rule: The email address must have at least one @ and one . (full stop/period.)

· Reasons for errors: The email has not been entered or is invalid.

first_name

· Required: Yes.

· Rule: The entry must be text only.

· Reason for errors: The name has not been entered.

last_name

· Required: Yes.

· Rule: The entry must be text only.

· Reason for errors: The name has not been entered.

date_of_birth

· Required: Yes.

· Rule: Format must be dd/mm/yyyy

· Reasons for errors: The date has not been entered or is entered incorrectly.

document_type

· Required: Yes.

· Rule: The Document Type must match the types in Martide: Certificates, Endorsements, Licenses, Medical Examinations, Trainings, Travel. They can be the original name OR the display name. For more about Document Types in Martide, please see this page.

· Reason for errors: The type has not been entered or is invalid.

document_number

· Required: Yes.

· Rule: The entry must be a number.

· Reason for errors: The number has not been entered.

country_of_issue

· Required: Yes.

· Rule: The entry must be the country’s ISO3 code. For example: PHL for Philippines – check Google if uncertain.

· Reasons for errors: The code has not been entered or is invalid.

start_date

· Required: Yes.

· Rule: The format must be dd/mm/yyyy

· Reason for errors: The date has not been entered or is entered incorrectly.

end_date

· Required: No.

· Rule: If entered, the format must be dd/mm/yyyy

attachment_1

· Required: Yes.

· Rule: A URL that links to a publicly available attachment must be entered.

· Reasons for errors: The URL has not been entered or the document is invalid.

attachment_2-10

· Required: No.

· Rule: If using, a URL that links to a publicly available attachment must be entered.

· Reasons for errors: The document or link is invalid.

email

· Required: Yes.

· Rule: The email address must have at least one @ and one . (full stop/period.)

· Reasons for errors: The email has not been entered or is invalid.

first_name

· Required: Yes.

· Rule: The entry must be text only.

· Reason for errors: The name has not been entered.

last_name

· Required: Yes.

· Rule: The entry must be text only.

· Reason for errors: The name has not been entered.

date_of_birth

· Required: Yes.

· Rule: Format must be dd/mm/yyyy

· Reasons for errors: The date has not been entered or is entered incorrectly.

employment_seafarer_rank

· Required: Yes, if any other ‘Employment’ field is set.

· Rule: Use the rank display name from Martide. For more about seafarer ranks in Martide, see this page.

· Reasons for errors: The rank has not been entered or is invalid.

employment_vessel_imo

· Required: Yes, if any other ‘Employment’ field is set.

· Rule: Entry must be 7 numbers

· Reasons for errors: The IMO has not been entered or is entered incorrectly.

employment_actual_sign_on

· Required: Yes, if any other ‘Employment’ field is set.

· Rule: Format must be dd/mm/yyyy

· Reason for errors: The date has not been entered or is entered incorrectly.

document_type

· Required: Yes.

· Rule: Medical Document Type must match one of those in Martide where the category is Medical. For more about Document Types in Martide, please see this page.

· Reasons for errors: The document type has not been entered or is invalid.

document_number

· Required: Yes.

· Rule: Entry must be a number.

· Reasons for errors: The number has not been entered.

country_of_issue

· Required: Yes.

· Rule: The entry must be the country’s ISO3 code. For example: PHL for Philippines – check Google if uncertain.

· Reasons for errors: The code has not been entered or is invalid.

start_date

· Required: Yes.

· Rule: Format must be dd/mm/yyyy

· Reasons for errors: The date has not been entered or is invalid.

end_date

· Required: No.

· Rule: Format must be dd/mm/yyyy

attachment_1

· Required: Yes.

· Rule: A URL that links to a publicly available attachment must be entered.

· Reasons for errors: The URL has not been entered or the document is invalid.

attachment_2-10

· Required: No.

· Rule: If using, a URL that links to a publicly available attachment must be entered.

· Reasons for errors: The document or link is invalid.

email

· Required: Yes.

· Rule: The email address must have at least one @ and one . (full stop/period.)

· Reasons for errors: The email has not been entered or is invalid.

first_name

· Required: Yes.

· Rule: The entry must be text only.

· Reason for errors: The name has not been entered.

last_name

· Required: Yes.

· Rule: The entry must be text only.

· Reason for errors: The name has not been entered.

date_of_birth

· Required: Yes.

· Rule: Format must be dd/mm/yyyy

· Reasons for errors: The date has not been entered or is entered incorrectly.

document_type

· Required: Yes.

· Rule: The Document Type must match the Vaccination Document Types in Martide. They can be the original name OR the display name. For more about Document Types in Martide, please see this page.

· Reasons for errors: The type has not been entered or is invalid.

document_number

· Required: No.

· Rule: If entered the entry must be a number.

vaccine_brand

· Required: No.

· Rule: If entered the entry must be text.

country_of_issue

· Required: No.

· Rule: If used, the entry must be the country’s ISO3 code. For example: PHL for Philippines – check Google if uncertain.

· Reasons for errors: The code is invalid.

start_date

· Required: Yes.

· Rule: Format must be dd/mm/yyyy

· Reasons for errors: The date has not been entered or is invalid.

end_date

· Required: No.

· Rule: Format must be dd/mm/yyyy

attachment_1

· Required: Yes.

· Rule: A URL that links to a publicly available attachment must be entered.

· Reasons for errors: The URL has not been entered or the document is invalid.

attachment_2-10

· Required: No.

· Rule: If using, a URL that links to a publicly available attachment must be entered.

· Reasons for errors: The document or link is invalid.

email

· Required: Yes.

· Rule: The email address must have at least one @ and one . (full stop/period.)

· Reasons for errors: The email has not been entered or is invalid.

first_name

· Required: Yes.

· Rule: The entry must be text only.

· Reason for errors: The name has not been entered.

last_name

· Required: Yes.

· Rule: The entry must be text only.

· Reason for errors: The name has not been entered.

date_of_birth

· Required: Yes.

· Rule: Format must be dd/mm/yyyy

· Reasons for errors: The date has not been entered or is entered incorrectly.

country_of_issue

· Required: Yes.

· Rule: The entry must be the country’s ISO3 code. For example: PHL for Philippines – check Google if uncertain.

· Reasons for errors: The code has not been entered or is invalid.

visa_type

· Required: Yes.

· Rule: The Visa Type must match the Visa Types in Martide. For more about Visa Types in Martide, see this page.

· Reasons for errors: The type has not been entered or is invalid.

visa_number

· Required: Yes.

· Rule: The entry must be a number.

· Reason for errors: The number has not been entered.

start_date

· Required: Yes.

· Rule: Format must be dd/mm/yyyy

· Reasons for errors: The date has not been entered or is invalid.

end_date

· Required: No.

· Rule: Format must be dd/mm/yyyy

attachment_1

· Required: Yes.

· Rule: A URL that links to a publicly available attachment must be entered.

· Reasons for errors: The URL has not been entered or the document is invalid.

attachment_2-10

· Required: No.

· Rule: If using, a URL that links to a publicly available attachment must be entered.

· Reasons for errors: The document or link is invalid.