API Refacciones
URL
{URL}/APIMG/refacciones.php?Token=7j9uGIUfX3VbnzM
Method
POST
El API call se tiene que consumir en el momento en que estan dando salida o entrada a una refacción (Venta, Merma, Baja de Inventario, 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/refacciones.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
TransactionDate
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
InvoiceNo Es el numero de factura de la orden de reparación o de la venta de mostrador, en caso de tratarse de una cancelación, esta deberá contener la factura que fue emitida, y en caso de ser una devolución, de igual forma deberá contener la factura con la que fue emitida.
Request Body:InvoiceNo
SalesType Hace referencia al tipo de venta de acuerdo al tipo de reparación (1=Servicio,2=Mostrador, 3= Cancelación) , podra colocarse N/A siempre y cuando el TransactionType sea una entrada (02)
Request Body:SalesType
SalesServiceArea Hace referencia al canal de venta (1=Taller,2=Mostrador) (Regla de negocio cuando el SalesType es 1 el SalesServicesArea solo puede ser 1 y viceversa), se podrá colocar N/A siempre y cuando la variable de TransactionType sea una entrada (02) o una cancelación (3)
Request Body:SalesServiceArea
RFC Hace referencia al Registro Federal de Contribuyentes
Request Body:RFC
CustomerName Hace referencia al nombre del cliente en caso de ser fisica se colocara el nombre del cliente y en caso de ser persona moral el nombre de la empresa.
Request Body:CustomerName
DMSRONo Hace referencia al folio u orden de reparacion en caso de que en SalesType sea 1 se escribe la orden de reparación en caso de ser 2 se escribe el folio que se vendio en mostrador.
Request Body:DMSRONo
VIN Es el número de Serie compuesto de 17 digitos
Request Body:VIN
ModelYear Año del Modelo
Request Body:ModelYear
ModelName Nombre del Modelo Asignado por la Marca
Request Body:ModelName
FullModelName Nombre completo del Modelo del vehíuclo dado por la Marca
Request Body:FullModelName
InMileage Kilometraje con el que esta ingresando el vehículo
Request Body:InMileage
AreaType Hace referencia al tipo de orden indicada por MG.
Request Body:AreaType
| Si ServiceTypeName = DIAG, para AreaType enviar valor = Diagnostico / Campaña |
| Si ServiceTypeName = GAR, para AreaType enviar valor = Garantia |
| Si ServiceTypeName = HYP, para AreaType enviar valor = Hojalateria y Pintura |
| Si ServiceTypeName = INT, para AreaType enviar valor = Interna |
| Si ServiceTypeName = MAN, para AreaType enviar valor = Mantenimiento |
| Si ServiceTypeName = MANI, para AreaType enviar valor = Mantenimiento Incluido |
| Si ServiceTypeName = OT, para AreaType enviar valor = Otros |
| Si ServiceTypeName = PRE, para AreaType enviar valor = Previa |
| Si ServiceTypeName = REC, para AreaType enviar valor = Reclamación |
| Si ServiceTypeName = MEC, para AreaType enviar valor = Reparación |
| Si ServiceTypeName = SER, para AreaType enviar valor = Servicio |
ServiceTypeNameEs el tipo de servicio que tiene la orden al momento de darse de alta
Request Body:ServiceTypeName
| Enviar valor = DIAG (Si es Diagnostico / Campaña) |
| Enviar valor = GAR (Si es Garantia) |
| Enviar valor = HYP (Si es Hojalateria y Pintura) |
| Enviar valor = INT (Si es Interna) |
| Enviar valor = MAN (Si es Mantenimiento) |
| Enviar valor = MANI (Si es Mantenimiento Incluido) |
| Enviar valor = OT (Si es Otros) |
| Enviar valor = PRE (Si es Previa) |
| Enviar valor = REC (Si es Reclamación) |
| Enviar valor = MEC (Si es Reparación) |
| Enviar valor = SER (Si es Servicio) |
Nota: Solo compartir el valor de la palabra en Mayúscula
(Array)
StockPartNumber: Se manda el nuevo Stock Restando la venta que se esta realizando, Ejemplo:
Stock antes de la venta = 10
Venta = 2
Stock restando la venta = 8
Request Body: StockPartNumber
PartNumber: Es el número de parte que esta generando un movimiento en el Kardex
Request Body: PartNumber
PartDescription: Es la Descripción del número de Parte
Request Body: PartDescription
Quantity: Es la cantidad de Piezas con la que se esta vendiendo
Request Body: Quantity
TransactionType: Son los tipos de transacción que se tiene en un alamacén.
01 = Salida
02 = Entrada
03= Cancelación
04= Traspaso
Request Body: TransactionType
UnitPrice: Es el precio con el que se esta vendiendo antes de impuestos (El precio puede tener descuento si el Distribuidor así lo vendio). Es el precio real con el que se vende la refacción. Cuando sea una transacción ingreso o entrada de refacciones (TransactionType = 02) este dato debe de ir en 0.
Request Body: UnitPrice
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
UnitCost: Es el monto con el que el Distribuidor compro el Número de Parte.
Request Body: UnitCost
TotalCost: Es el monto con el que el Distribuidor compro el Número de Parte.
Request Body: TotalCost
PartType Seleccionar la columna del maestro de partes "PartType"
Request Body:PartType
Response JSON
Request JSON
{
"DealerID":"NAMX10004",
"DealerGroupID":"1",
"TransactionDate":"1603244559",
"SAEmployeeID":"1234", *
"SAEmployeeName":"Veronica Chande Franco",
"InvoiceNo":"NVASV0035682",
"SalesType":"1",
"SalesServiceArea":"1",
"SalesArea":"1",
"RFC":"FOSM820524T89",
"CustomerName":"Oscar Villalobos Gomez",
"DMSRONo":"031697",
"VIN":"3N1CN7AD8GK453281",
"ModelYear":"2016",
"ModelName":"MG5",
"FullModelName":"1.5L STD STYLE AT",
"InMileage":"20001",
"AreaType":"Publico",
"ServiceTypeName":"DIAG",
"Parts":[
{
"StockPartNumber":"10",
"PartNumber":"10432118",
"PartDescription":"STRAP ASM-F\/TNK",
"Quantity":"9",
"TransactionType":"01",
"UnitPrice":"357",
"TotalPrice":"3574.71",
"TotalPriceIncludeTax":"4146.66",
"UnitCost":"305.53",
"TotalCost":"2749.77",
"PartType":"Mecanica"
},
{
"StockPartNumber":"4",
"PartNumber":"10436397",
"PartDescription":"MOUNT ASM-TRANS",
"Quantity":"1",
"TransactionType":"02",
"UnitPrice":"243",
"TotalPrice":"4146",
"TotalPriceIncludeTax":"4146",
"UnitCost":"385.53",
"TotalCost":"385.53",
"PartType":"Mecanica"
}
]
}