1"use strict";(globalThis.webpackChunkdocs=globalThis.webpackChunkdocs||[]).push([[5551],{28453:(e,t,n)=>{n.d(t,{R:()=>o,x:()=>s});var i=n(96540);const a={},r=i.createContext(a);function o(e){const t=i.useContext(r);return i.useMemo(function(){return"function"==typeof e?e(t):{...t,...e}},[t,e])}function s(e){let t;return t=e.disableParentContext?"function"==typeof e.components?e.components(a):e.components||a:o(e.components),i.createElement(r.Provider,{value:t},e.children)}},38046:(e,t,n)=>{n.r(t),n.d(t,{assets:()=>l,contentTitle:()=>s,default:()=>m,frontMatter:()=>o,metadata:()=>i,toc:()=>c});const i=JSON.parse('{"id":"crea-fattura-elettronica","title":"Fattura elettronica con le API Key di Fattura24","description":"Utilizzando le API di Fattura24 \xe8 possibile creare una fattura elettronica con le caratteristiche per lo SdI all\u2019interno della tua area riservata in Fattura24.","source":"@site/docs/api/crea-fattura-elettronica.md","sourceDirName":".","slug":"/crea-fattura-elettronica","permalink":"/api/crea-fattura-elettronica","draft":false,"unlisted":false,"tags":[],"version":"current","sidebarPosition":5,"frontMatter":{"title":"Fattura elettronica con le API Key di Fattura24","sidebar_label":"Creare una fattura elettronica","sidebar_position":5,"description":"Utilizzando le API di Fattura24 \xe8 possibile creare una fattura elettronica con le caratteristiche per lo SdI all\u2019interno della tua area riservata in Fattura24."},"sidebar":"tutorialSidebar","previous":{"title":"Creare un documento","permalink":"/api/crea-documento"},"next":{"title":"Scaricare un PDF","permalink":"/api/download-pdf"}}');var a=n(74848),r=n(28453);const o={title:"Fattura elettronica con le API Key di Fattura24",sidebar_label:"Creare una fattura elettronica",sidebar_position:5,description:"Utilizzando le API di Fattura24 \xe8 possibile creare una fattura elettronica con le caratteristiche per lo SdI all\u2019interno della tua area riservata in Fattura24."},s="Creare una fattura elettronica",l={},c=[];function d(e){const t={a:"a",admonition:"admonition",code:"code",em:"em",h1:"h1",header:"header",li:"li",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,r.R)(),...e.components};return(0,a.jsxs)(a.Fragment,{children:[(0,a.jsx)(t.header,{children:(0,a.jsx)(t.h1,{id:"creare-una-fattura-elettronica",children:"Creare una fattura elettronica"})}),"\n",(0,a.jsx)(t.p,{children:"La chiamata che dovrai fare per creare una fattura elettronica avr\xe0 le seguenti caratteristiche."}),"\n",(0,a.jsx)(t.pre,{children:(0,a.jsx)(t.code,{className:"language-md",metastring:'title="Chiamata"',children:'Endpoint: \r\n\r\n https://www.app.fattura24.com/api/v0.3/SaveDocument\r\n\r\nParametri da passare in Post:\r\n\r\n apiKey: API KEY associata al proprio account;\r\n xml: una stringa simile alla seguente, contenente i dati del contatto da creare.\r\n\r\nEsempio XML:\r\n\r\n <?xml version="1.0" encoding="UTF-8"?>\r\n <Fattura24>\r\n <Document>\r\n <DocumentType>FE</DocumentType>\r\n <CustomerName><![CDATA[Ferramenta Tal Dei Tali s.r.l.]]></CustomerName>\r\n <CustomerAddress><![CDATA[Via Roma n.49]]></CustomerAddress>\r\n <CustomerPostcode>00100</CustomerPostcode>\r\n <CustomerCity>Roma</CustomerCity>\r\n <CustomerProvince>RM</CustomerProvince>\r\n <CustomerCountry>IT</CustomerCountry>\r\n <CustomerFiscalCode/>\r\n <CustomerVatCode>01993350332</CustomerVatCode>\r\n <CustomerCellPhone>[email protected]</CustomerCellPhone>\r\n <CustomerEmail>[email protected]</CustomerEmail>\r\n <Object><![CDATA[Vendita alla cassa]]></Object>\r\n <FeCustomerPec>[email protected]</FeCustomerPec>\r\n <FeDestinationCode>0000000</FeDestinationCode>\r\n <FePaymentCode>MP05</FePaymentCode>\r\n <PaymentMethodName>UBI Banca</PaymentMethodName>\r\n <PaymentMethodDescription>IT87A031110321</PaymentMethodDescription>\r\n <TotalWithoutTax>220.00</TotalWithoutTax> \r\n <VatAmount>44.00</VatAmount>\r\n <Total>264.00</Total>\r\n <FootNotes/>\r\n <SendEmail>false</SendEmail>\r\n <Rows>\r\n <Row>\r\n <Description><![CDATA[Prodotto A]]></Description>\r\n <Qty>1</Qty>\r\n <Price>100.00</Price>\r\n <VatCode>22</VatCode>\r\n <VatDescription>22%</VatDescription>\r\n </Row>\r\n <Row>\r\n <Description><![CDATA[Prodotto B]]></Description>\r\n <Qty>1</Qty>\r\n <Um/>\r\n <Price>100.00</Price>\r\n <VatCode>22</VatCode>\r\n <VatDescription>22%</VatDescription>\r\n </Row>\r\n <Row>\r\n <Description><![CDATA[Spese di spedizione]]></Description>\r\n <Qty>1</Qty>\r\n <Price>20.00</Price>\r\n <VatCode>0</VatCode>\r\n <VatDescription>0%</VatDescription>\r\n <FeVatNature>N4</FeVatNature>\r\n </Row>\r\n </Rows>\r\n </Document>\r\n </Fattura24>\n'})}),"\n",(0,a.jsxs)(t.admonition,{title:"ESEMPIO",type:"info",children:[(0,a.jsxs)(t.p,{children:["In questo file potrai trovare un file XML di esempio per creare una semplice fattura elettronica: ",(0,a.jsx)(t.a,{href:"https://www.fattura24.com/assets/files/api/esempioFe.xml",children:(0,a.jsx)(t.em,{children:"Fe.xml"})}),"."]}),(0,a.jsxs)(t.p,{children:["Quando la fattura elettronica si sar\xe0 creata nel tuo account in Fattura24 (",(0,a.jsx)(t.em,{children:"sezione fatture elettroniche"}),"), il campo tipo-documento assumer\xe0 di default il valore \u201c",(0,a.jsx)(t.em,{children:"TD01"}),"\u201d (",(0,a.jsx)(t.em,{children:"fattura"}),"); potrai cambiarlo manualmente all\u2019interno della scheda-fattura tramite l\u2019apposito campo di selezione posizionato in alto a sinistra."]})]}),"\n",(0,a.jsxs)(t.admonition,{title:"Attenzione",type:"caution",children:[(0,a.jsx)(t.p,{children:"Tramite API non \xe8 possibile creare documenti con ritenuta di acconto, cassa previdenziale o contributo INPS"}),(0,a.jsx)(t.p,{children:"Per quanto concerne il bollo virtuale nelle Fatture elettroniche, questo si intende a carico del cedente/prestatore; nel documento sar\xe0 apposta solo un\u2019indicazione per la corretta trasmissione a SdI. Il nostro consiglio \xe8 di confrontarsi con il proprio commercialista."})]}),"\n",(0,a.jsx)(t.admonition,{title:"ATTENZIONE",type:"caution",children:(0,a.jsxs)(t.p,{children:["Non \xe8 possibile creare fatture elettroniche accompagnatorie, quindi eventuali ",(0,a.jsx)(t.em,{children:"tag"})," con le informazioni sul indirizzo di spedizione (",(0,a.jsx)(t.em,{children:"vedi tag Delivery descritti nella sezione \u2018Crea un documento\u2019"}),") verranno ignorate."]})}),"\n",(0,a.jsx)(t.admonition,{title:"Attenzione",type:"caution",children:(0,a.jsxs)(t.ul,{children:["\n",(0,a.jsx)(t.li,{children:"per le Fatture elettroniche l\u2019invio della email contenente la copia PDF \xe8 disabilitata;"}),"\n",(0,a.jsx)(t.li,{children:"non vogliamo rischiare che vengano inviate ai clienti copie di documenti che potrebbero essere, invece poi, scartati da SdI;"}),"\n",(0,a.jsxs)(t.li,{children:["anche se \xe8 presente e valorizzato, il tag ",(0,a.jsx)(t.code,{children:"<SendEmail>"})," verr\xe0 ignorato per i motivi sopra indicati."]}),"\n"]})}),"\n",(0,a.jsx)(t.p,{children:"Come avrai notato l\u2019XML \xe8 praticamente identico all\u2019XML utilizzato per creare un documento generico o una fattura tradizionale in formato PDF."}),"\n",(0,a.jsx)(t.p,{children:"Ci sono per\xf2 5 campi in pi\xf9 che devi tenere in considerazione perch\xe9 specifici per la fatturazione elettronica:"}),"\n",(0,a.jsxs)(t.ul,{children:["\n",(0,a.jsxs)(t.li,{children:[(0,a.jsx)(t.strong,{children:"VatType"})," andr\xe0 aggiunto se \xe8 necessario indicare l\u2019Esigibilit\xe0 IVA (",(0,a.jsx)(t.em,{children:"I: immediata, S: Split payment, D: Differita"}),");"]}),"\n",(0,a.jsxs)(t.li,{children:[(0,a.jsx)(t.strong,{children:"FeVirtualStamp"})," andr\xe0 aggiunto nel caso di applicazione del ",(0,a.jsx)(t.strong,{children:"Bollo Virtuale"})," in Fattura elettronica (",(0,a.jsx)(t.em,{children:"V: attivo"}),");"]}),"\n",(0,a.jsxs)(t.li,{children:[(0,a.jsx)(t.strong,{children:"FeCustomerPec"})," andr\xe0 valorizzato con l\u2019indirizzo PEC (",(0,a.jsx)(t.em,{children:"se disponibile"}),") del cliente al quale si sta emettendo fattura;"]}),"\n",(0,a.jsxs)(t.li,{children:[(0,a.jsx)(t.strong,{children:"FeDestinationCode"})," andr\xe0 valorizzato con il codice destinatario del cliente (",(0,a.jsx)(t.em,{children:"se disponibile"}),");"]}),"\n",(0,a.jsxs)(t.li,{children:[(0,a.jsx)(t.strong,{children:"FePaymentCode"})," andr\xe0 valorizzato con uno di questi valori:","\n",(0,a.jsxs)(t.ul,{children:["\n",(0,a.jsxs)(t.li,{children:[(0,a.jsx)(t.strong,{children:"MP01"})," per i pagamenti in contanti;"]}),"\n",(0,a.jsxs)(t.li,{children:[(0,a.jsx)(t.strong,{children:"MP05"})," per i pagamenti tramite bonifico;"]}),"\n",(0,a.jsxs)(t.li,{children:[(0,a.jsx)(t.strong,{children:"MP08"})," per i pagamenti tramite carta di credito;"]}),"\n",(0,a.jsxs)(t.li,{children:[(0,a.jsx)(t.strong,{children:"MP12"})," per i pagamenti tramite ",(0,a.jsx)(t.strong,{children:"RiBa"})]}),"\n"]}),"\n"]}),"\n"]}
1),"\n",(0,a.jsx)(t.p,{children:"Qui sotto degli esempi con tutti gli elementi relativi al metodo di pagamento:"}),"\n",(0,a.jsx)(t.pre,{children:(0,a.jsx)(t.code,{className:"language-md",children:"<FePaymentCode>MP01</FePaymentCode>\r\n<PaymentMethodName>Contanti</PaymentMethodName>\r\n<PaymentMethodDescription>Pagamento in contanti</PaymentMethodDescription>\n"})}),"\n",(0,a.jsx)(t.pre,{children:(0,a.jsx)(t.code,{className:"language-md",children:"<FePaymentCode>MP05</FePaymentCode>\r\n<PaymentMethodName>UBI Banca</PaymentMethodName>\r\n<PaymentMethodDescription>ITXXXXXXXXXXXXXXXXXX</PaymentMethodDescription>\n"})}),"\n",(0,a.jsx)(t.pre,{children:(0,a.jsx)(t.code,{className:"language-md",children:"<FePaymentCode>MP08</FePaymentCode>\r\n<PaymentMethodName>Carta di credito</PaymentMethodName>\r\n<PaymentMethodDescription>Pagamento con carta di credito</PaymentMethodDescription>\n"})}),"\n",(0,a.jsx)(t.pre,{children:(0,a.jsx)(t.code,{className:"language-md",children:"<FePaymentCode>MP12</FePaymentCode>\r\n<PaymentMethodName>Riba</PaymentMethodName>\r\n<PaymentMethodDescription>Pagamento con Riba</PaymentMethodDescription>\n"})}),"\n",(0,a.jsxs)(t.p,{children:["In ",(0,a.jsx)(t.strong,{children:"FeVatNature"})," andr\xe0 aggiunto nel tag \u201crow\u201d di dettaglio dei prodotti e/o servizi se e solo se l\u2019aliquota di riferimento \xe8 allo 0%. Il campo serve per indicare all\u2019Agenzia delle Entrate la tipologia di aliquota (",(0,a.jsx)(t.em,{children:"allo 0%"}),") e andr\xe0 valorizzato con uno di questi valori:"]}),"\n",(0,a.jsxs)(t.ul,{children:["\n",(0,a.jsxs)(t.li,{children:[(0,a.jsx)(t.strong,{children:"N1"})," escluse ",(0,a.jsx)(t.em,{children:"ex art. 15"}),";"]}),"\n",(0,a.jsxs)(t.li,{children:[(0,a.jsx)(t.strong,{children:"N2.#"})," non soggette;"]}),"\n",(0,a.jsxs)(t.li,{children:[(0,a.jsx)(t.strong,{children:"N3.#"})," non imponibili;"]}),"\n",(0,a.jsxs)(t.li,{children:[(0,a.jsx)(t.strong,{children:"N4"})," esenti;"]}),"\n",(0,a.jsxs)(t.li,{children:[(0,a.jsx)(t.strong,{children:"N5"})," regime del margine;"]}),"\n",(0,a.jsxs)(t.li,{children:[(0,a.jsx)(t.strong,{children:"N6.#"})," inversione contabile (",(0,a.jsx)(t.em,{children:"reverse charge"}),");"]}),"\n",(0,a.jsxs)(t.li,{children:[(0,a.jsx)(t.strong,{children:"N7"})," IVA assolta in altro stato UE (",(0,a.jsx)(t.em,{children:"servizi ex art. 7-octies, c. 1, lett. a, b e art. 74.sexies del d.P.R. 633/72"}),")."]}),"\n"]}),"\n",(0,a.jsxs)(t.p,{children:["Nel precedente elenco la voce ",(0,a.jsx)(t.strong,{children:"#"})," andr\xe0 sostituita con una delle sotto codifiche previste dalla Agenzia delle Entrate (",(0,a.jsx)(t.em,{children:"ad esempio: N2.3"}),")."]}),"\n",(0,a.jsxs)(t.admonition,{title:"IMPORTANTE",type:"info",children:[(0,a.jsxs)(t.p,{children:["I campi ",(0,a.jsx)(t.strong,{children:"FeCustomerPec"})," e ",(0,a.jsx)(t.strong,{children:"FeDestinationCode"})," sono da considerarsi non obbligatori se il destinatario della fattura \xe8 un consumatore finale senza P.IVA, diversamente almeno uno dei due campi dovr\xe0 essere correttamente valorizzato."]}),(0,a.jsxs)(t.p,{children:["\xc8 possibile creare ",(0,a.jsx)(t.strong,{children:"Note di credito elettroniche"}),": in linea generale valgono le stesse regole gi\xe0 viste nei paragrafi precedenti; per il resto ",(0,a.jsx)(t.strong,{children:"DocumentType"})," va valorizzato ",(0,a.jsx)(t.strong,{children:"FE"}),", e deve essere aggiunto ",(0,a.jsx)(t.strong,{children:"FeDocType"})," con valore ",(0,a.jsx)(t.strong,{children:"TD04"}),". Qui sotto riportiamo un esempio contenente solo i due elementi appena elencati:"]}),(0,a.jsx)(t.pre,{children:(0,a.jsx)(t.code,{className:"language-md",children:" <DocumentType>FE</DocumentType>\r\n <FeDocType>TD04</FeDocType>\n"})})]}),"\n",(0,a.jsxs)(t.admonition,{title:"ATTENZIONE",type:"caution",children:[(0,a.jsx)(t.p,{children:"L\u2019uso delle API consente solo la creazione automatica di una fattura elettronica dentro l\u2019account in Fattura24, ma NON consente l\u2019invio automatico all\u2019Agenzia delle Entrate."}),(0,a.jsxs)(t.p,{children:["Pertanto, sar\xe0 vostra cura entrare in Fattura24, aprire le fatture create tramite API, verificare che i dati dei vostri clienti e gli altri dati descrittivi e numerici siano corretti e quindi inviare la fattura all\u2019Agenzia delle Entrate cliccando sull\u2019apposito pulsante ",(0,a.jsx)(t.strong,{children:"Invia a Sdi"}),"."]})]})]})}function m(e={}){const{wrapper:t}={...(0,r.R)(),...e.components};return t?(0,a.jsx)(t,{...e,children:(0,a.jsx)(d,{...e})}):d(e)}}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.