Modifica campo merged_in durante trasformazione di un ordine in una fattura ricevuta

[cherednychenkoyehor]

Ciao a tutti sto cercando di creare uno script che trasforma documenti di tipo ordine in una fattura o ricevuta. Ho notato che facendolo manualmente viene messo una nota sul file di tipo ordine sotto la voce doc. di riferimento rendendo visibile il documento in cui è stato trasformato, è questo è rappresentato dal campo merged_in.
Non riesco però creare un api che lo vada a modificare.

Le funzioni in cui sto cercando di eseguire l aggiornamento del campo merged_in sono le seguenti:
` def create_document_from_order(self, order_details, doc_type):
"""
Crea un nuovo documento (fattura o ricevuta) da un ordine,
gestendo data di pagamento e IVA estero.
"""
try:
new_doc = order_details.copy()

        # 1. Impostazioni base
        new_doc['type'] = doc_type
        order_id = order_details.get('id')
        order_number = order_details.get('number')
        
        # Rimuovi ID e numero (verranno generati automaticamente)
        new_doc.pop('id', None)
        new_doc.pop('number', None)
        new_doc.pop('merged_in', None)
        new_doc.pop('original_document', None)
        
        # NON impostare ref_doc_* nel nuovo documento
        new_doc.pop('ref_doc_id', None)
        new_doc.pop('ref_doc_type', None)
        new_doc.pop('ref_doc_number', None)
        new_doc.pop('ref_doc_type_label', None)
        
        new_doc['date'] = datetime.now().strftime('%Y-%m-%d')
        
        # ⚠️ IMPORTANTE: Imposta fattura elettronica per le fatture (non per ricevute)
        if doc_type == 'invoice':
            new_doc['e_invoice'] = True
            
            # ⚠️ OBBLIGATORIO per fatture elettroniche: metodo di pagamento SDI
            # Mappa i metodi di pagamento comuni al codice SDI
            payment_method_name = order_details.get('payment_method', {}).get('name', '').lower()
            
            # MP01 = contanti, MP05 = bonifico, MP08 = carta/digitale
            if 'paypal' in payment_method_name or 'card' in payment_method_name or 'klarna' in payment_method_name or 'shopify' in payment_method_name:
                ei_payment_method = 'MP08'  # Pagamento digitale/carte
            elif 'bonifico' in payment_method_name or 'bank' in payment_method_name:
                ei_payment_method = 'MP05'  # Bonifico
            elif 'contant' in payment_method_name or 'cash' in payment_method_name:
                ei_payment_method = 'MP01'  # Contanti
            else:
                ei_payment_method = 'MP08'  # Default: pagamento digitale
            
            new_doc['ei_data'] = {
                'payment_method': ei_payment_method
            }
            
            logging.info(f"   📧 Fattura elettronica abilitata (metodo pagamento SDI: {ei_payment_method})")
        else:
            new_doc['e_invoice'] = False
        
        # 2. Gestione data pagamento (da Shopify)
        order_payment_date = None
        order_payments = order_details.get('payments_list', [])
        
        if order_payments and len(order_payments) > 0:
            first_payment = order_payments[0]
            # Cerca la data nel campo corretto
            order_payment_date = first_payment.get('paid_date') or first_payment.get('due_date')
            
            if first_payment.get('status') == 'paid' and order_payment_date:
                logging.info(f"   💰 Trovata data di pagamento: {order_payment_date}")
                
                new_doc['payments_list'] = [{
                    "amount": order_details.get('amount_gross', 0),
                    "due_date": order_payment_date,
                    "paid_date": order_payment_date,
                    "status": "paid",
                    "payment_account": first_payment.get('payment_account')
                }]
                new_doc['payments_status'] = 'paid'
        
        # 3. Rimuovi ID dagli items (verranno rigenerati)
        items_list = new_doc.get('items_list', [])
        for item in items_list:
            item.pop('id', None)
            item.pop('product_id', None)
        
        # 4. Gestione IVA Estero
        if self.is_foreign_order(order_details):
            new_doc['items_list'] = self.remove_vat_from_items(items_list)
        
        # 5. Note
        existing_notes = new_doc.get('notes', '')
        transformation_note = f"Trasformato da ordine #{order_number} (ID: {order_id})"
        new_doc['notes'] = f"{existing_notes}\n{transformation_note}".strip()
        
        # 6. Rimuovi ID dai pagamenti (verranno rigenerati)
        payments_list = new_doc.get('payments_list', [])
        for payment in payments_list:
            payment.pop('id', None)
            payment.pop('forfettari_revenue', None)
        
        # 7. Rimuovi TUTTI i campi non necessari/calcolati
        fields_to_remove = [
            'permissions', 'created_at', 'updated_at', 'next_due_date', 'seen_date',
            'url', 'locked', 'has_ts_pay_pending_payment', 'is_first_e_invoice', 'show_tspay_button',
            'amount_rivalsa', 'amount_rivalsa_taxable', 'amount_global_cassa_taxable',
            'amount_cassa', 'amount_cassa_taxable', 'amount_cassa2', 'amount_cassa2_taxable',
            'amount_withholding_tax', 'amount_withholding_tax_taxable',
            'amount_other_withholding_tax', 'amount_enasarco_taxable', 'amount_other_withholding_tax_taxable',
            'amount_net', 'amount_vat', 'amount_gross', 'amount_due_discount'
        ]
        
        for field in fields_to_remove:
            new_doc.pop(field, None)

        # 8. Creazione documento
        url = f"{self.base_url}/c/{self.company_id}/issued_documents"
        payload = {'data': new_doc}

        logging.info(f"   📤 Invio richiesta creazione documento...")
        response = requests.post(url, headers=self.headers, json=payload)
        
        # Se errore, mostra la risposta completa
        if response.status_code != 200:
            logging.error(f"   ❌ Errore {response.status_code}")
            try:
                error_detail = response.json()
                logging.error(f"   Dettagli errore: {json.dumps(error_detail, indent=2)}")
            except:
                logging.error(f"   Response text: {response.text}")
        
        response.raise_for_status()
        
        result = response.json()
        new_document = result.get('data', {})
        
        doc_type_name = 'fattura' if doc_type == 'invoice' else 'ricevuta'
        new_doc_number = new_document.get('number', '')
        new_doc_id = new_document.get('id')
        new_doc_date = new_document.get('date', '')
        new_doc_numeration = new_document.get('numeration', '')
        
        logging.info(f"   ✅ {doc_type_name.capitalize()} #{new_doc_number} creata (ID: {new_doc_id})")
        
        # 9. ⚠️ IMPORTANTE: Aggiorna l'ordine con merged_in
        logging.info(f"   🔄 Aggiornamento ordine originale...")
        time.sleep(0.5)
        
        success = self.update_order_merged_in(
            order_id, 
            new_doc_id, 
            doc_type, 
            new_doc_number,
            new_doc_date,
            new_doc_numeration,
            doc_type_name
        )
        
        if not success:
            logging.warning(f"   ⚠️ Attenzione: documento creato ma aggiornamento ordine fallito")
        
        return new_document
        
    except requests.RequestException as e:
        logging.error(f"❌ Errore nella creazione documento: {e}")
        if hasattr(e, 'response') and e.response:
            try:
                error_data = e.response.json()
                logging.error(f"Response: {json.dumps(error_data, indent=2)}")
            except json.JSONDecodeError:
                logging.error(f"Response: {e.response.text}")
        return None
    except Exception as e:
        logging.error(f"❌ Errore imprevisto: {e}")
        import traceback
        logging.error(traceback.format_exc())
        return None

def update_order_merged_in(self, order_id, doc_id, doc_type, doc_number, doc_date, doc_numeration, doc_type_name):
    """
    Aggiorna l'ordine con il campo merged_in che punta al documento creato.
    Questo è necessario per marcare l'ordine come "trasformato".
    """
    try:
        url = f"{self.base_url}/c/{self.company_id}/issued_documents/{order_id}"
        
        # Costruisci il payload con SOLO il campo merged_in
        payload = {
            'data': {
                'merged_in': {
                    'id': doc_id,
                    'date': doc_date,
                    'number': doc_number,
                    'numeration': doc_numeration,
                    'type': doc_type,
                    'link_type': 'transform',
                    'description': f'Trasformato in {doc_type_name} #{doc_number}'
                }
            }
        }
        
        logging.info(f"   🔗 Invio aggiornamento ordine {order_id} con merged_in...")
        
        response = requests.put(url, headers=self.headers, json=payload)
        
        # Log della risposta per debug
        logging.info(f"   📊 Status code: {response.status_code}")
        
        if response.status_code != 200:
            logging.error(f"   ❌ Errore HTTP: {response.status_code}")
            try:
                error_data = response.json()
                logging.error(f"   Response error: {json.dumps(error_data, indent=2)}")
            except:
                logging.error(f"   Response text: {response.text}")
            return False
        
        response.raise_for_status()
        
        # Verifica che l'aggiornamento sia andato a buon fine ricontrollando l'ordine
        time.sleep(0.3)  # Piccola pausa per dare tempo al server
        
        verification_response = requests.get(url, headers=self.headers)
        if verification_response.status_code == 200:
            updated_order = verification_response.json().get('data', {})
            merged_in_check = updated_order.get('merged_in')
            
            if merged_in_check and merged_in_check.get('id') == doc_id:
                logging.info(f"   ✅ Ordine aggiornato e verificato: {doc_type_name} #{doc_number}")
                return True
            else:
                logging.warning(f"   ⚠️ Status 200 ricevuto ma merged_in non presente nell'ordine")
                logging.info(f"   📋 Merged_in trovato: {merged_in_check}")
                return False
        else:
            logging.warning(f"   ⚠️ Impossibile verificare l'aggiornamento (status: {verification_response.status_code})")
            return False
            
    except requests.RequestException as e:
        logging.error(f"❌ Errore nell'aggiornamento merged_in per ordine {order_id}: {e}")
        if hasattr(e, 'response') and e.response:
            try:
                error_data = e.response.json()
                logging.error(f"Response dettagliata: {json.dumps(error_data, indent=2)}")
            except json.JSONDecodeError:
                logging.error(f"Response: {e.response.text}")
        return False
    except Exception as e:
        logging.error(f"❌ Errore imprevisto nell'aggiornamento: {e}")
        import traceback
        logging.error(traceback.format_exc())
        return False`

Quella che dovrebbe eseguire l'aggiornamento al campo è update_order_merged_in

Premessa sono un neofita nel campo. Spero che potete gentilmente aiutarmi
Grazie, Yehor

[GabirRen]

Buongiorno @cherednychenkoyehor,

la modifica del campo merged_id non è prevista, il suo valore viene impostato automaticamente e non può essere modificato.
Se la sua esigenza è quella di inserire delle informazioni aggiuntive può utilizzare il campo 'notes'.

Resto a disposizione,
Gabriele

[cherednychenkoyehor]

Buongiorno @GabirRen,

In tal caso che funzione devo usare per poter trasformare il documento da ordine a fattura/ricevuta tramite api?

Grazie;
Yehor

[valmoz]

Buongiorno @cherednychenkoyehor
ha già provato a seguire la guida dedicata? Join & Transform issued documents

Grazie
Mauro