E-Fatura

Not: .NET ile e-fatura imzalanacağı vakit, XML yapısında olan faturanın düzgün bir şekilde okunup işlenmesi gerekiyor. Okuma kod örneği için tr.gov.tubitak.uekae.esya.api.xades.example.utils.SampleBase sınıfının newEnvelope(String) metodunu inceleyiniz.

E-fatura kendine has formatı olan bir XML dökümanıdır. E-faturaların imzalanması ise İmza Yapıları altında açıklanan zarflanmış imzaya çok benzemektedir. Yalnız farklı olarak imza, fatura içinde e-fatura standartı için belirlenmiş özel bir alana konulmalıdır.

//get the element that signature will be added
Element extContent = (Element)faturaDoc.getDocumentElement().getElementsByTagName("ext:ExtensionContent").item(0);

// generate signature Context context = createContext();
context.setDocument(faturaDoc);
XMLSignature signature = new XMLSignature(context, false);

//attach signature to envelope structure
extContent.appendChild(signature.getElement());

Ardından bütün dökümanın dahil edildiği yalnız imza alanının hariç bırakıldığı transform metodu eklenir.

// use enveloped signature transform
Transforms transforms = new Transforms(context);
transforms.addTransform(new Transform(context, TransformType.ENVELOPED.getUrl()));

//add whole document(="") with envelope transform, with SHA256
//and don't include it into signature(false)
signature.addDocument("", "text/xml", transforms, DigestMethod.SHA_256, false);

Daha sonra ise yine e-fatura standartlarında gerekli kılınan imzacı rolü, açık anahtar ve imza zamanı eklenir.

//add signer role information
SignerRole rol = new SignerRole(context, new ClaimedRole[]{new ClaimedRole(context, "Supplier")});
signature.getQualifyingProperties().getSignedSignatureProperties().setSignerRole(rol);

//e-fatura standard wants public key info in the signature
PublicKey pk = KeyUtil.decodePublicKey(new ECertificate(cert.getEncoded()).getSubjectPublicKeyInfo());
signature.getKeyInfo().add(new KeyValue(context, pk));

// add signing time
signature.getQualifyingProperties().getSignedSignatureProperties().setSigningTime(getTime());

.NET kütüphanesinde ise açık anahtar eklemede ufak bir fark var.

// e-fatura standards want public key info to be in the signature
signature.KeyInfo.add(new KeyValue(context, cert.asX509Certificate2().PublicKey.Key));

Yine e-fatura kuralı olarak, imzanın id'si, yani signature-id bölümü faturada belirtilen id'ye çevrilir.

//e-fatura standards want signatureID to be same with cbc:URI
// get signatureID from e-fatura
String signatureID = ((Element)(faturaDoc.getDocumentElement().getElementsByTagName("cbc:URI").item(0)) ).getTextContent();
String signatureIDwoNumberSign = signatureID.substring(1);

//change original signatureID
Element dsSignature = (Element)(faturaDoc.getDocumentElement().getElementsByTagName("ds:Signature").item(0));
dsSignature.setAttribute("Id", signatureIDwoNumberSign);

Kodu tr.gov.tubitak.uekae.esya.api.xades.example.efatura.EFatura altında inceleyebilirsiniz.