ShopSite

Especificación de API de pedidos

Interfaz

Desde el punto de vista de la aplicación CGI, se ejecuta como cualquier otra CGI llamada con el método POST. Su entrada es una serie de pares nombre valor (nombre=valor) separada por '&', y el conjunto está codificado como URL.

La CGI debe encontrar los pares, determinar el nombre y el valor de cada uno, y descodificar el nombre y el valor. Entonces la CGI podrá hacer todo lo que hacen las CGI. Todo lo escrito para salida estándar irá al servidor, etc.

La entrada está en cinco partes.

La primera parte es la entrada original a thankyou.cgi. Nombres y descripciones de los valores.

prevlocation
La ubicación (y cadena del método de QUERY) en la que la orden introdujo el sistema de CGI del carrito de la compra.
sbid
ID del carrito de la compra. Un identificador exclusivo del carrito de la compra para las llamadas a la CGI.
storeid
El identificador de tienda de la tienda en la que se está comprando. Es la misma id que la del archivo auth. Las id de tienda son exclusivas en cada host.

Los 11 elementos siguientes son los que el cliente ha introducido en el formulario "Su carrito de la compra".

PayType
PayType es el método de pago elegido por el cliente en el formulario Carrito de la compra. Es un dígito que corresponde al orden de tipos de pago de la pantalla Pago de -> Configuración del comercio -> de ShopSite. Por ejemplo, PayType 0 es Discover, PayType 4 es American Express.
  • pay1
  • pay2
  • pay3
  • pay4
Se diferencian entre sí según el PayType. Para Visa, pay1 es el número de tarjeta, pay2 es el nombre que figura en la tarjeta, pay3 es la Empresa, y pay4 es la fecha de caducidad. Para PayType Contra reembolso, todos estos valores serán '--'.
función
Una guía de dónde ir en thankyou.cgi. Usual value is OK.

El siguiente bloque de pares representa al archivo de configuración de la tienda. Todos los nombres van precedidos por una 'S-'. Muchos de ellos pueden verse en la pantalla del Servicio de host.

S-bo_dir
URL de las CGI de ShopSite.
S-bo_reg_url
URL de las CGI de ShopSite.
S-bo_secure_url
URL segura de las CGI de ShopSite.
S-bo_use_security
¿Usar seguridad en ShopSite?
S-ccprocessor
Tipo de procesador de tarjeta de crédito.
S-customcgi
Ubicación de la CGI personalizada.
S-datadir
Directorio Data (de datos).
S-from_addr
Dirección "De" en los recibos enviados por correo electrónico.
S-outputdir
Directorio Output (de salida).
S-outputurl
URL de la tienda.
S-perl_loc
Ubicación del ejecutable PERL.
S-sb_dir
Directorio del Carrito de la compra.
S-sb_prompt_comments
¿Solicitar comentarios?
S-sb_prompt_orderinst
¿Solicitar instrucciones de pedido?
S-sb_reg_url
URL de las CGI del carrito de la compra.
S-sb_secure_url
URL segura del carrito de la compra.
S-sb_use_security
¿Usar seguridad en el carrito de la compra?
S-sendmail_loc
Ubicación del ejecutable de Enviar correo.

El siguiente bloque de pares nombre valor procede de una tabla interna de thankyou.cgi. Todos van precedidos por una 'F-'.

Elementos del formulario Caja.

De nuevo, los datos del PayType (tipo de pago):

Información diversa:

El siguiente bloque de pares nombre valor poroceden del registro de este pedido en la base de datos de pedidos. Cada nombre va precedido por una 'O-' y el nombre es el nombre del campo de la base de datos.

O-Fecha
Fecha del pedido.
O-OrderNum
Número de pedido.

Elementos de diversos formularios.

Elementos de información para el envío. Si la información de envío es la misma que la información de facturación, estos campos tendrán el valor '--'.

PayType (tipo de pago):

Más elementos del formulario:

Por último, algunos elementos que no pertenecen al formulario.

O-NumItems
Número de artículos de este pedido.
O-RefName
Nombre del asociado, si el cliente llegó a la tienda remitido por un asociado.
O-OrderData
Algunos datos diversos en notación binaria. Normalmente, un par de bytes aleatorios (BSDI, Linux) o nada (Solaris).
O-Viewed
Indica si el comerciante ha visto el pedido desde ShopSite. 'n' o 's'.

Por último, información sobre cada uno de los productos del pedido procedente de la base de datos de la cesta. Todos los nombres empiezan por una 'B' y un prefijo de uno o más dígitos, que varía según los productos. Los productos están numerados a partir de '01'. Así, para el primer producto (artículo) de la cesta, el prefijo será 'B01-'.

Para entender mejor los nombres y las funciones se puede mirar en back office en el formulario Productos -> Agregar producto.

Volver a página principal de Ayuda | Buscar | Comentario
Si no encuentra la ayuda que necesita, indíquenoslo con todo detalle.