Merge pull request #144 from FacturAPI/FAC-672/feature/english-transl…

…ations

Fac 672/feature/english translations

website/docs/getting-started/dates.mdx

@@ -2,32 +2,27 @@
 sidebar_position: 4
 ---
 
-# Formato de fechas
+# Date Format
 
-Aunque nuestra recomendación es enviar un string con la fecha en UTC y en formato
-ISO8601, sabemos que esto no siempre es lo más práctico.
+While our recommendation is to send a string with the date in UTC and ISO8601 format, we understand that this may not always be the most practical.
 
-Facturapi acepta fechas como string en cualquiera de las variaciones del formato
-ISO8601. Si tu fecha incluye información sobre una zona horaria, ésta se respetará;
-y en caso contrario, se interpretará usando la zona horaria de la organización
-emisora, que se deduce a partir del código postal que se haya registrado para
-la organización.
+Facturapi accepts dates as strings in any of the variations of the ISO8601 format. If your date includes information about a time zone, it will be respected; otherwise, it will be interpreted using the time zone of the issuing organization, which is deduced from the postal code registered for the organization.
 
-La siguiente tabla muestra a manera resumida cómo Facturapi interpreta las fechas
-enviadas a la API. Los ejemplos consideran que la zona horaria de la organización
-es GMT-06:00, hora del centro de México.
+The following table summarizes how Facturapi interprets dates sent to the API. The examples assume that the organization's time zone is GMT-06:00, Mexico Central Time.
 
-Input | Descripción | Normalizada con zona horaria | Normalizada UTC
+
+
+Input | Description | Normalized with time zone | Normalized UTC
 ----- | ----------- | ----------------- | ------------------------------
-`2022-01-01T00:00:00.000Z` | Fecha y hora en formato ISO8601. La Z al final indica la zona horaria UTC. | `2021-12-31T18:00:00.000-06:00` | `2022-01-01T00:00:00.000Z`
-`2022-01-01T00:00:00.000-06:00` | Fecha y hora en formato ISO8601 con la misma zona horaria de la organización. | `2022-01-01T00:00:00.000-06:00` | `2022-01-01T06:00:00.000Z`
-`2022-01-01T00:00:00.000-08:00` | Fecha y hora en formato ISO8601 con una zona horaria diferente a la de la organización. | `2022-01-01T02:00:00.000-06:00` | `2022-01-01T08:00:00.000Z`
-`2022-01-01T00:00:00.000` | Fecha y hora en formato ISO8601 sin zona horaria. | `2022-01-01T00:00:00.000-06:00` | `2022-01-01T06:00:00.000Z`
-`2022-01-01` | Fecha en formato `YYYY-MM-DD` | `2022-01-01T00:00:00.000-06:00` | `2022-01-01T06:00:00.000Z`
-
-En los objetos de respuesta, nuestra API siempre devolverá la fecha en formato
-ISO8601 con zona horaria UTC.
-
-En comprobantes, el SAT pide que las fechas se muestren en la zona horaria del emisor,
-por lo que haremos la conversión correspondiente y mostraremos la porción de la fecha
-que se requiera, pudiendo ser ésta sólo la fecha o la fecha y la hora.
+`2022-01-01T00:00:00.000Z` | Date and time in ISO8601 format. The Z at the end indicates the UTC time zone. | `2021-12-31T18:00:00.000-06:00` | `2022-01-01T00:00:00.000Z`
+`2022-01-01T00:00:00.000-06:00` | Date and time in ISO8601 format with the same time zone as the organization. | `2022-01-01T00:00:00.000-06:00` | `2022-01-01T06:00:00.000Z`
+`2022-01-01T00:00:00.000-08:00` | Date and time in ISO8601 format with a different time zone than the organization. | `2022-01-01T02:00:00.000-06:00` | `2022-01-01T08:00:00.000Z`
+`2022-01-01T00:00:00.000` | Date and time in ISO8601 format without a time zone. | `2022-01-01T00:00:00.000-06:00` | `2022-01-01T06:00:00.000Z`
+`2022-01-01` | Date in `YYYY-MM-DD` format | `2022-01-01T00:00:00.000-06:00` | `2022-01-01T06:00:00.000Z`
+
+In response objects, our API will always return the date in ISO8601 format with the UTC time zone.
+
+In invoices, the SAT (Mexican tax authority) requires that dates be displayed
+in the time zone of the issuer, so we will make the corresponding conversion
+and display the required portion of the date, which can be either just the date
+or the date and time.

website/docs/getting-started/install.mdx

