API DMS Servicio
URL
{URL}/APIMG/APIDMSServicio.php?token=7j9uGIUfX3VbnzM
Method
POST
Se consumira el API Call cuando se cree la orden de reparación, Cuando exista una Actualización en la Orden de Reparación, Status, Montos, Fecha Estimada de Entrega, etc.
IP DMS
Se validará la IP de donde nos manda la información.
Ejemplo: 187.163.169.59
SANDBOX
https://blueservicessc-sandbox.com/APIMG/APIDMSServicio.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 (String y requerido)
(Array)
AppointmentDateTimeLocal: Es la fecha de la cita con la que debio llegar
Request Body: AppointmentDateTimeLocal (String y requerido)
DMSRONo: Es el número de Orden de Reparación que se le va a asgingar el presupuesto
Request Body: DMSRONo (String y requerido)
InvoiceNoEs el numero de factura de la orden de reparación o de la venta de mostrador.
Request Body:InvoiceNo (String y requerido)
ServiceTypeName: Es el tipo de servicio que tiene la orden al momento de darse de alta
DIAG - Diagnostico / Campaña
GAR - Garantia
HYP - Hojalateria y Pintura
INT - Interna
MAN - Mantenimiento
MANI - Mantenimiento Incluido
OT - Otros
PRE - Previa
REC - Reclamación
MEC - Reparación
SER - Servicio
Request Body: ServiceTypeName
CheckInDateTimeLocal: Es la hora en que ingreso el vehículo a la Agencia. Esta fecha se debe de mandar en Fecha UNIX
Request Body: CheckInDateTimeLocal (String y requerido)
EstimatedDeliveryDateTimeLocal: Es la fecha promesa de Entrega
Request Body: EstimatedDeliveryDateTimeLocal (String y requerido)
DeliveryDateTimeLocal: Es la fecha de Entrega o facturada
Request Body: DeliveryDateTimeLocal (String y requerido)
DMSROStatusCode:
A - Pendiente por Autorización
B - Reservado
C - Cerrado
D - Pendiente por Diagnostico
E - TOT Bon Pendiente
F - En control de Calidad
G - Unidad Fuera pero no Facturada
H - Unidad Fuera pendiente por Refacciones
I - Cancelada
J - Asignada
K - Garantias en Proceso
L - Pendiente por Mano de Obra
M - Presupuesto
N - Re agendado
O - No Show
P - Pendiente por refacciones
Q - Refacciones Entregadas
W - En Proceso
X - Facturada
Z - Costeada o Facturad
Request Body: DMSROStatusCode (String y requerido)
DMSROStatusName: Es el nombre del Status al que corresponde le Código
Request Body: DMSROStatusName (String y requerido)
InMileage: Kilometraje con el que esta ingresando el vehículo
Request Body: InMileage (String y requerido)
HangTagNo: Número de la Torre
Request Body: HangTagNo (String y requerido)
HangTagColorName: Color de la torre
Request Body: HangTagColorName (String y requerido)
SAEmployeeID: Es el Id del Asesor de Servicio que se le esta asignando por el DMS
Request Body: SAEmployeeID (String y requerido)
SAEmployeeName: Nombre del asesor de Servicio
Request Body: SAEmployeeName (String y requerido)
CustomerComment: Comentarios del Cliente
Request Body: CustomerComment (String y requerido)
SAComment: Comentarios del Asesor de Servicio
Request Body: SAComment (String y requerido)
DMSAppointmentNo: Número de la Cita
Request Body: DMSAppointmentNo (String y requerido)
TotalPrice: Precio total de la Orden de Reparación
Request Body: TotalPrice (String y requerido)
TotalPriceIncludeTax: Precio Total de la Orden de Raparación con Impuestos
Request Body: TotalPriceIncludeTax (String y requerido)
TotalCost: Es la suma de los TOTS,Refacciones y mano de obra.
Request Body: TotalCost (String y requerido)
TotalCostIncludeTax: Es el totalcost mas el IVA correspondiente.
Request Body: TotalCostIncludeTax (String y requerido)
(Array)
Code: Código de operación para la Mano de Obra
Request Body: Code
Ejemplo:
S10MO, según el servicio que se realice, si se realiza un servicio de 30,000 km este debe mandarse como
S30MO
OPDescription: Descripción el Código de Operación
Request Body:
OPDescription (String y requerido) EstimatedHours: Son las horas que estan en el sistema de Tiempos del OEM, expresado en horas
Request Body:
EstimatedHours (String y requerido) LaborUnitPrice: Es el precio Unitario que se le cobra al cliente por hora
Request Body:
LaborUnitPrice (String y requerido) LaborTotalPrice: Es el resultado del producto de "EstimatedHours" y "LaborUnitPrice"
Request Body:
LaborTotalPrice (String y requerido) LaborTotalPriceIncludeTax: Es el precio total ya con los impuestos inlcuidos.
Request Body:
LaborTotalPriceIncludeTax (String y requerido)LaborUnitCost: Hace referencia al costo de mano de obra.
Request Body:
LaborUnitCost (String y requerido) LaborTotalCost: Hace referencia al valor de LaborUnitCost por horas trabajadas.
Request Body:
LaborTotalCost (String y requerido)
(Array)
TOTCost: Hace referencia al costo que cobra el proveedor de TOTS
Request Body: TOTCost (String y requerido)
TOTPrice: Hace referencia al precio publico con el que se vendio el TOT.
Request Body: TOTPrice (String y requerido)
TotalCostIncludeTax: Hace referencia al costo total del TOT mas el IVA.
Request Body: TotalCostIncludeTax (String y requerido)
TotalPriceIncludeTax: Hace referencia al precio total del TOT mas el IVA.
Request Body: TotalPriceIncludeTax (String y requerido)
Descripcion: Hace referencia al concepto de TOT
Request Body: Descripcion (String y requerido)
Code: Hace referencia al codigo de mano de obra de TOT definido por MG
Request Body: Code (String y requerido)
(Array)
PartNumber: Es el número de parte que esta generando un movimiento en el Kardex
Request Body: PartNumber (String y requerido)
Quantity: Es la cantidad de Piezas con la que se esta vendiendo
Request Body: Quantity (String y requerido)
PartDescription: Es la Descripción del número de Parte
Request Body: PartDescription (String y requerido)
PartUnitPrice: Precio unitario de las piezas
Request Body: PartUnitPrice (String y requerido)
PartTotalPrice: Es el producto de "PartUnitPrice" y "Quantity"
Request Body: PartTotalPrice (String y requerido)
PartTotalPriceIncludeTax: Es el precio de las partes incluyendo los impuestos
Request Body: PartTotalPriceIncludeTax (String y requerido)
(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. Este valor es único e irrepetible
Request Body: RFC (String y requerido)
(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)
LicensePlateNo: Si el vehículo se entrega con placa apuntar el número de pacas.
Request Body: LicensePlateNo
VIN: Es el número de Serie compuesto de 17 digitos
Request Body: VIN (String y Requerido)
(Array)
PackageCode: Código de Paquete
Request Body: PackageCode (String y requerido)
PackageDescription: Descripción del Paquete
Request Body: PackageDescription (String y requerido)
PackageUnitPrice: Precio unitario del Paquete
Request Body: PackageUnitPrice (String y requerido)
PackageTotalPrice: Precio total del paquete
Request Body: PackageTotalPrice (String y requerido)
Response JSON
Request JSON
{
"DealerID":"NAMX10010",
"DealerGroupID":"11",
"RepairOrder":[
{
"AppointmentDateTimeLocal" :"1601762969",
"DMSRONo":"S2344",
"InvoiceNo":"NVAHB0001202",
"ServiceTypeName":"DIAG",
"CheckInDateTimeLocal":"1601762969",
"EstimatedDeliveryDateTimeLocal":"1601762969",
"DeliveryDateTimeLocal":"1601762969",
"DMSROStatusCode":"W",
"DMSROStatusName":"En Procesos",
"InMileage":"10,000",
"HangTagNo":"15",
"HangTagColorName":"Rojo",
"SAEmployeeID":"23",
"SAEmployeeName":"Cinthia Domniguez",
"CustomerComment":"i vehiculo tiene un sonido al momento de pasar los topes.",
"SAComment":"Revisar las balatas por que el liquido de freno esta bajo.",
"DMSAppointmentNo":"5481",
"TotalPrice":"5000",
"TotalPriceIncludeTax":"5580",
"TotalCost":"5000",
"TotalCostIncludeTax":"580",
"OPCode":[
{
"Code":"234",
"OPDescription":"Quitar Balatas", VALIDAR DIFERENCIAS
"EstimatedHours":"0.7",
"LaborUnitPrice":"450",
"LaborTotalPrice":"315",
"LaborTotalPriceIncludeTax":"365.4",
"LaborUnitCost":"200",
"LaborTotalCost": "140"
},
{
"Code":"987",
"OPDescription":"Monta Balatas",
"EstimatedHours":"0.1",
"LaborUnitPrice":"450",
"LaborTotalPrice":"45",
"LaborTotalPriceIncludeTax":"52.2",
"LaborUnitCost":"200",
"LaborTotalCost": "140"
}
],
"TOTS":[
{
"TOTCost":"234.43",
"TOTPrice":"500.60",
"TotalCostIncludeTax":"271.93",
"TotalPriceIncludeTax":"580",
"Descripcion": "rectificado de discos",
"Code": 987
}
],
"Part":[
{
"PartNumber":"4687654",
"Quantity":"2",
"PartDescription":"Balatas",
"PartUnitPrice":"1500",
"PartTotalPrice":"3000",
"PartTotalPriceIncludeTax":"3480",
"PartUnitCost":"1000",
"PartTotalCost":"2000",
"PartTotalCostIncludeTax":"2320"
},
{
"PartNumber":"4687654",
"Quantity":"2",
"PartDescription":"Balatas",
"PartUnitPrice":"1500",
"PartTotalPrice":"3000",
"PartTotalPriceIncludeTax":"3480",
"PartUnitCost":"1000",
"PartTotalCost":"2000",
"PartTotalCostIncludeTax":"2320"
}
],
"Customer":[
{
"LastName":"Ota",
"MiddleName":"N/A",
"FirstName":"Nami",
"FullName":"Nami Ota",
"Gender":"01",
"Email":"otanami@gmail.com",
"RFC":"NAOT821115L87",
"Contacts":[
{
"ContactType":"01",
"ContactValue":"5555045874",
"ContactMethodYN":"Y"
},
{
"ContactType":"02",
"ContactValue":"5555958745",
"ContactMethodYN":"N"
}
]
}
],
"Vehicle":[
{
"LicensePlateNo":"OIJ32J",
"VIN":"LSJA36E34MZ015019"
}
],
"Package":[
{
"PackageCode":"AZ10000",
"PackageDescription":"MANTENIMIENTO 10000",
"PackageUnitPrice":"5000",
"PackageTotalPrice":"5000",
"PackageTotalPriceIncludeTax":"580"
}
]
}
]
}