¿Cómo podemos ayudarle?
Gracias. Hemos recibido su envío.
¡Ups! Algo salió mal al enviar el formulario.
La plataforma de impresión bajo demanda de Peecho ofrece soluciones flexibles para imprimir productos de alta calidad. Puede realizar un pedido de dos formas: a través de su aplicación o plataforma mediante la API de impresión de Peecho, o a través de la caja alojada de Peecho.
El proceso comienza cuando el cliente realiza una compra en su aplicación o plataforma. Usted cobra el pago mediante su propio sistema de pago. Al integrar la API de impresión de Peecho en tu flujo de pedidos, automatizas la creación del pedido, el pago y el envío a producción.
La API también le permite solicitar presupuestos, actualizar los detalles de los pedidos, realizar un seguimiento de los estados y mucho más.
Para utilizar el sistema de pago alojado de Peecho, empiece por crear una lista de productos en su panel de control. Esto genera un enlace de pago, que puede compartir con los clientes directamente o incrustar en su sitio web como un botón "Comprar impresión".
Para realizar un pedido utilizando nuestra API v3, siga estos pasos:
Recorreremos cada uno de estos pasos utilizando como ejemplo un libro de tapa dura.
En primer lugar, cree una cuenta en el entorno de prueba para obtener sus credenciales de API. Encontrará su clave de API en el panel de control de prueba, en Configuración > API.
Tenga en cuenta que los productIds y apiKeys del entorno de producción no funcionan en el entorno de pruebas, y viceversa.
Antes de hacer un pedido, debe introducir la dirección de su empresa. Esto es importante porque el impuesto que se aplica a cada pedido se basa en parte en la ubicación de su empresa.
Para realizar pruebas, puede utilizar datos simulados. Para añadir sus datos, vaya a Dashboard > Settings > API > Company details.
Para este ejemplo, utilizaremos uno de nuestros productos más populares: un libro A4 apaisado de tapa dura (21 x 29,7 cm).
Cada cuenta tiene un conjunto único de ID de producto. Para encontrar el suyo, vaya a Panel de control > Configuración > Productos > Libros > ID de producto.
Si desea probar la API con un producto diferente, puede buscarlo y seleccionarlo en la misma página. Solo tienes que asegurarte de que tienes un archivo que cumple las especificaciones del producto.
Cada producto requiere una configuración de archivo específica. La mayoría de los productos recomiendan una resolución de 300 ppp y deben enviarse en el perfil de color RGB. Para obtener información detallada sobre los archivos, visite el Centro de ayuda de Peecho.
Para este ejemplo, utilizaremos el álbum horizontal A4, que mide 21 x 29,7 cm. Este producto requiere un mínimo de 24 páginas, por lo que tu archivo debe tener al menos esa longitud.
La API de Peecho acepta dos configuraciones de archivo para los libros:
Cree un único PDF que contenga la portada, las páginas de contenido y la contraportada, dispuestas como páginas sueltas en ese orden. La primera página se imprimirá como portada y la última como contraportada. Por defecto, el lomo se deja en blanco.
Si desea incluir una columna vertebral, hay dos opciones:
En esta configuración, usted proporciona dos archivos:
Este enfoque es ideal para diseños de cubiertas envolventes. Si utiliza esta configuración, tendrá que calcular manualmente la anchura del lomo utilizando el punto final Obtener anchura del lomo.
Si no tiene un archivo con el que hacer pruebas, puede utilizar el archivo de muestra de Peecho, que incluye portada y contenido. Si desea probar un lomo personalizado con el archivo de muestra, puede utilizar el archivo PDF de lomo personalizado.
Ahora que ha seleccionado un producto y preparado su archivo, puede crear el pedido enviando una solicitud POST a:
https://test.www.peecho.com/rest/v3/orders/
La creación de un pedido requiere una única llamada a la API, incluyendo todos los detalles relevantes. Asegúrese de utilizar la MerchantKey y el productId de su cuenta de prueba; las credenciales de producción no funcionarán en el entorno de prueba.
Puede crear un pedido de dos maneras:
Especifique la URL del archivo en el objeto file_details.
Deje los parámetros file_details en blanco durante la creación del pedido. Proporcionará los archivos más tarde utilizando el punto final Set files asynchronously .
Una vez creado el pedido, aparecerá en su panel de control en estado Abierto. Necesitará el orderId para realizar un pago y enviar el pedido a producción como parte del flujo de pedidos.
Para este ejemplo, crearemos un pedido con dos artículos: uno con un lomo dinámico y otro con una URL de lomo personalizada. Los datos deben seguir el formato del objeto Pedido:
{
"merchant_api_key": "YourAPIKeyHere:ABCD1234XXXX",
"purchase_order": "",
"currency": "EUR",
"item_details":
[
{
"item_reference": "hardcover_22",
"offering_id": "YourOfferingIDHere",
"quantity": 3,
"file_details":
{
"content_url": "https://peecho-thumbnailer.s3.eu-west-1.amazonaws.com/Peecho+HCB+print+file.pdf",
"content_width": 210,
"content_height": 29.7,
"number_of_pages": 80,
"spine_details":
{
"dynamic_spine_details":
{
"text_font": "Arial",
"text_size": 10,
"text_colour": "#77493f",
"text_top": "top text",
"text_center": "center text",
"text_bottom": "bottom text"
}
}
}
},
{
"item_reference": "hardcover_23",
"offering_id": 233309,
"quantity": 2,
"file_details":
{
"content_url": "https://peecho-thumbnailer.s3.eu-west-1.amazonaws.com/Peecho+HCB+print+file.pdf",
"content_width": 210,
"content_height": 29.7,
"number_of_pages": 80,
"spine_details":
{
"custom_spine_url": "https://peecho-thumbnailer.s3.eu-west-1.amazonaws.com/Custom%20spine%20PDF.pdf"
}
}
}
],
"address_details":
{
"email_address": "joshua@designy.com",
"shipping_address":
{
"first_name": "Joshua",
"last_name": "Grim",
"address_line_1": "Test",
"address_line_2": 1,
"zip_code": "35100",
"city": "Florida",
"state": null,
"country_code": "ARE"
}
}
}
Para pagar un pedido de la API de impresión, envíe una solicitud al punto final Pago. Antes de poder hacerlo, tendrá que comprar créditos en el entorno de prueba. Estos créditos se utilizan para pagar los pedidos que cree.
Para comprar créditos, vaya a Panel de control > Configuración > API > Crédito > Comprar crédito. En el entorno de prueba, puede utilizar métodos de pago simulados, como tarjetas de prueba de Stripe.
Una vez adquiridos los créditos, llame al punto final Pago para confirmar que el pedido está finalizado y listo para la producción. Esto simula un escenario en el que su cliente ya le ha pagado directamente.
Para enviar el pago, necesitará lo siguiente:
La API de Peecho también incluye puntos finales para presupuestos de pedidos, información sobre productos y estado de los pedidos.
Para más información, consulte nuestra documentación sobre la API. Si necesita ayuda para probar o implantar la API v3, estaremos encantados de ayudarle. Póngase en contacto con nosotros en support@peecho.com.