@@ -77,7 +77,7 @@ using Facturapi;
 <TabItem value="php" label="PHP">
 
 ```php
-use use Facturapi\Facturapi;
+use Facturapi\Facturapi;
 ```
 
 </TabItem>

website/docs/guides/customers.mdx

@@ -260,5 +260,3 @@ curl https://www.facturapi.io/v1/customers \
 ```
 
 </details>
-
-## 

website/docs/guides/invoices/egreso.mdx

@@ -6,19 +6,20 @@ title: Egreso
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# Nota de crédito
+# Comprobante de Egreso
 
 El comprobante fiscal de tipo **Egreso**, o **Nota de crédito**, se utiliza para
 registrar fiscalmente salidas de dinero como devoluciones, descuentos y bonificaciones.
 La función principal de este tipo de comprobantes es la deductibilidad ya que se utilizan para corregir o restar montos de comprobantes de ingresos emitidos con anterioridad.
 
-La clave de este tipo de CFDI es comprobante tipo "E".
+Para emitor este tipo de comprobante deberás usar el valor "E" en la propiedad `type` al crear la factura.
 
-:::info **¿Un comprobante de Egreso debe relacionarse?**
+:::info **¿Cuándo relacionar un comprobante de Egreso?**
 Cuando el descuento aplicado se hace sobre una venta que ya fue facturada, el comprobante debe relacionarse
 con uno o varios comprobantes de Ingreso utilizando la clave de relación correspondiente y el UUID de la factura
 de Ingreso.
 
+:::info **No es una cancelación**
 Es importante mencionar que un comprobante de Egreso no sirve para cancelar un comprobante de Ingreso.
 :::
 
@@ -31,7 +32,7 @@ detalladas de cada campo y los catálogos más utilizados consulta la
 [referencia del método Crear Factura](/api/#operation/createInvoice).
 
 ### Descuento por una venta ya facturada
-En este ejemplo, se recibió un pago de $3,600.00 pesos por un producto con el 10% descuento que tiene un valor de 4,000 pesos, los $400.00 pesos descontados se amparan emitiendo un CFDI de egreso.
+En este ejemplo, se recibió un pago de $3,600.00 pesos por un producto con el 10% descuento que tiene un valor de $4,000.00 pesos, los $400.00 pesos descontados se amparan emitiendo un CFDI de egreso.
 
 <Tabs groupId="codeExamples">
 <TabItem value="js" label="Node.js" default>

website/docs/guides/invoices/retencion.mdx

@@ -5,11 +5,13 @@ title: Retenciones
 
 # Comprobante de Retenciones
 
-La factura de retenciones e información de pagos es un documento distinto a una factura estándar, es decir, no es un CFDI de ingresos, egresos o traslado.
+La factura de retenciones e información de pagos a residentes extranjeros es un documento distinto a una factura estándar, es decir, no es un CFDI de ingresos, egresos o traslado y, por lo tanto,
+tiene una estructura diferente. Se conforma por datos generales y puede agregársele un complemento.
 
-Se conforma por datos generales y puede agregársele un complemento.
+## ¿Para qué se utiliza?
 
-Para proporcionar un registro de las retenciones de impuestos o pagos realizados, debes emitir este tipo de CFDI. Por ejemplo, se utiliza en transacciones de venta de acciones, pago de dividendos, regalías por derechos de autor, remuneración a residentes extranjeros o deducciones de intereses reales por créditos hipotecarios.
+El comprobante de retenciones se utiliza para informar al SAT sobre las retenciones de impuestos que se han realizado a un tercero, así como para informar sobre pagos realizados a residentes en el extranjero.
+También se utiliza en transacciones de venta de acciones, pago de dividendos, regalías por derechos de autor, deducciones de intereses reales por créditos hipotecarios y pagos de premios de loterías, entre otros.
 
 ## Ejemplos de Retenciones
 

website/docs/guides/receipts.mdx

@@ -5,16 +5,16 @@ sidebar_position: 6
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# Recibos digitales
+# Recibos electrónicos
 
 Un **e-receipt** es la versión digital de un _ticket_ o _nota de venta_. Es un
 comprobante de pago que puedes darle a tu cliente sin solicitarle sus datos fiscales.
 Dicho comprobante incluye toda la información de la venta con el propósito de que pueda
 facturarse si el cliente lo solicita y también para incluirse dentro de una factura
 global.
 
-Al crear un **recibo digital** en Facturapi, tus clientes tendrán acceso a un sitio web a
-donde podrán llenar sus datos fiscales y descargar su facuta (autofactura).
+Al crear un **e-receipt** en Facturapi, tus clientes tendrán acceso a un sitio web a
+donde podrán llenar sus datos fiscales y descargar su facuta (portal de autofactura).
 
 También puedes crear una factura global al final del mes que incluya todos aquellos
 recibos que no fueron facturados.
@@ -111,13 +111,19 @@ curl https://www.facturapi.io/v2/receipts \
 </TabItem>
 </Tabs>
 
-## Autofactura
+## Portal de Autofactura
+
+Cuando creas un e-receipt, tienes la opción de enviarlo por correo electrónico a tu cliente.
+En el correo se incluye un enlace a un portal de autofactura donde tu cliente podrá
+llenar sus datos fiscales y descargar su factura.
 
 Para más información consulta el artículo de [Autofactura](/docs/guides/self-invoice).
 
 ## Facturar un recibo
 
-Convierte tu recibo en factura si tu cliente te lo solicita. Más detalles en el método [Facturar Recibo](/api/#operation/invoiceReceipt).
+Por medio del método [Facturar Recibo](/api/#operation/invoiceReceipt) puedes convertir
+un e-receipt en una factura. Para ello, debes enviar los datos del cliente y otros datos que
+no se solicitan al crear el recibo.
 
 <Tabs groupId="codeExamples">
 <TabItem value="js" label="Node.js" default>

website/docs/intro.md

@@ -4,7 +4,7 @@ sidebar_position: 1
 
 # Introducción
 
-El servicio web de Facturapi te permite interactuar con comprobantes fiscales digitales (CFDI) de una manera simple, fácil de entender y menos costosa de mantener.
+El servicio web de Facturapi te permite interactuar con comprobantes fiscales digitales (CFDI) de una manera segura, simple y de bajo mantenimiento.
 
 Aspiramos a ser una alternativa moderna frente a los PCCFDI (Proveedor de certificación de Comprobante Fiscal Digital por Internet, antes PAC) tradicionales, que requieren de una gran cantidad de tiempo y experiencia para implementarse.
 
@@ -32,18 +32,18 @@ Lo único que necesitas para empezar a usar Facturapi es una cuenta de usuario y
 
 ## Características soportadas por Facturapi
 
-- **E-receipts**. Emite [recibos digitales facturables](/docs/guides/receipts/) por cada venta que realices.
+- **E-receipts**. Emite [recibos digitales facturables](/docs/guides/receipts/) por cada venta que realices. Sin necesidad de información del cliente. Puedes convertirlos en facturas más adelante si es necesario.
+  - **Autofactura** Permite a tus clientes completar sus datos de facturación por si mismos.
   - **Factura global**. Emite una sola factura por todos los e-receipts que no se facturaron durante un periodo.
-  - **Autofactura** Proporciona un portal para que tus clientes completen los datos de su factura por si mismos.
 - **Factura electrónica**.
   - **CFDI versión 4.0** (vigente desde Enero de 2022).
   - ~~**CFDI versión 3.3**~~ (descontinuada en Marzo de 2023).
   - Todos los tipos de comprobantes (CFDI):
-    - **Ingreso** (Factura)
-    - **Egreso** (Nota de crédito)
-    - **Pago** (Complemento de pago)
-    - **Nómina** (Recibo de nómina)
-    - **Traslado** (Traslado de mercancía)
+    - **Ingreso**. Facturas de venta.
+    - **Egreso**. Notas de crédito.
+    - **Pago** (Complemento de pago). Recibos de pagos realizados a facturas no pagadas.
+    - **Nómina**. Recibo de nómina.
+    - **Traslado**. Traslado de mercancía.
   - Inserta cualquier **complemento** y/o **addenda**.
     - Acreditamiento de IEPS
     - Instituciones Educativas
@@ -76,6 +76,7 @@ Lo único que necesitas para empezar a usar Facturapi es una cuenta de usuario y
     - Nómina
     - Pagos
     - Carta Porte
-- **Comprobante de Retención**. (Incluyendo el complemento de Plataformas Tecnológicas).
-- **Cancelaciones**.
+- **Comprobante de Retención** e información de pagos a residentes en el extranjero.
+- **Cancelaciones**. Cancela facturas y recibe notificaciones de cancelación.
 - **Multi RFC**. Registra múltiples organizaciones bajo una misma cuenta y emite facturas usando distintos RFC.
+- **Borradores de facturas**. Guarda facturas con datos preliminares o incompletos para enviarlas para revisión antes de timbrarlas y enviarlas al SAT.