docs: add batch certificate creation section to README.md

- Introduced documentation for the new endpoint `POST /v1/certificate/create-batch` to create multiple certificates from a list of data.
- Included details on required and optional fields, as well as example request and response formats.

Author: maxsonferovante

README.md

@@ -46,6 +46,91 @@ Cria um novo certificado para um determinado produto.
   }
   ```
 
+### Criar Certificados em Lote
+
+Cria múltiplos certificados a partir de uma lista de dados recebida diretamente.
+
+- **Endpoint:** `POST /v1/certificate/create-batch`
+- **Entrada (body):**
+  ```json
+  {
+    "certificates": [
+      {
+        "order_id": 1234,
+        "first_name": "João",
+        "last_name": "Silva",
+        "email": "[email protected]",
+        "phone": "(48) 99999-9999",
+        "cpf": "123.456.789-00",
+        "city": "Florianópolis",
+        "product_id": 5678,
+        "product_name": "Workshop de Python Avançado",
+        "certificate_details": "In recognition of their participation in the Workshop de Python Avançado, held on January 15, 2025, at IFSC – Câmpus Florianópolis, Brazil, with a total duration of 8 hours.",
+        "certificate_logo": "https://example.com/logo.png",
+        "certificate_background": "https://example.com/background.png",
+        "order_date": "2025-01-10 14:30:00",
+        "checkin_latitude": "-27.5667",
+        "checkin_longitude": "-48.5156",
+        "time_checkin": "2025-01-15 09:00:00"
+      },
+      {
+        "order_id": 1235,
+        "first_name": "Maria",
+        "last_name": "Santos",
+        "email": "[email protected]",
+        "phone": "(48) 88888-8888",
+        "cpf": "987.654.321-00",
+        "city": "São José",
+        "product_id": 5678,
+        "product_name": "Workshop de Python Avançado",
+        "certificate_details": "In recognition of their participation in the Workshop de Python Avançado, held on January 15, 2025, at IFSC – Câmpus Florianópolis, Brazil, with a total duration of 8 hours.",
+        "certificate_logo": "https://example.com/logo.png",
+        "certificate_background": "https://example.com/background.png",
+        "order_date": "2025-01-10 14:35:00",
+        "checkin_latitude": "-27.5667",
+        "checkin_longitude": "-48.5156",
+        "time_checkin": "2025-01-15 09:05:00"
+      }
+    ]
+  }
+  ```
+- **Campos obrigatórios:**
+  - `order_id`: ID único do pedido (integer)
+  - `first_name`: Primeiro nome do participante (string)
+  - `last_name`: Sobrenome do participante (string)
+  - `email`: Email do participante (string)
+  - `phone`: Telefone do participante (string)
+  - `cpf`: CPF do participante (string, pode ser vazio)
+  - `city`: Cidade do participante (string)
+  - `product_id`: ID do produto (integer)
+  - `product_name`: Nome do produto (string)
+  - `certificate_details`: Detalhes do certificado (string)
+  - `certificate_logo`: URL do logo do certificado (string)
+  - `certificate_background`: URL do background do certificado (string)
+  - `order_date`: Data do pedido no formato "YYYY-MM-DD HH:MM:SS" (string)
+- **Campos opcionais:**
+  - `checkin_latitude`: Latitude do check-in (string, opcional)
+  - `checkin_longitude`: Longitude do check-in (string, opcional)
+  - `time_checkin`: Data e hora do check-in no formato "YYYY-MM-DD HH:MM:SS" (string, opcional)
+    - **Nota:** Certificados sem `time_checkin` serão marcados como inválidos e não serão processados.
+- **Saída (sucesso):**
+  ```json
+  {
+    "certificate_quantity": 2,
+    "existing_orders": [],
+    "new_orders": [1234, 1235],
+    "processing_date": "2025-01-20 10:30:45.123456"
+  }
+  ```
+- **Saída (erro):**
+  ```json
+  {
+    "status": 500,
+    "message": "Internal Server Error",
+    "details": "string"
+  }
+  ```
+
 ### Consultar Certificado
 
 Consulta certificados com base em diferentes critérios.