API Ventas
URL
{URL}/APIMG/dmsventas?Token=7j9uGIUfX3VbnzM
Method
POST
Esta API Call se consumira cuando al momento de realizar una Factura en el DMS. En tiempo real debe de mandar la información del Vehículo Nuevo.
IP DMS
Se validará la IP de donde nos manda la información.
Ejemplo: 187.163.169.59
SANDBOX
https://blueservicessc-sandbox.com/APIMG/dmsventas.php?token=7j9uGIUfX3VbnzM
Objetos JSON
DealerID: Id asignado al DMS por parte de la marca.
Request Body: DMSDealerID (String y Requerido)
DealerGroupID: Id que asigna la marca al grupo del distribuidor.
Request Body: DealerGroupID
(Array)
LastName: Apellidos del Cliente.
Request Body: LastName (String y Requerido)
MiddleName: Segundo Nombre del Cliente.
Request Body: MiddleName (String y Requerido)
FirstName: Primer Nombre del Cliente.
Request Body: FirstName (String y Requerido)
FullName: Nombre Completo del Cliente.
Request Body: FullName (String y Requerido)
Gender: Género. 01 - Masculino 02 - Femenino
Request Body: Gender (String y Requerido)
Email: Correo Electrónico del Cliente.
Request Body: Email (String y Requerido)
RFC: Se tiene que mandar el RFC con Homoclave del empleado. Este valor es único e irrepetible
Request Body: RFC
(Array)
ContactType: Tipo de contacto.
Owner = 01
Contact = 02 Request Body: DMSDealerID
Contactvalue: Se escribe el celular o teléfono al que se le puede llamar al cliente.
Owner = 01
Contact = 02
Request Body: ContactValue
ContactMethodYN: Indica si el cliente quiere ser contactado.
Y = Cliente se le contacta
N = Cliente no se contacta
Request Body: ContactMethodYN
(Array)
AddressType: Solo se tiene el tipo de dirección.
Actual = 0
Fiscal = 1
Request Body: AddressType
FullAddress: Dirección completa del cliente
Request Body: FullAddress
ZipCode: Código Postal.
Request Body: ZipCode (String y Requerido)
CountryName:
StateRegionName: Nombre del Estado donde se vendio el vehículo. Nombre interno del DMS
Request Body: StateRegionName
CityName: Nombre de la Ciudad
Request Body: CityName
DistrictName: Nombre de distrito o delegación. Nombre interno del DMS.
Request Body: DistrictName
LocalityName: Request Body: LocalityName
Address1: Se escribe la dirección
Request Body: Address1
Address2
Address3
Address4
Address5
(Array)
SellingDateTimeLocal: Se manda la fecha en que se facturo el vehículo
Request Body: SellingDateTimeLocal
SellingNoOrder: Numero de venta o numero de factura
Request Body: SellingNoOrder
TotalPrice: Es la multiplicación del UnitPrice y Quantity para obtener el precio total antes de impuestos
Request Body: TotalPrice
TotalPriceIncludeTax: Es el precio que se tiene más los impuestos que en ese momento este cobrando el gobierno
Request Body: TotalPriceIncludeTax
(Array)
DMSVehicleNo:
LicensePlateNo: Si el vehículo se entrega con placa apuntar el número de pacas.
Request Body: LicensePlateNo
LastMileage: Se coloca el kilometraje con el que se vende el vehículo
Request Body: LastMileage
Cylinders:
VIN: Es el número de Serie compuesto de 17 digitos
Request Body: VIN (String y Requerido)
ModelName: Nombre del Modelo Asignado por la Marca
Request Body: ModelName (String y Requerido)
FullModelName: Nombre completo del Modelo del vehíuclo dado por la Marca
Request Body: FullModelName (String y Requerido)
ModelYear: Año del Modelo
Request Body: ModelYear (String y Requerido)
ExteriorColorName: Nombre del color exterior del vehículo
Request Body: ExteriorColorName (String y Requerido)
InteriorColorName: Nombre del color del interior del vehículo
Request Body: InteriorColorName (String y Requerido)
TransmissionTypeName: Tipo de Transmisión
01.- Manual
02.- Automatico
03.- CVT
04.-DCT
Request Body: TransmissionTypeName (String y Requerido)
Response JSON
Request Parameters
{
"DealerID":"NAMX10010",
"DealerGroupID":"11",
"Customer":[
{
"LastName":"alvarez lopez",
"MiddleName":"N/A",
"FirstName":"erick",
"FullName":"Erick Alvarez Lopez",
"Gender":"02",
"Email":"ricardo.rodriguez@globaldms.com.mx",
"RFC":"OTANAM8985l98",
"Contacts":[
{
"ContactType":"01",
"ContactValue":"4771856012",
"ContactMethodYN":"N"
},
{
"ContactType":"02",
"ContactValue":"4777138221",
"ContactMethodYN":"Y"
}
]
}
],
"Addresses":[
{
"AddressType":"0",
"FullAddress":"MANUEL M PONCE 1313",
"ZipCode":"37480",
"CountryName":"Mexico",
"StateRegionName":"GUANAJUATO",
"CityName":"LEON",
"DistrictName":"GUANAJUATO",
"LocalityName":"LEON",
"Address1":"MANUEL M PONCE",
"Address2":"1313",
"Address3":"LEON MODERNO",
"Address4":"N/A",
"Address5":"N/A"
},
{
"AddressType":"1",
"FullAddress":"Florida 12",
"ZipCode":"53101",
"CountryName":"Mexico",
"StateRegionName":"Ciudad de Mexico",
"CityName":"Ciudad de Mexico",
"DistrictName":"Naucalpan de Juearez",
"LocalityName":"Echegarai",
"Address1":"LEON MODERNO",
"Address2":"N/A",
"Address3":"N/A",
"Address4":"N/A",
"Address5":"N/A"
}
],
"Sellingorder":[
{
"SellingDateTimeLocal":"1603145924",
"SellingNoOrder":"780",
"TotalPrice":"350123",
"TotalPriceIncludeTax":"406,142.68"
}
],
"Vehicle":[
{
"DMSVehicleNo":"NU202012",
"LicensePlateNo":"GT4552",
"LastMileage":"15",
"Cylinders":"4",
"VIN":"LSJA36E34MZ026029",
"ModelName":"MG5",
"FullModelName":"MG5",
"ModelYear":"2021",
"ExteriorColorName":"Blanco York",
"InteriorColorName":"Negro",
"TransmissionTypeName":"02"
}
]
}