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
(Array)
AppointmentDateTimeLocal: Es la fecha de la cita con la que debio llegar
Request Body: AppointmentDateTimeLocal
DMSRONo: Es el número de Orden de Reparación que se le va a asgingar el presupuesto
Request Body: DMSRONo
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
EstimatedDeliveryDateTimeLocal: Es la fecha promesa de Entrega
Request Body: EstimatedDeliveryDateTimeLocal
DeliveryDateTimeLocal: Es la fecha de Entrega o facturada
Request Body: DeliveryDateTimeLocal
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
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
Z - Costeada o Facturad
Request Body: DMSROStatusCode
DMSROStatusName: Es el nombre del Status al que corresponde le Código
Request Body: DMSROStatusName
InMileage: Kilometraje con el que esta ingresando el vehículo
Request Body: InMileage
HangTagNo: Número de la Torre
Request Body: HangTagNo
HangTagColorName: Color de la torre
Request Body: HangTagColorName
SAEmployeeID: Es el Id del Asesor de Servicio que se le esta asignando por el DMS
Request Body: SAEmployeeID
SAEmployeeName: Nombre del asesor de Servicio
Request Body: SAEmployeeName
CustomerComment: Comentarios del Cliente
Request Body: CustomerComment
SAComment: Comentarios del Asesor de Servicio
Request Body: SAComment
DMSAppointmentNo: Número de la Cita
Request Body: DMSAppointmentNo
TotalPrice: Precio total de la Orden de Reparación
Request Body: TotalPrice
TotalPriceIncludeTax: Precio Total de la Orden de Raparación con Impuestos
Request Body: TotalPriceIncludeTax
(Array)
Code: Código de operación para la Mano de Obra
Request Body: Code
OPDescription: Descripción el Código de Operación
Request Body: OPDescription
EstimatedHours: Son las horas que estan en el sistema de Tiempos del OEM, expresado en horas
Request Body: EstimatedHours
LaborUnitPrice: Es el precio Unitario que se le cobra al cliente por hora
Request Body: LaborUnitPrice
LaborTotalPrice: Es el resultado del producto de "EstimatedHours" y "LaborUnitPrice"
Request Body: LaborTotalPrice
LaborTotalPriceIncludeTax: Es el precio total ya con los impuestos inlcuidos.
Request Body: LaborTotalPriceIncludeTax
(Array)
PartNumber: Es el número de parte que esta generando un movimiento en el Kardex
Request Body: PartNumber
Quantity: Es la cantidad de Piezas con la que se esta vendiendo
Request Body: Quantity
PartDescription: Es la Descripción del número de Parte
Request Body: PartDescription
PartUnitPrice: Precio unitario de las piezas
Request Body: PartUnitPrice
PartTotalPrice: Es el producto de "PartUnitPrice" y "Quantity"
Request Body: PartTotalPrice
PartTotalPriceIncludeTax: Es el precio de las partes incluyendo los impuestos
Request Body: PartTotalPriceIncludeTax
(Array)
LastName: NO APLICA
Request Body: LastName
MiddleName: NO APLICA.
Request Body: MiddleName
FirstName: NO APLICA
Request Body: FirstName
FullName: Nombre de la empresa.
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)
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
PackageDescription: Descripción del Paquete
Request Body: PackageDescription
PackageUnitPrice: Precio unitario del Paquete
Request Body: PackageUnitPrice
PackageTotalPrice: Precio total del paquete
Request Body: PackageTotalPrice
Response JSON
Request JSON
{
"DealerID":"NAMX10010",
"DealerGroupID":"11",
"RepairOrder":[
{
"AppointmentDateTimeLocal" :"1601762969",
"DMSRONo":"S2344",
"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":"Mi 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":"580",
"OPCode":[
{
"Code":"234",
"OPDescription":"Quitar Balatas",
"EstimatedHours":"0.7",
"LaborUnitPrice":"450",
"LaborTotalPrice":"315",
"LaborTotalPriceIncludeTax":"365.4"
},
{
"Code":"987",
"OPDescription":"Monta Balatas",
"EstimatedHours":"0.1",
"LaborUnitPrice":"450",
"LaborTotalPrice":"45",
"LaborTotalPriceIncludeTax":"52.2"
}
],
"Part":[
{
"PartNumber":"4687654",
"Quantity":"2",
"PartDescription":"Balatas",
"PartUnitPrice":"1500",
"PartTotalPrice":"3000",
"PartTotalPriceIncludeTax":"3480"
},
{
"PartNumber":"4687654",
"Quantity":"2",
"PartDescription":"Balatas",
"PartUnitPrice":"1500",
"PartTotalPrice":"3000",
"PartTotalPriceIncludeTax":"3480"
}
],
"Customer":[
{
"LastName":"N/A",
"MiddleName":"N/A",
"FirstName":"N/A",
"FullName":"Nombre de la empresa",
"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"
}
]
}
]
}