Accueil / Home

Import : contrat de vente /sale contract

PHP example

Important Notes

<synchronisation>sale_contract</synchronisation>

Query

<query>
	<date>unix time</date>
	<synchronisation>sale_contract</synchronisation>
	<mode>import</mode>
	<partner_id>string</partner_id>
	<partner_key>string</partner_key>
	<filter>
		<seller>
			<id>integer</id>
		</seller>
		<contract>
			<number>string</number>
		</contract>
	</filter>
</query>

Response

<response>
	<date>date ISO 8601</date>
	<mode>import</mode>
	<synchronisation>sale_contract</synchronisation>
	<partner_id>string</partner_id>
	<status>success|error</status>
	<message>string</message>
	<data>
		<seller>
			<id>integer</id>
		</seller>
		<!-- When success -->
		<customer>
			<id>integer</id><!-- customer ID in GVO -->
			<type>individual|dealer</type>
			<contact>
				<last_name>string</last_name>
				<first_name>string</first_name>
				<birth_date>YYYY-MM-DD</birth_date>
				<language>fr|en</language>
				<gender>male|female</gender>
				<address>string</address>
				<municipality>string</municipality>
				<province>string</province>
				<country>string</country>
				<postal_code>string</postal_code>
				<home_phone>(000) 000-0000</home_phone>
				<!-- Optional fields -->
				<home_extension>string</home_extension>
				<address_line2>string</address_line2>
				<secondary_phone>(000) 000-0000</secondary_phone>
				<secondary_phone_extension>integer</secondary_phone_extension>
				<email>string</email>
				<driver_licence>string</driver_licence>
				<saaq_file_number>string</saaq_file_number>
				<!-- /Optional fields -->
			</contact>
			<!-- When customer is dealer type -->
			<dealer>
				<company_name>string</company_name>
				<license_number>string</license_number>
				<!-- Optional fields -->
				<gst_number>string</gst_number>
				<pst_number>string</pst_number>
				<hst_number>string</hst_number>
				<exemption_number>string</exemption_number>
				<!-- /Optional fields -->
			</dealer>
			<!-- /When if customer is dealer type -->
		</customer>
		<contract>
			<number>string</number>
			<status>
				<fr>string</fr>
				<en>string</en>
			</status>
			<date>YYYY-MM-DD</date>
			<date_delivery>YYYY-MM-DD</date_delivery>
			<creditor_name>string</creditor_name>
			<vehicle_sold>
				<id>integer</id><!-- vehicule ID in GVO -->
				<value>float</value>
				<market_value>float</market_value>
				<vin>string</vin>
				<unit_number>string</unit_number>
				<model>string</model>
				<sub_model>
					<fr>string</fr>
					<en>string</en>
				</sub_model>
				<make>string</make>
				<year>integer</year>
				<color>
					<outside>
						<fr>string</fr>
						<en>string</en>
					</outside>
				</color>
				<weight>float</weight>
				<cylinders>
					<fr>string</fr>
					<en>string</en>
				</cylinders>
				<odometer>
					<type>integer</type>
					<display>integer</display>
					<real>integer</real>
				</odometer>
			</vehicle_sold>
			<vehicle_exchanged>
				<id>integer</id><!-- vehicule ID in GVO -->
				<value>float</value>
				<value_due>float</value_due>
				<vin>string</vin>
				<model>string</model>
				<make>string</make>
				<year>integer</year>
				<color>
					<outside>
						<fr>string</fr>
						<en>string</en>
					</outside>
				</color>
				<weight>float</weight>
				<cylinders>integer</cylinders>
				<odometer>
					<type>integer</type>
					<display>integer</display>
					<real>integer</real>
				</odometer>
			</vehicle_exchanged>
			<tax>
				<type>integer</type>
				<!-- Percentage -->
				<gst>float</gst>
				<pst>float</pst>
				<hst>float</hst>
				<amf>float</amf>
				<loan_insurance>float</loan_insurance>
				<replacement_insurance>float</replacement_insurance>
			</tax>
			<dealer>
				<license_number>string</license_number>
				<sale_consultant>string</sale_consultant>
				<place>string</place>
				<gst_number>string</gst_number>
				<pst_number>string</pst_number>
				<hst_number>string</hst_number>
			</dealer>
			<price>
				<misc_fees>float</misc_fees>
				<misc_discounts>float</misc_discounts>
				<accessory_and_misc>
					<accessory_list><!-- max of 5 -->
						<accessory>
							<name>string</name>
							<value>float</value>
						</accessory>
						<accessory>...</accessory>
					</accessory_list>
					<additional_warranty>float</additional_warranty>
					<recycquebec_and_new_tires_tax>float</recycquebec_and_new_tires_tax>
					<tax>
						<gst>float</gst>
						<pst>float</pst>
						<hst>float</hst>
					</tax>
				</accessory_and_misc>
				<rdprm_consultation_fee>float</rdprm_consultation_fee>
				<credit_insurance>
					<value>float</value>
					<tax>float</tax>
				</credit_insurance>
				<assurance_remplacement>
					<value>float</value>
					<tax>float</tax>
				</assurance_remplacement>
				<transit>float</transit>
				<deposit>float</deposit>
				<other_rebate><!-- Fields not obligatory -->
					<name>string</name>
					<value>float</value>
				</other_rebate>
			</price>
			<total>
				<vehicule>
					<!-- Vehicle price + Misc. fees - Misc. discounts - Exchanged vehicle -->
					<sub_total>float</sub_total>
					<tax>
						<gst>float</gst>
						<pst>float</pst><!-- on vehicule price or A.S.P. - 500 -->
						<pst_saaq>float</pst_saaq>
						<hst>float</hst>
					</tax>
				</vehicule>
				<due>float</due><!-- Total due at delivery -->
			</total>
			<warranty>
				<legal>interger</legal>
				<seller>
					<included>1|0</included>
					<!-- When included -->
					<day>integer</day>
					<km>integer</km>
					<description>string</description>
					<!-- /When included -->
				</seller>
				<third_party>
					<included>1|0</included>
					<!-- When included -->
					<company>string</company>
					<month>integer</month>
					<km>integer</km>
					<description>string</description>
					<!-- /When included -->
				</third_party>
			</warranty>
			<note>string</note><!-- MAX 600 characters -->
		</contract>
		<!-- /When success -->
		<!-- When error -->
		<contract>
			<number>string</number>
		</contract>
		<!-- /When error -->
	</data>
</response>