Blueservices

Software Company

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://bluecorpssc/api/dmsventas.php?token=LJASDJ564FG

Objetos JSON

Ventas-JSON (Object)

DealerID: Id asignado al DMS por parte de la marca.
Request Body: DealerID (String | Requerido)

DealerGroupID: Id que asigna la marca al grupo del distribuidor.
Request Body: DealerGroupID (String | Requerido)

LastName: Apellidos del Cliente.
Request Body: LastName (String | Requerido)

MiddleName: Segundo Nombre del Cliente.
Request Body: MiddleName (String)

FirstName: Primer Nombre del Cliente.
Request Body: FirstName (String | Requerido)

FullName: Nombre Completo del Cliente.
Request Body: FullName (String | Requerido)

Gender: Género. 01 - Masculino 02 - Femenino
Request Body: Gender (String)

Email: Correo Electrónico del Cliente.
Request Body: Email (String | Format: Email)

RFC: RFC con Homoclave.
Request Body: RFC (String)

ContactType: Tipo de contacto (Owner=01, Contact=02).
Request Body: ContactType (String | Requerido)

ContactValue: Celular o teléfono del cliente.
Request Body: ContactValue (String | Requerido)

ContactMethodYN: ¿Quiere ser contactado? (Y/N).
Request Body: ContactMethodYN (String | Enum: "Y", "N")

AddressType: Tipo de dirección (Actual=0, Fiscal=1).
Request Body: AddressType (String | Requerido)

FullAddress: Dirección completa.
Request Body: FullAddress (String | Requerido)

ZipCode: Código Postal.
Request Body: ZipCode (String | Requerido)

CountryName: Nombre del país.
Request Body: CountryName (String)

StateRegionName: Nombre del Estado.
Request Body: StateRegionName (String)

CityName: Nombre de la Ciudad.
Request Body: CityName (String)

Address1 a Address5: Líneas de dirección.
Request Body: (String)

SellingDateTimeLocal: Fecha de facturación.
Request Body: SellingDateTimeLocal (String)

SellingNoOrder: Número de factura.
Request Body: SellingNoOrder (String | Requerido)

TotalPrice: Precio antes de impuestos.
Request Body: TotalPrice (String | Requerido)

TotalPriceIncludeTax: Precio con impuestos.
Request Body: TotalPriceIncludeTax (String)

DeliveryDate: Fecha de entrega (Unix).
Request Body: DeliveryDate (String)

SalesType: (1: Salida, 2: Cancelación).
Request Body: SalesType (String)

PayType: (1: Contado, 2: Financiado).
Request Body: PayType (String)

VIN: Número de Serie (17 dígitos).
Request Body: VIN (String | Requerido)

ModelName: Nombre del Modelo.
Request Body: ModelName (String | Requerido)

ModelYear: Año del Modelo.
Request Body: ModelYear (String | Requerido)

LastMileage: Kilometraje de venta.
Request Body: LastMileage (String)

TransmissionTypeName: (01: Manual, 02: Aut, 03: CVT, 04: DCT).
Request Body: TransmissionTypeName (String)

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":"1764779715",
                                                            "SellingNoOrder":"03122025",
                                                            "TotalPrice":"350123",
                                                            "TotalPriceIncludeTax":"406,142.68",
                                                            "DeliveryDate":"1762291760",
                                                            "SalesType":"2",
                                                            "PayType":"1"
                                                        }
                                                    ],
                                                    "Vehicle":[
                                                        {
                                                            "DMSVehicleNo":"03122025",
                                                            "LicensePlateNo":"GT4552",
                                                            "LastMileage":"15",
                                                            "Cylinders":"4",
                                                            "VIN":"LSJLL4U91SZ133772",
                                                            "ModelName":"MG3",
                                                            "FullModelName":"MG3",
                                                            "ModelYear":"2021",
                                                            "ExteriorColorName":"Blanco York",
                                                            "InteriorColorName":"Negro",
                                                            "TransmissionTypeName":"02",
                                                            "Versionname":"Style 1.5 plus"
                                                        }
                                                    ]
                                                }