Documentación oficial para realizar las implementaciones de los servicios API de CT-CONNECT donde se hara la integracion de nuestro catalogo a su tienda online.
Las credenciales de autenticación son utilizadas para acreditación de todas las llamadas al servidor de CT-CONNECT por medio de la autenticación basada en Tokens.
Se requiere solicitar integración a un representante CT para poder generar un token valido y vigente.
Para genrar un token son necesarios 3 atributos proporcionados por un representante de CT
email required | string Correo con el cual se registro como cliente CT |
cliente required | string Número de cliente CT |
rfc required | string RFC proporcionado en el registro como cliente CT |
{- "cliente": "HMO0000",
- "rfc": "XX10XX100X1XX01"
}
{- "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJfaWQiOiI1ODZkNTM5MmY1ZmYwZjQ5NTcwOTk5ZjYiLCJhY2Nlc3MiOiJhdXRoIiwiaWF0IjoxNDgzNTU5OTM0fQ.lHoLBCLDYiM6jmgnxTdj0v5GGB8jkpiJtZF2Obyh9X4",
- "time": "2023-11-23T18:30:02.046Z"
}
Listado completo de articulos para la verificacion de existencia, promociones y precio. Solo puede ser utilizado con token valido y vigente.
x-auth required | string Token de autorización |
[- {
- "codigo": "ACCBLC010",
- "precio": 6.14,
- "moneda": "USD",
- "almacenes": [
- {
- "promocion": {
- "precio": 5.37,
- "vigente": {
- "ini": "2019-01-19T07:00:00.000Z",
- "fin": "2019-02-01T07:00:00.000Z"
}
}, - "14A": 2
}, - {
- "promocion": {
- "precio": 5.37,
- "vigente": {
- "ini": "2019-01-19T07:00:00.000Z",
- "fin": "2019-02-01T07:00:00.000Z"
}
}, - "46A": 2
}
]
}
]
Verificar la existencia por artículo en almacenes solo puede ser realizado con el código, un token valido y vigente.
codigo required | string Clave CT del articulo a consultar |
x-auth required | string Token de autorización |
{- "01A": {
- "existencia": 2774
}, - "02A": {
- "existencia": 0
}, - "03A": {
- "existencia": 801
}, - "04A": {
- "existencia": 7
}, - "05A": {
- "existencia": 13
}, - "06A": {
- "existencia": 14
}, - "07A": {
- "existencia": 47
}, - "08A": {
- "existencia": 6
}, - "09A": {
- "existencia": 7
}, - "10A": {
- "existencia": 0
}, - "11A": {
- "existencia": 10
}, - "12A": {
- "existencia": 5
}, - "13A": {
- "existencia": 183
}, - "14A": {
- "existencia": 32
}, - "15A": {
- "existencia": 0
}, - "16A": {
- "existencia": 143
}, - "17A": {
- "existencia": 13
}, - "18A": {
- "existencia": 0
}, - "19A": {
- "existencia": 8
}, - "20A": {
- "existencia": 14
}, - "21A": {
- "existencia": 39
}, - "22A": {
- "existencia": 4
}, - "23A": {
- "existencia": 2
}, - "24A": {
- "existencia": 6
}, - "25A": {
- "existencia": 7
}, - "26A": {
- "existencia": 5
}, - "27A": {
- "existencia": 28
}, - "28A": {
- "existencia": 12
}, - "29A": {
- "existencia": 0
}, - "30A": {
- "existencia": 7
}, - "31A": {
- "existencia": 47
}, - "32A": {
- "existencia": 8
}, - "33A": {
- "existencia": 21
}, - "34A": {
- "existencia": 11
}, - "35A": {
- "existencia": 378
}, - "36A": {
- "existencia": 3
}, - "37A": {
- "existencia": 30
}, - "38A": {
- "existencia": 8
}, - "39A": {
- "existencia": 3
}, - "40A": {
- "existencia": 20
}, - "41A": {
- "existencia": 12
}, - "42A": {
- "existencia": 22
}, - "43A": {
- "existencia": 71
}, - "44A": {
- "existencia": 20
}, - "45A": {
- "existencia": 6
}, - "46A": {
- "existencia": 3
}, - "47A": {
- "existencia": 0
}, - "48A": {
- "existencia": 35
}, - "49A": {
- "existencia": 0
}
}
Verificar la existencia por artículo en un almacén solo puede ser realizado con el código, un token valido y vigente.
codigo required | string Clave CT del articulo a consultar |
almacen | string Codigo de almacén a consultar |
x-auth required | string Token de autorización |
[- {
- "almacen": "01A",
- "existencia": 2774
}
]
Verificar la existencia detallada por artículo en un almacén solo puede ser realizado con el código, un token valido y vigente.
codigo required | string Clave CT del articulo a consultar |
almacen required | string Codigo de almacén a consultar |
x-auth required | string Token de autorización |
[- {
- "precio": 6.14,
- "moneda": "USD",
- "tipoCambio": 20.5,
- "existencia": 8,
- "codigoSAT": 43202005,
- "promocion": [
- {
- "precio": 5.37,
- "vigente": {
- "ini": "2019-01-19T07:00:00.000Z",
- "fin": "2019-02-19T07:00:00.000Z"
}
}
]
}
]
Verificar la existencia Total de un artículo en todos los almacenes solo puede ser realizado con el código, un token valido y vigente.
codigo required | string Clave CT del articulo a consultar |
x-auth required | string Token de autorización |
{- "existencia_total": 5696
}
Verificar el artículo que tengan existencia, promoción y precio solo puede ser realizado con un código, un token valido y vigente.
codigo required | string Clave CT del articulo a consultar |
x-auth required | string Token de autorización |
{- "codigo": "ACCBLC010",
- "precio": 6.14,
- "moneda": "USD",
- "almacenes": [
- {
- "14A": 2,
- "promocion": {
- "precio": 5.37,
- "vigente": {
- "ini": "2019-01-19T07:00:00.000Z",
- "fin": "2019-02-01T07:00:00.000Z"
}
}
}, - {
- "46A": 2
}
]
}
Servicios esenciales para la generación y seguimiento de una orden de compra, para el uso de los servicios es necesario contar un el token de autorización y que se encuentre vigente.
Servicio para la petición de solicitud de un pedido, para la solicitud de pedido es necesario consultar previamente la existencia y precios de los productos con el apoyo de los servicios de artículos. Para el uso del servicio se requiere un token valido y vigente.
x-auth required | string Token de autorización |
idPedido | integer Número de referencia por parte del cliente. |
almacen | string Código del almácen donde se va a tomar la existencia. |
tipoPago | string Número que identifica el tipo de pago (99-Crédito CT). |
cfdi | string Clave fiscal con la que se hara la facturacion (G01 por defecto). |
Array of objects (Envio) Arreglo de objetos con los datos para realizar el envió. | |
Array of objects (Producto) Arreglo de objetos con el detalle de cada producto del pedido. |
{- "idPedido": 1,
- "almacen": "01A",
- "tipoPago": "99",
- "cfdi": "G01",
- "envio": [
- {
- "nombre": "Nombre ejemplo",
- "direccion": "guerrero",
- "entreCalles": " ",
- "noExterior": "164",
- "noInterior": "string",
- "colonia": "centro",
- "estado": "Sonora",
- "ciudad": "Hermosillo",
- "codigoPostal": 83000,
- "telefono": 6622112233
}
], - "producto": [
- {
- "cantidad": 1,
- "clave": "ACCMST4010",
- "precio": 54.35,
- "moneda": "MXN"
}
]
}
{- "idPedido": 1,
- "almacen": "01A",
- "tipoPago": "99",
- "envio": [
- {
- "nombre": "Nombre ejemplo",
- "direccion": "guerrero",
- "entreCalles": " ",
- "noExterior": "164",
- "noInterior": "string",
- "colonia": "centro",
- "estado": "Sonora",
- "ciudad": "Hermosillo",
- "codigoPostal": 83000,
- "telefono": 6622112233
}
], - "producto": [
- {
- "cantidad": 1,
- "clave": "ACCMST4010",
- "precio": 54.35,
- "moneda": "MXN"
}
], - "respuestaCT": {
- "pedidoWeb": "W01-000001",
- "tipoDeCambio": 20.5,
- "estatus": "Pendiente",
- "errores": [ ]
}
}
Confirmar pedido solo puede ser realizado con el folio, un token valido y vigente. !Nota! Si el pedido no es confirmado en un lapso de 48 horas, será cancelado automáticamente por el sistema.
x-auth required | string Token de autorización |
folio | string Folio de identificacion de pedido. |
{- "folio": "W01-000001"
}
{- "okCode": "2000",
- "okMessage": "¡Ok, se procesó satisfactoriamente!",
- "okReference": "Se ha confirmado el pedido"
}
Enviar guias solo puede ser realizado con un token valido y vigente. !Nota! El envio de guias es necesario si el cliente requiere se agreguen a los pedidos solicitados.
x-auth required | string Token de autorización |
folio | string Folio de identificacion de pedido. |
Array of objects (Guia) Array de objecto con las guías que se van asociar al pedido. |
{- "folio": "W01-000001",
- "guias": [
- {
- "guia": "1012012012021021021021210210210210",
- "paqueteria": "estafeta",
- "archivo": "string"
}
]
}
{- "okCode": "2000",
- "okMessage": "¡Ok, se procesó satisfactoriamente!",
- "okReference": "Guías recibidas, el pedido se encuentra en proceso de envió"
}
Listar pedidos solo puede ser realizado con un token valido y vigente. !Nota! El cliente puede generar una lista de los pedidos realizados a CT.
x-auth required | string Token de autorización |
[- {
- "idPedido": 1,
- "almacen": "01A",
- "tipoPago": "99",
- "envio": [
- {
- "nombre": "Nombre ejemplo",
- "direccion": "guerrero",
- "entreCalles": " ",
- "noExterior": "164",
- "noInterior": "string",
- "colonia": "centro",
- "estado": "Sonora",
- "ciudad": "Hermosillo",
- "codigoPostal": 83000,
- "telefono": 6622112233
}
], - "producto": [
- {
- "cantidad": 1,
- "clave": "ACCMST4010",
- "precio": 54.35,
- "moneda": "MXN"
}
], - "respuestaCT": {
- "pedidoWeb": "W01-000001",
- "tipoDeCambio": 20.5,
- "estatus": "Pendiente",
- "errores": [ ]
}
}
]
Consultar el estatus de un pedido solo puede ser realizado con el folio, un token valido y vigente. !Nota! El cliente puede consultar el estatus de un pedido realizados a CT.
folio required | string folio de pedido CT |
x-auth required | string Token de autorización |
[- {
- "status": "Confirmado",
- "folio": "W01-000001"
}
]
Consultar el detalle de un pedido solo puede ser realizado con el folio, un token valido y vigente. !Nota! El cliente puede consultar el detalle de un pedido realizados a CT.
folio required | string folio de pedido CT |
x-auth required | string Token de autorización |
{- "idPedido": 1,
- "almacen": "01A",
- "tipoPago": "99",
- "envio": [
- {
- "nombre": "Nombre ejemplo",
- "direccion": "guerrero",
- "entreCalles": " ",
- "noExterior": "164",
- "noInterior": "string",
- "colonia": "centro",
- "estado": "Sonora",
- "ciudad": "Hermosillo",
- "codigoPostal": 83000,
- "telefono": 6622112233
}
], - "producto": [
- {
- "cantidad": 1,
- "clave": "ACCMST4010",
- "precio": 54.35,
- "moneda": "MXN"
}
], - "respuestaCT": {
- "pedidoWeb": "W01-000001",
- "tipoDeCambio": 20.5,
- "estatus": "Pendiente",
- "errores": [ ]
}
}
Servicios adicionales para la verificacion de elementos para la elaboracion de una orden de compra y para el conocimiento de los productos.
Consultar las dimensión de un producto solo puede ser realizado con el código, un token valido y vigente.
codigo required | string Clave CT del artículo |
x-auth required | string Token de autorización |
{- "peso": 5.5,
- "largo": 40,
- "alto": 28.9,
- "ancho": 18,
- "UPC": 97855070081,
- "EAN": 17825670088
}
Consultar las series asociadas a una factura, se requiere token valido y vigente.
factura required | string Folio de la factura |
x-auth required | string Token de autorización |
[- {
- "articulo": "MONSMG1140",
- "cantidad": 1,
- "series": [
- 123456789
]
}, - {
- "articulo": "MONNCB060",
- "cantidad": 2,
- "series": [
- 987654321,
- 1122334455
]
}
]